Tanık Dokümantasyon

Politika

#Politika nasıl çalışır

Politika, Tanık'ın bir isteğe ne yapacağını belirleyen ayarların tamamıdır. Kurum geneli tek bir politika vardır; gerektiğinde tek bir uygulamanın anahtarına farklı ayar verilebilir.

#Varsayılan paket

Hiçbir şey ayarlanmamış bir kurulum, gömülü KVKK Baseline paketini kullanır. Varsayılanlar bilinçli olarak temkinlidir:

SeçenekVarsayılanNeden
Tespit modufastGecikme eklemez; deep Türkçe trafik için önerilir ama tercih sizindir
Kişisel veri bulununcamaskİstek kullanışlı kalır; model cevaplayabileceği bir soru alır
Prompt injectionflagKalıp tabanlı bir tespit üzerinden isteği reddetmek yanlış pozitifleri görünmez kılar
Tamponlu çıktıkapalıAkışlı cevaplar varsayılan olarak olduğu gibi geçer
Limitler, bütçeler, izin listeleriyokDoğru sayı kurulumun özelliğidir; kimsenin seçmediği bir tavan, yoğun bir saatte başarısız isteklerle keşfedilir

Paketin sürümü (kvkk-baseline@9 gibi) her kayda policy_version olarak yazılır. Bir varsayılan değiştiğinde sürüm numarası artar; böylece denetçi, "o gün hangi kurallar geçerliydi" sorusunu kayıttan cevaplar.

#İstek nasıl değerlendirilir

Her istek aynı sırayla aynı adımlardan geçer ve her adım kayda bir karar yazar; atlanan adım bile "atlandı" ve nedeni ile birlikte yazılır.

  1. Kimlik — anahtar doğrulanır, kurum belirlenir.
  2. Model izni — model izin listesinde mi.
  3. Bütçe ve limit — aylık token bütçesi ve dakikalık istek limiti.
  4. Araç izni — isteğin sunduğu araçlar izinli mi.
  5. Tarama — yapısal kişisel veri; derin modda Türkçe isim, kurum ve yer.
  6. Kişisel veri kararı — maskele, reddet ya da beklet.
  7. Prompt injection — kalıp eşleşmesi; işaretle, reddet ya da beklet.
  8. Yönlendirme — hedef seçilir.
  9. Bölge kuralı — kişisel veri taşıyan istek yalnız izinli bölgeye gider.
  10. Çıktı taraması — tek parça cevaplarda ve tamponlu modda.

Reddeden ilk adım isteği durdurur; sonraki adımlar çalışmaz. Reddedilen istek sağlayıcıya hiç gitmez ve kayıtta hedef alanı boştur: bu, verinin gitmediğinin olumlu beyanıdır.

#Anahtar başına üstyazım

Bir uygulamaya farklı ayar gerekiyorsa (toplu bir iş hızlı modda ve yüksek limitle koşsun, sohbet uygulaması derin modda kalsın) üstyazım anahtara tanımlanır:

create-api-key --key <key_id> --set-policy '{"detection_mode":"fast","rate_limit_per_minute":600}'
create-api-key --key <key_id> --set-policy none   # kurum politikasına dön

Yalnız adı geçen ayarlar değişir, gerisi kurum politikasından gelir. Üstyazımla geçen isteklerin kaydında policy_version sonuna +key eklenir; aynı paketi anan iki kaydın aynı kurallarla karara bağlandığı iddiası böyle korunur.

#Nereden ayarlanır

Konsolun Politika ekranından ya da set-policy komutuyla. Ekran bütün ayarları birlikte kaydeder; tek bir alanı gönderip diğerlerini sıfırlamak mümkün değildir.