Kavramlar

Siper kavramları: maskeleme adımında ne olur, yer tutucu formatı nasıl okunur, fail-closed davranış ne yapar ve veriniz hangi sınırlar içinde işlenir.

Maskelemesi açık bir sanal anahtardan dil modeline giden her istek önce maskeleme adımından geçer. Bu sayfa o adımda ne olduğunu anlatır: yer tutucuların biçimi, maskeleme yapılamadığında Gateway’in davranışı ve verinizin nerede işlendiği.

Maskeleme nasıl çalışır?

Gateway’e gelen metin, modele iletilmeden önce taranır. Tespit edilen her kişisel veri <KATEGORİ_N> biçiminde bir yer tutucuyla değiştirilir: metindeki ilk kişi adı <KİŞİ_1> olur, ikincisi <KİŞİ_2>. Model bu alanların yerinde yer tutucuları görür; yanıt dönerken yer tutucular korunur.

Ad, TCKN, telefon ve adres dahil 26 kategori tespit edilir. Tam liste ve sentetik örnekler için Kategoriler.

Bu doğruluğun arkasında veri var: KVKK’nın özel nitelikli kategorilerini (sağlık, din, siyasi görüş, sendika üyeliği ve ceza mahkûmiyeti dahil) kapsayan, Türkçeye özgü büyük bir eğitim veri setini kendimiz oluşturduk ve modeli bu setle aylar süren bir çalışmayla eğittik. Yeni sürümleri aynı test protokolüyle yeniden ölçer, karşılaştırmalı sonuçları benchmark sayfasında paylaşırız. Temmuz 2026 ölçümünde yakalama oranı %84,6’dır; hiçbir otomatik tespit sistemi her kişisel veri alanını bulmayı garanti etmez.

Yer tutucu formatı ve dil ayrımı

Doğrudan /mask ve /mask/batch yanıtlarında yer tutucular ham kategori adlarıyla döner: <PERSON_1>, <PHONE_MOBILE_1>, <TCKN_1>. OpenAI uyumlu Gateway ve yönetim paneli aynı kategorileri Türkçe etiketlerle gösterir. Aynı kategorideki her yeni değer numarayı bir artırır.

Entegrasyon kodunda kullandığınız yüzeyin sözleşmesini esas alın: doğrudan maskeleme uçları ham kategori adlarını, Gateway ise Türkçe etiketleri döndürür.

Maskeleme yapılamazsa ne olur?

İstek durur. Maskeleme hizmeti bir isteği işleyemezse Gateway o isteği dış modele iletmez ve 502 durum koduyla yanıtlar; “maskesiz de olsa gönder” diye bir seçenek yoktur. 502 aldığınızda isteği daha sonra yeniden deneyin. Bu davranışın adı fail-closed.

Veri egemenliği

Maskeleme, model çağrısından önce, Türkiye’de barındırılan altyapıda çalışır. Maskelemesi açık akışta tespit edilen kişisel veriler Türkiye’de yer tutucuya dönüştürülür; dış dil modeline bu değerlerin maskeli biçimi gider.

Saklama, denetim izi ve erişim konuları için Güvenlik.