Kavramlar

Maskeleme nasıl çalışır, yer tutucu formatı, fail-closed davranış ve veri egemenliği.

Siper, dil modeline giden her isteği önce maskeleme adımından geçirir. 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 <KATEGORI_N> biçiminde bir yer tutucuyla değiştirilir: metindeki ilk kişi adı <PERSON_1> olur, ikincisi <PERSON_2>. Model yalnız maskeli metni 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.

Yer tutucu formatı ve dil ayrımı

API’den dönen maskeli metinde yer tutucular İngilizcedir: <PERSON_1>, <PHONE_MOBILE_1>, <TCKN_1>. Aynı kategorideki her yeni değer numarayı bir artırır. Yönetim paneli ise aynı yer tutucuları Türkçe etiketlerle gösterir; bu yalnız gösterim katmanıdır, API sözleşmesi değişmez.

Entegrasyon kodu yazarken her zaman İngilizce biçimi esas alın; Türkçe etiketler yalnız panelde görünü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. Dış dil modeline yalnız maskeli metin gider; ham kişisel veri yurt dışına çıkmaz.

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