Nasıl çalışır

Mimari

AvertGate hibrit bir mimari kullanır: denetim müşterinin kendi ağında çalışır, yönetim düzlemi ise bulutta.

İki düzlem

	Data plane	Control plane
Nerede	Müşterinin makinesi / ağı (on-premise, stdio)	Barındırılan web uygulaması ve veritabanı
Ne çalıştırır	MCP proxy, reverse proxy, SDK; tarayıcılar; politika motoru	Panel, politika yönetimi, ajan kayıtları, olay görüntüleme
Ne görür	Araç çağrıları, sonuçlar, dosya içerikleri, SQL sorguları	Yalnızca maskelenmiş denetim olayları

Ne dışarı çıkar?

Araç çağrıları, sonuçlar, dosya içerikleri ve sorgular müşteri ağı içinde işlenir. Control plane'e yalnızca maskelenmiş denetim olayları gönderilir: hangi araç, maskelenmiş argümanlar, karar ve kural. Bu, gecikmeyi düşürür ve veri yerleşimi (KVKK/GDPR gibi) gereksinimlerini karşılamayı kolaylaştırabilir; uyum yükümlülüğü yine sizdedir. İki istisna vardır. Birincisi Slack onayıdır: onay mesajına çağrının argümanları maskelenmeden yazılır. İkincisi AI Guard'dır: onu bir bulut sağlayıcısına yönlendirirseniz (varsayılan sağlayıcı ayarı TypeSafe'in bulut uç noktasıdır) denetlenen içerik o sağlayıcıya gider. Yerel model (Ollama veya vLLM) içeriği ağınızda tutar. AI Guard, siz açmadıkça kapalıdır.

Veri akışı tablosu

Veri	Nerede işlenir	Yönetim paneline gider mi?	Üçüncü tarafa gidebilir mi?
Araç çağrısı argümanları, sonuçlar, dosya içerikleri, SQL sorguları	Müşteri ağı (ağ geçidi)	Hayır	Yalnızca AI Guard bulut sağlayıcıyla açıksa (aşağıya bakın)
Denetim olayı (araç, karar, kural, neden)	Ağ geçidi, yerel denetim kaydı	Evet; argümanlar maskelenmiş	Hayır
AI Guard: denetlenen içerik	Varsayılan kapalı. Yerel modelle (Ollama/vLLM) ağınızda; bulut sağlayıcıyla sağlayıcıda	Hayır	Evet, bulut sağlayıcı seçilirse içerik o sağlayıcıya gider
Slack onay mesajı	Ağ geçidinden Slack'e	Hayır	Evet; argümanlar maskelenmeden Slack'e yazılır
Politika	Panelde yönetilir, ağ geçidi açılışta çeker	Panelden ağ geçidine	Hayır

Slack onayında argümanlar maskelenmezOnay mesajı çağrının argümanlarını olduğu gibi gösterir; böylece onaylayan ne onayladığını görür. Argümanlarında kişisel veri ya da sır olabilecek araçları (örneğin send_email) onaya bağlıyorsanız, Slack kanalının erişimini buna göre sınırlayın.

Politika ve olay akışı

Başlangıçta ağ geçidi, ajan anahtarıyla GET /api/gateway/resolve çağırarak ajanın politikasını alır.
Çalışma sırasında olaylar POST /api/events/ingest ile toplu (en çok 100) gönderilir.
Panelde politika değiştiğinde ağ geçidi yeni sürümü alır.

Bulut bağlantısı olmadan da tam yerel çalışılabilir: POLICY_PATH ile yerel dosya, yerel SQLite denetim kaydı.

Dağıtım biçimleri

Bağımsız çalıştırılabilir dosya: derlendiği işletim sistemi için üretilir (Windows'ta avertgate.exe, macOS ve Linux'ta avertgate). İşletim sistemi ve işlemci mimarisi başına ayrı derleme gerekir; hazır paketler için satış ekibine ulaşın.
Kurumsal Docker imajı avertgate/gateway.
npx @avertgate/cli ile hızlı POC.

Hava boşluklu ortam

AI Guard için bulut yerine yerel Ollama veya vLLM kullanabilirsiniz; böylece tüm yol ağınızın içinde kalır.