Tespit motorunu inceleyin ve işçilerini ayarlayın
Kişisel veri modelinin yüklü olduğunu doğrulayın, örnek metinle yoklayın ve her ML tespit servisinin kaç işçi çalıştıracağını değiştirin.
- Sürüm: 0.4
- Rol: admin_user
- Tür: görev
ML Motoru, kişisel veri tespit modelinin yüklü olup olmadığını bildirir ve bir metni bu modelden geçirerek tam olarak ne döndürdüğünü görmenizi sağlar. ML servislerinin işçi sayıları ikinci bir ekranda, Ayarlar → ML Tuning üzerinden değiştirilir.
Neye ihtiyacım var?
- Lisans
- Any
- Rol
admin_user
Ön koşullar
- Cihaz CID_ENABLE_LAB=true ile çalışıyor. Lisanslı bir yapıda ML Motoru sayfası bulunmaz.
- ml-detector servisi çalışıyor ve ağ geçidinden erişilebilir durumda.
- İşçi ayarı için: superadmin sizsiniz ve yeniden başlatmayı uygulayacak ana makine güncelleyici arka plan süreci çalışıyor.
Danger
ML Motoru, yalnızca laboratuvara özgü Test grubunda yer alır ve lisanslı her yapıda gizlidir. Ayarlar → ML Tuning laboratuvarla kısıtlı değildir ama yalnızca superadmin içindir ve oradaki kaydetme işlemi ML servislerini yeniden başlatır.
/assets/screenshots/ml-engine@0.4.pngModelin yüklü olduğunu denetleyin
Sayfayı açın
Test → ML Motoru seçin.
Detection engine (tespit motoru) kartı etkin motoru, yüklü modelleri ve polled every 30s notunu gösterir.
Durumu okuyun
Models altındaki modelin yüklü olarak bildirildiğini doğrulayın.
Ağ geçidi bunu tespit servisinin kendi sağlık uç noktasından türetir. Servis yanıt vermediğinde kartın yerini Engine status unavailable — the detection service is not responding. alır.
Yeniden başlatmadan sonra yeniden yoklayın
Refresh status seçin.
Kart, bir sonraki yoklamayı beklemek yerine sağlık uç noktasını hemen yeniden okur.
Warning
Kişisel veri hattı tek bir motor çalıştırır: ince ayarlı ONNX NER modeli. Bu karttaki Shadow mode, Startup engine ve Comparisons run birer ölçüm değil, ağ geçidinin doldurduğu sabitlerdir: gölge kip her zaman kapalıdır ve karşılaştırma sayısı her zaman sıfırdır. Motor değiştirme yüzeyi, ikinci motor hattan çıktığında kaldırıldı; kart ve aşağıdaki panel "compare" sözcüğünü korumaya devam ediyor.
Tespit ediciyi kendi metninizle yoklayın
Metni yapıştırın
Compare engines panelinde metni Input text alanına girin.
Alan 1 ile 50000 karakter arası kabul eder.
Dili ve eşiği ayarlayın
Language alanını Auto detect, English, Turkish ya da German yapın ve
Confidence threshold değerini 0 ile 1 arasında ayarlayın.
Bu paneldeki varsayılan eşik 0.5'tir.
Çalıştırın
Compare engines seçin.
Sonuçlar aşağıda görünür: güven değeriyle birlikte tespit edilen dil, modelin döndürdüğü varlıklar, varlık sayısı ve işlem süresi.
Note
Bu panel tespit servisini doğrudan çağırır. Filtre kurallarınızı, kiracı ve grup geçersiz kılmalarını ya da doğrulama aşamasını uygulamaz — bu yüzden burada listelenen bir varlık, gerçek bir mesajın maskeleneceğinin kanıtı değildir. Bunun için Filtre Testi sayfasını kullanın.
Bir servisin kaç işçi çalıştıracağını değiştirin
Ayar ekranını açın
Ayarlar → ML Tuning seçin.
ML Worker Tuning ayarlanabilir her servis için bir alan listeler. superadmin olmayan bir kullanıcı Access Denied ve Only the superadmin can tune ML worker settings. görür.
İşçi sayılarını ayarlayın
Değiştirmek istediğiniz servisler için 1 ile 8 arasında bir değer verin.
Her alan kendi compose servis adını ve default {n} · range 1–8 notunu gösterir. Her işçi,
modelin kendi kopyasını tutan ayrı bir süreçtir; dolayısıyla bir işçi doğrusal olarak daha çok
RAM ve CPU harcar.
Uygulayın
Save & apply seçin.
Yalnızca değeri değişen servisler yeniden başlatılır; geri kalanına dokunulmaz ve hiçbir imaj yeniden oluşturulmaz. Servis yeniden başlamayı bitirdiğinde yeni sayı yürürlüğe girer.
Ağ geçidi Docker'a hiç dokunmaz. Kaydetmek, değeri yapılandırma deposuna yazar ve ana makine
güncelleyici arka plan sürecinin kuyruğuna bir reconfigure-ml niyeti bırakır; süreç yeni değeri
canlı ortam dosyasına işler ve etkilenen servisleri yeniden oluşturur. Arka plan süreci
çalışmayan sıradan bir geliştirme makinesinde niyet kuyrukta bekler ve hiçbir şey yeniden
başlamaz — servisleri elle yeniden oluşturun.
Ayarlanabilir servisler
| Servis | Compose servisi | Varsayılan işçi |
|---|---|---|
| Toxicity (HAP Guard) | hap-guard-v2 | 2 |
| Prompt injection / jailbreak | attack-guard | 2 |
| PII NER | ml-detector | 2 |
Yalnızca gerçek sinir ağı modeli çalıştıran servisler ayarlanabilir; çünkü her işçi ağır bir modeli çoğaltır. Dil tespit edicisi ve istem sıkıştırıcısı böyle bir model tutmaz, bu yüzden işçi sayıları compose dosyasında sabittir.
Tespit eşikleri gerçekte nerede durur
Warning
HAP_THRESHOLD, JAILBREAK_THRESHOLD ya da PII_CONFIDENCE_THRESHOLD diye bir ortam değişkeni yoktur — ağ geçidinde bunları okuyan hiçbir şey bulunmaz. Bunların adını veren belgeler ve compose açıklamaları yanlıştır; birini ayarlamak hiçbir şeyi değiştirmez.
| Eşik | Nerede durur | Nasıl değiştirilir |
|---|---|---|
| Zararlı içerik, etiket bazında | Zararlı içerik servisinin imajına gömülü thresholds.json | Dosyayı düzenleyip o imajı yeniden oluşturun |
| Prompt enjeksiyonu ve jailbreak | Saldırı servisinin imajına gömülü thresholds.json | Dosyayı düzenleyip o imajı yeniden oluşturun |
| ML kişisel veri güveni | Ağ geçidinin tespit istemcisinin her çağrıda gönderdiği sabit 0.6 | Çalışma zamanında yapılandırılamaz |
| Doğrulama geçme notu | Tespit hattındaki sabit 0.6 | Çalışma zamanında yapılandırılamaz |
Her eşik dosyası bir etikete üç düzey verir — engelleme düzeyi, işaretleme düzeyi ve yalnızca günlükleme düzeyi — bu yüzden zararlı içerik servisi tek bir genel sayı yerine kategori başına bir tane olmak üzere on üç bağımsız üçlü taşır. Yukarıdaki Compare engines panelindeki güven eşiği yalnızca o yoklamaya uygulanır ve gerçek trafik için hiçbir şeyi değiştirmez.
Etiket bazındaki değerler ve her tespit edicinin ürettiği varlık türleri, üretilmiş varlık türü başvurusundadır; hattın bir tespitle ne yaptığına ise bu dosyalar değil, Güvenlik Filtreleri sayfasındaki kurallar karar verir.
Doğrulama
- Detection engine modeli yüklü olarak bildirir ve Refresh status bunu kullanılamaz durumuna çevirmez.
- Bariz bir varlık içeren bir yoklama — örnek metindeki bir e-posta adresi — en az bir varlık ve bir işlem süresi döndürür.
- Save & apply sonrasında etkilenen servis yeniden sağlıklı bildirilir ve yeni işçi sayısı yürürlüktedir. Yanıt, kuyruğa alınan yeniden başlatmanın istek kimliğini taşır ve arka plan sürecinin o kimlik için durumu, yeniden oluşturmanın başarılı olup olmadığını söyler.
Note
Her iki ekran da olay günlüğüne satır yazmaz. Bir işçi değişikliği yapılandırma deposuna ve ağ geçidinin kendi günlüğüne — kimin yaptığını da vererek — kaydedilir ama bunun için bir olay türü yoktur; dolayısıyla Olay Günlükleri'nde görünmez.
Başarısız olursa
- Sayfa yok ya da her istek 404 dönüyor — yapı bir laboratuvar yapısı değil.
CID_ENABLE_LABtruedeğil. - Engine status unavailable — the detection service is not responding. — ağ geçidi tespit servisine erişemiyor. Tespit sonuçlarından bir anlam çıkarmadan önce kapsayıcının sağlığını denetleyin.
- 503 ile Failed to get engine status — aynı durumun kart yerine API tarafından bildirilmesi.
- 400 ile Failed to compare engines — yoklama reddedildi. İleti tespit servisinin kendi metnini taşır; en yaygın neden boş ya da aşırı uzun bir girdidir.
- Access Denied … Only the superadmin can tune ML worker settings. — ayar ekranı yalnızca superadmin içindir ve arka uç yalnızca ekranı değil kaydetmeyi de reddeder.
- Save & apply başarılı oluyor ama hiçbir şey yeniden başlamıyor — kuyruktaki niyeti tüketecek bir ana makine güncelleyici arka plan süreci çalışmıyor. Geliştirme makinesinde servisleri elle yeniden oluşturun.
- İşçi sayıları artırıldıktan sonra servisler başlamıyor — her işçi modelin kendi kopyasını tutar. Sayıları ana makinenin belleğine sığacak şekilde düşürün.
Sonraki adımlar
- Filtre Testi — tek bir tespit ediciyi değil, hattın tamamını uçtan uca ölçün.
- Güvenlik Filtreleri — tespit edicinin bulduğuna ne olacağına karar verin.
- Tüm Tespitler — tespit edicinin gerçek trafikteki çıktısını görün.
Son güncelleme