Skip to main content
CID222 Docs

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.

Modelin 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

ServisCompose servisiVarsayılan işçi
Toxicity (HAP Guard)hap-guard-v22
Prompt injection / jailbreakattack-guard2
PII NERml-detector2

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şikNerede dururNasıl değiştirilir
Zararlı içerik, etiket bazındaZararlı içerik servisinin imajına gömülü thresholds.jsonDosyayı düzenleyip o imajı yeniden oluşturun
Prompt enjeksiyonu ve jailbreakSaldırı servisinin imajına gömülü thresholds.jsonDosyayı düzenleyip o imajı yeniden oluşturun
ML kişisel veri güveniAğ 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 notuTespit 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

  1. Detection engine modeli yüklü olarak bildirir ve Refresh status bunu kullanılamaz durumuna çevirmez.
  2. 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.
  3. 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_LAB true değ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

Bu sayfada