Başlangıç
#Tanık nedir
Tanık, kurumunuzun yapay zekâ sağlayıcılarına (OpenAI, Anthropic, Azure OpenAI ve diğerleri) giden bütün trafiğin geçtiği bir ağ geçididir. Uygulamalarınız sağlayıcıya değil Tanık'a bağlanır; Tanık isteği inceler, gerekirse değiştirir ya da reddeder, sağlayıcıya iletir ve verdiği her kararı değiştirilemez bir kayda yazar.
İki işi vardır:
- Korur. Kişisel veriyi modele gitmeden maskeler, prompt injection kalıplarını yakalar, kişisel verinin yalnız izinli bölgelere gitmesini sağlar, model ve araç izin listelerini, istek limitlerini ve token bütçelerini uygular.
- Kanıtlar. Her istek için bir denetim kaydı yazar. Kayıtlar birbirine özet zinciriyle bağlıdır, her gün imzalanır ve dönem sonunda KVKK maddelerine göre düzenlenmiş bir kanıt paketine dönüşür.
Ürünün ilkesi şudur: her kontrol bir kanıt üretir. Kanıt üretmeyen bir kontrol ya da kontrolü olmayan bir kanıt, tasarım hatasıdır.
#Nasıl çalışır
Uygulamanız ──▶ Tanık ──▶ Sağlayıcı (OpenAI, Anthropic, Azure…)
│
├─ kimlik → kurallar → tarama ve maskeleme → yönlendirme
│
└─ denetim kaydı (değiştirilemez)
Uygulamanızda yalnız iki şey değişir: sağlayıcının adresi yerine Tanık'ın adresi, sağlayıcının anahtarı yerine Tanık'ın verdiği anahtar. İstek gövdesi, model adı ve akışlı cevap davranışı aynı kalır. Tanık sağlayıcıyı taklit etmez; isteği iletir ve kaydeder. Bir hata olduğunda cevabı sağlayıcının kendi hata biçiminde verir, böylece mevcut hata yönetiminiz çalışmaya devam eder.
#Bileşenler
Kurulum paketi beş servisten oluşur ve tek bir docker compose dosyasıyla ayağa kalkar:
| Servis | Görevi |
|---|---|
| gateway | Uygulamaların bağlandığı ağ geçidi ve yönetim API'si |
| admin | Yönetim konsolu (tarayıcıda) |
| worker | Arka plan işleri: günlük imzalı checkpoint, aylık çapa, uyarılar, saklama süresi |
| mongo | Denetim kaydı ve yapılandırma |
| redis | Zincir ucu ve sayaçlar (istek limiti, token bütçesi) |
#Ne değildir
- Uyum garantisi değildir. Tanık, yükümlülüklerinizin trafikten kanıtlanabilir kısmını otomatikleştirir. KVKK ya da EU AI Act kapsamındaki yükümlülüklerin değerlendirilmesi hukuk danışmanınıza aittir.
- İçerik arşivi değildir. İstek ve yanıt içeriği saklanmaz. Kayıtta yalnız hangi kontrolün ne karar verdiği ve bulunan kişisel verinin türü ile sayısı bulunur.
- Her şeyi yakalayan bir filtre değildir. Türkçe isim tespiti bir dil modeline dayanır ve bazı isimleri kaçırabilir; prompt injection tespiti kalıp tabanlıdır. Bu sınırlar kanıt raporunun çekincelerinde her dönemde yeniden yazılır.
#Sonraki adım
Kurulum sayfasından başlayın. Bir sunucu ve yaklaşık yarım saat yeter.