Tüm yazılar
YAPAY ZEKA MİMARİSİAğustos 2026·18 dk okuma

AI Gateway: Yapay Zeka Sistemleri İçin Trafik, Güvenlik ve Yönetişim Katmanı

Üretim seviyesinde LLM ve Ajan (MCP) sistemlerinde model sanallaştırma, token bütçeleme, streaming yönetişimi ve kurumsal güvenlik katmanı.

Yapay zeka uygulamalarının ilk aşamasında mimari genellikle oldukça basittir. Uygulama bir modele doğrudan bağlanır, ortam değişkeninden API anahtarını okur ve modelden cevabı alır.

prototip-mimari.txt
text
Application


   LLM API

Bir prototip veya PoC için bu yaklaşım yeterlidir. Ancak sistem büyüdükçe aynı uygulamanın birden fazla model, farklı sağlayıcılar, farklı ekipler ve onlarca farklı kullanım senaryosuyla çalışması gerekir. Bir noktadan sonra problem artık yalnızca “Hangi modeli kullanıyoruz?” sorusu olmaktan çıkar.

Üretim (Production) AI Sistemlerinde Asıl Sorular

  • 1Hangi istek hangi modele, hangi gecikme ve maliyet kriteriyle yönlendirilmeli?
  • 2Bir model sağlayıcısı 429 (Rate Limit) veya 5xx kesintisi verdiğinde sistem nasıl ayakta kalacak?
  • 3İstek sayısı değil, faturayı katlayan token tüketimi ve kullanıcı kotaları nasıl sınırlandırılacak?
  • 4API anahtarları (credentials) istemcilerin ve mikroservislerin içinden nasıl tamamen soyutlanacak?
  • 5Hassas kurumsal veriler (PII) ve prompt injection saldırıları modele ulaşmadan nasıl taranacak?
  • 6Otonom AI ajanlarının bağlandığı Model Context Protocol (MCP) araçları nasıl merkezi olarak denetlenecek?

Bu soruların tamamının bulut-yerel (cloud-native) mimaride ortak bir karşılığı vardır:

AI Gateway'i yalnızca basit bir proxy olarak görmek eksik bir yaklaşımdır. Production AI sistemlerinde gateway; trafik yönetimi, model sanallaştırma, güvenlik, token bütçeleme, dayanıklılık, streaming yönetişimi ve gözlemlenebilirlik için merkezi bir kontrol düzlemine (control point) dönüşür.

Kozmoz Mimari Çalışma Grubu
Şekil 1 — Doğrudan Model Bağlantısı ve Merkezi AI Gatewaycanlı
Web App
Bearer token
Mobile App
Tenant ID
AI Agent
Role token
KOZMOZ AI GATEWAY (Kontrol & Trafik Katmanı)
🛡️ Güvenlik & PII🔀 Model Routing📊 Token Limitleme⚡ Semantic Cache
OpenAI
o3 / 4o
Claude
3.7 Sonnet
Gemini
2.5 Flash
Self-Hosted
vLLM / GPU
AI Gateway katmanı: Uygulamalar tek sözleşmeyle (kozmoz-reasoning) bağlanır; yönlendirme, güvenlik ve maliyet merkezi kontrol edilir.

1. AI Gateway Nedir?#

En yalın tanımıyla AI Gateway, kurumsal uygulamalar ile yapay zeka modelleri arasındaki tüm trafik için merkezi bir geçit ve politika katmanıdır.

Bu yapı sayesinde uygulamalar belirli bir model sağlayıcısına (OpenAI, Anthropic, Google Gemini veya yerel vLLM) doğrudan bağımlı olmak yerine, gateway üzerinden soyut bir sözleşmeyle AI altyapısına erişir.

Örneğin bir uygulamanın standart bir sohbet tamamlama isteği gönderdiğini düşünelim:

request.http
http
POST /v1/chat/completions
Authorization: Bearer <application-token>
Content-Type: application/json

{
  "model": "kozmoz-reasoning",
  "messages": [{ "role": "user", "content": "Mimari analiz yap" }]
}

Uygulama açısından model kozmoz-reasoning olarak tanımlıdır. Gateway ise bu sanal modelin arkasında hangi gerçek modelin çalışacağına gerçek zamanlı metriklerle karar verir. Bu yaklaşım Model Virtualization (Model Sanallaştırma) olarak adlandırılır.

Şekil 2 — Model Sanallaştırma (Model Virtualization) Matrisi
Sanal Model İstemi
POST /v1/chat/completions → kozmoz-reasoning
1
Claude 3.7 Sonnet (Thinking)
Birincil Sağlayıcı
1.2s TTFT$$$
2
OpenAI o3-mini
Yedek Fallback
1.4s TTFT$$
3
DeepSeek R1 (Self-Hosted vLLM)
On-Prem / Veri Güvenliği
0.8s TTFT$
Uygulama kodu sağlayıcı adını bilmez; soyut takma adı (alias) çağırır. Gateway arka planda maliyet, gecikme ve gizlilik politikasına göre gerçek modeli seçer.

2. API Gateway ile AI Gateway Arasındaki Fark#

AI Gateway, klasik API Gateway mimarisinin doğal bir uzantısı gibi görünse de çalışma dinamikleri ve kaynak yönetimi açısından köklü farklılıklar barındırır.

Klasik bir API Gateway (Kong, Envoy, Nginx); kimlik doğrulama, rate limiting, yük dengeleme ve TLS sonlandırma işlemlerini sabit HTTP request/second (örneğin 100 req/dakika) mantığıyla yönetir. Ancak AI sistemlerinde istek sayısı kaynak tüketimini temsil etmez:

Şekil 3 — Klasik İstek Sayımı ve Token-Aware Rate Limiting

Klasik API Gateway

Limit: 100 requests / dakika
Metrik: HTTP Status (200, 429)
Bant Genişliği: Sabit bayt boyutu
API'ye 100 kere istek atan kullanıcı limiti aşar; ancak harcadığı işlem gücü ve maliyet çok düşüktür.

Token-Aware AI Gateway

Kullanıcı A
100 İstek
50.000 Token
Maliyet: ~$0.15
Kullanıcı B (Risk)
10 İstek
2.000.000 Token
Maliyet: ~$30.00
Gateway; Input, Output, Reasoning Token ve bütçe ($ quota) bazlı anlık denetim uygular.
Yalnızca istek (request) saymak AI sistemlerinde maliyet ve kaynak krizini çözemez. 10 istek atan bir kullanıcı, 100 istek atan kullanıcıdan 40 kat fazla token ve bütçe tüketebilir.

3. Neden AI Gateway'e İhtiyaç Duyulur?#

Bir sistem küçükken tek bir modele doğrudan bağlanmak makuldür. Fakat zaman içerisinde sistem onlarca servise, farklı bulut sağlayıcılarına ve yerel GPU kümelerine yayılır:

bad-coupling-antipattern.cs
csharp
// KÖTÜ PRATİK: Uygulama koduna sızmış sağlayıcı bağımlılığı (Tight Coupling)
if (provider == "openai") {
    var client = new OpenAIClient(apiKey);
} else if (provider == "anthropic") {
    var client = new AnthropicClient(anthropicKey);
} else if (provider == "gemini") {
    // Sağlayıcı SDK değişince tüm mikroservisleri baştan derlemek gerekir
}

AI Gateway bu bağımlılığı uygulama kodundan tamamen koparır. Uygulama yalnızca tek bir standart OpenAI uyumlu veya gRPC sözleşmesini bilir; sağlayıcı seçimi altyapının sorumluluğuna geçer.

4. AI Gateway'in Temel Mimarisi (Control Plane & Data Plane)#

Production seviyesinde bir AI Gateway'i iki temel düzlem üzerinden tasarlamak, özellikle Kubernetes ve bulut-yerel ortamlarda ölçeklenebilirlik için zorunludur:

Şekil 4 — Cloud-Native Control Plane ve Data Plane Mimarisi
CONTROL PLANE (Yönetim & Politika Katmanı)
Kubernetes CRD / Admin API
Rota Kuralları
Model Havuzları
Tenant Kotaları
PII Filtreleri
xDS / Dinamik Politika Senkronizasyonu
DATA PLANE (Yüksek Performanslı Trafik Katmanı)
Envoy / Rust Proxy Engine
Auth & Token Rate
Akış İptali (SSE)
Circuit Breaker
OTel Telemetri
Envoy AI Gateway ve Kubernetes ekosisteminde yapılandırma (Control Plane) ile gerçek zamanlı AI trafiği (Data Plane) birbirinden tamamen ayrılır.

Haziran 2026'da 1.0 sürümüne ulaşan Envoy AI Gateway mimarisinde olduğu gibi; Control Plane rota politikalarını ve kotaları yönetirken, Rust veya C++ tabanlı yüksek performanslı Data Plane gerçek zamanlı AI trafiğini mikro-saniye seviyesinde yönlendirir.

5. Uçtan Uca İstek Yaşam Döngüsü (Request Lifecycle)#

Bir AI isteği gateway'e ulaştığında arkada pasif bir proxy gibi davranılmaz; istek hakkında onlarca güvenlik, politika ve kaynak kararı verilir:

Şekil 5 — AI Gateway İstek Yaşam Döngüsü (Request Lifecycle)
1
1. Client Request
Uygulama/Agent sanal modele Bearer token ile istek başlatır.
Gateway isteği yalnızca ileten pasif bir tünel değildir; her adımda karar veren, güvenliği sağlayan ve kaynak tüketen bir kontrol noktasıdır.

6. Akıllı Model Yönlendirme (Intelligent Model Routing)#

Her isteği en pahalı veya en büyük akıl yürütme (reasoning) modeline göndermek sürdürülemez bir maliyet ve gecikme yaratır. Gateway gelen promptun niteliğine göre dinamik karar verir:

  • 01Basit Sınıflandırma ve Özetleme: Hızlı ve düşük maliyetli modellere (ör. Gemini 2.5 Flash, GPT-4o-mini).
  • 02Derin Mantık ve Kod Üretimi: Gelişmiş akıl yürütme modellerine (ör. Claude 3.7 Sonnet Thinking, OpenAI o3-mini).
  • 03Hassas Veri / On-Prem Gereksinimi: Kurum içi GPU sunucularında koşan self-hosted modellere (ör. vLLM üzerinde DeepSeek R1 / Llama 3).

7. Fallback ve Dağıtık Sistem Dayanıklılığı#

Model sağlayıcıları sıklıkla bölgesel arızalar, kapasite krizleri ve 429 kota aşım hataları verir. Gateway katmanı klasik bir try-catch yerine dağıtık sistem prensipleriyle çalışır:

Şekil 6 — Otomatik Fallback ve Circuit Breaker Akışı
Senaryo Simülasyonu:
1. Birincil Sağlayıcı
OpenAI o3-mini
✓ 200 OK (220ms)
2. İkincil Fallback
Claude 3.7 Sonnet
Beklemede (Standby)
3. Üçüncül Fallback
Self-Hosted vLLM
Acil Durum Havuzu
Birincil model sağlayıcısı 429 (Rate Limit) veya 504 (Timeout) verdiğinde gateway istemciye hata döndürmeden saniyeler içinde ikincil sağlayıcıya geçer.

Burada Circuit Breaker (Devre Kesici), Exponential Backoff ve Hedef Önceliklendirme (Priority Pool) algoritmaları devreye girerek istemci hiçbir kesinti hissetmeden saniyeler içinde yedek sağlayıcıya geçer.

8. Rate Limiting ve Maliyet Yönetişimi (FinOps)#

AI sistemlerinde maliyet altyapının doğrudan bir parametresidir. Gateway her istek için metadata üretir:

token-accounting-schema.json
json
{
  "trace_id": "tr-8941-a9f",
  "tenant_id": "kurumsal-musteri-a",
  "app_id": "crm-ai-agent",
  "virtual_model": "kozmoz-reasoning",
  "selected_provider": "anthropic-claude-3-7",
  "input_tokens": 1420,
  "output_tokens": 890,
  "reasoning_tokens": 310,
  "ttft_ms": 340,
  "cost_usd": 0.0184
}

Bu veriler sayesinde LiteLLM Proxy veya Envoy AI Gateway gibi çözümlerle şirketler departman, müşteri ve ajan bazında aylık bütçe kotaları belirleyip aşım durumunda trafiği otomatik sınırlayabilir.

10. Güvenlik, PII Maskeleme ve Guardrails#

API anahtarlarını mobil uygulamalardan veya yüzlerce mikroservisten çıkarıp gateway'de izole etmek ilk adımdır. Ancak ikinci ve daha kritik adım veri güvenliğidir:

  • PII (Kişisel Veri) Filtreleme: T.C. Kimlik No, kredi kartı veya müşteri telefon bilgileri modele iletilmeden önce gateway katmanında regex/NER modelleriyle maskelenir.
  • Model Allowlist / Denylist: Belirli bir departmanın yalnızca kurum içi onaylı modelleri kullanabilmesi garanti altına alınır.
  • Streaming Guardrails: Cevap akarken parça parça zararlı içerik veya yetkisiz veri sızıntısı kontrol edilir; ihlal anında akış kesilir.

12. GenAI Gözlemlenebilirliği (OpenTelemetry & OpenInference)#

Klasik HTTP 200 / 120ms metrikleri yapay zeka operasyonlarında yetersizdir. Dağıtık bir AI çağrısında izlenmesi gereken temel göstergeler:

TTFT
İlk Token Süresi
Tokens/Sec
Üretim Hızı
Fallback Oranı
% Hata Toleransı
Maliyet/İstek
Bütçe Verimi

Envoy AI Gateway 1.0, OpenTelemetry ve OpenInference standartlarını doğrudan destekleyerek bu metrikleri Prometheus ve Grafana panellerine aktarır.

13. Semantik Önbellekleme (Semantic Caching)#

Kullanıcılar kelimesi kelimesine aynı soruyu sormasalar bile anlamsal olarak özdeş sorular sorabilirler:

Şekil 7 — Semantik Vektör Önbellekleme (Semantic Caching)
Gelen Prompt
"Redis nedir ve ne işe yarar?"
Vektör Benzerliği
98.2%
CACHE HIT
Gecikme: 4msMaliyet: $0.00
Semantik cache, metinlerin vektör benzerliğini (Cosine Similarity) kontrol eder. %95 üzeri benzerlikte cevap anında cache'ten döner; gecikme 4 milisaniyeye, maliyet sıfıra iner.

14. AI Gateway ve Agentic Sistemler: MCP Gateway#

Önceki yazılarımızda incelediğimiz Otonom AI Ajanlarında Çoklu-Ajan Orkestrasyonu ve Agentic DevOps mimarilerinde ajanların harici dünyaya bağlanması gerekir.

Model Context Protocol (MCP) ile ajanlar veritabanlarına, GitHub repolarına ve kurumsal API'lara erişir. Burada asıl soru şudur: “Ajan hangi araçları, hangi yetkiyle ve hangi güvenlik filtresiyle kullanabilir?”

Şekil 8 — Agentic AI ve MCP Gateway Güvenlik Katmanı
AI Agent (Kozmoz / Claude Code)
Görev: "Prod veritabanındaki son siparişleri getir ve PR aç"
MCP GATEWAY (Araç ve Yetki Katmanı)
🔐 OAuth 2.0 Auth🚫 Tool Filtering (Salt Okunur)📝 Audit & Denetim İzi
GitHub MCP
Sadece PR Açma
CRM / ERP MCP
Salt Okunur
DB MCP
DROP/DELETE Engelli
Ajanların harici araçlara ve verilere (GitHub, CRM, DB) erişiminde MCP Gateway merkezi denetim, OAuth yetkilendirme ve araç filtreleme uygular.

MCP Gateway; tüm MCP sunucularını tek bir güvenli uç nokta altında toplar, OAuth 2.0 ile yetkilendirir ve tehlikeli veritabanı silme (DROP/DELETE) komutlarını ajan henüz çalıştırmadan engeller.

16. Kubernetes ve Örnek Rota Politikası#

Kubernetes ortamında bir AI Gateway Custom Resource Definition (CRD) veya YAML rota konfigürasyonu şu şekilde tanımlanır:

ai-gateway-routes.yaml
yaml
apiVersion: gateway.envoyproxy.io/v1alpha1
kind: AIGatewayRoute
metadata:
  name: kozmoz-intelligent-routing
spec:
  rules:
    - matches:
        - headers:
            x-task-type: "reasoning"
      backends:
        - name: anthropic-claude-3-7-sonnet
          weight: 80
        - name: openai-o3-mini
          weight: 20
      fallback:
        - name: local-vllm-deepseek-r1
          timeout: 3000ms

19. AI Gateway Her Sistem İçin Gerekli mi?#

Hayır. Küçük bir prototipte veya tek bir model kullanan basit bir chatbotta gateway eklemek gereksiz operasyonel karmaşıklık yaratır.

Ancak çoklu model, çoklu tenant, otonom ajanlar, yüksek token tüketimi, regülasyon ve maliyet denetimi gereken her kurumsal platformda AI Gateway bir lüks değil, kaçınılmaz bir mimari omurgadır.

Şekil 9 — Kurumsal Cloud-Native AI Gateway Topolojisi
Web / Mobil İstemciler
Otonom Ajanlar
Arka Plan İşçileri
Global Cloud Load Balancer (HTTPS / gRPC / TLS Termination)
YATAY ÖLÇEKLENEN STATELESS GATEWAY POD'LARI (KUBERNETES)
Gateway Node #1
Gateway Node #2
Gateway Node #N
Ortak State & Token Havuzu: Dağıtık Redis Cluster
Bulut Model Sağlayıcıları
OpenAI · Anthropic · Gemini · Bedrock
Self-Hosted GPU Çıkarım (vLLM)
Private Llama 3 · DeepSeek · Qwen
Telemetry Omurgası: OpenTelemetry → Prometheus · Grafana · Jaeger (Traces & TTFT)
Yüksek erişilebilirlik (HA) için yük dengeleyici arkasında yatay ölçeklenen stateless gateway pod'ları, dağıtık Redis state katmanı ve OpenTelemetry gözlemlenebilirlik omurgası.

20. Sonuç ve Kozmoz Perspektifi#

Yapay zeka sistemleri olgunlaştıkça model seçimi tek başına bir mimari karar olmaktan çıkıyor. Geleceğin üretim seviyesi altyapılarında asıl soru yalnızca:

“Hangi modeli kullanıyoruz?” değil; “Sistemimizin hangi koşullarda, hangi modeli, hangi veriye, hangi yetkiyle ve hangi maliyet sınırları içinde kullanmasına izin veriyoruz?” sorusudur.

Kozmoz İnovasyon olarak sunduğumuz Yapay Zeka Sistemleri ve İş Süreçleri Otomasyonu çözümlerimizde AI Gateway katmanını, kurumların yapay zeka operasyonlarını güvenli, ölçülebilir ve kesintisiz şekilde ölçekleyebilmeleri için standart bir mimari katman olarak konumlandırıyoruz.

Süreç konuşması

Kendi hattınızda otonomi ile kapı karışıyor mu?

Demo ile canlı süreç arasındaki fark genelde modelde değil, hangi adımın ajan, hangisinin insan onayı olduğunda çıkar. O sınırı birlikte çizebiliriz.