OmniRoute/docs/i18n/tr/docs/frameworks/A2A-SERVER.md

title, version, lastUpdated

title	version	lastUpdated
OmniRoute A2A Sunucu Dokümantasyonu	3.8.50	2026-08-23

OmniRoute A2A Sunucu Dokümantasyonu (Türkçe)

🌐 Languages: 🇺🇸 English · 🇸🇦 ar · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇪🇸 es · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇳 gu · 🇮🇱 he · 🇮🇳 hi · 🇭🇺 hu · 🇮🇩 id · 🇮🇹 it · 🇯🇵 ja · 🇰🇷 ko · 🇮🇳 mr · 🇲🇾 ms · 🇳🇱 nl · 🇳🇴 no · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇸🇰 sk · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇻🇳 vi · 🇨🇳 zh-CN

---

Agent-to-Agent Protokolü v0.3 — Akıllı bir yönlendirme ajanı olarak OmniRoute

A2A yüzeyinin iki arayüzü vardır:

• POST /a2a adresinde JSON-RPC 2.0 (kurallı giriş noktası, src/app/a2a/route.ts içinde tanımlı).
• Panolar ve araçlar için /api/a2a/* altında REST (durum, görev listesi, iptal).

Görevler A2ATaskManager (src/lib/a2a/taskManager.ts, varsayılan 5 dakikalık TTL) tarafından izlenir. Yetenekler src/lib/a2a/taskExecution.ts içindeki A2A_SKILL_HANDLERS aracılığıyla dağıtılır.

Ajan Keşfi (Agent Discovery)

curl http://localhost:20128/.well-known/agent.json

OmniRoute'un yeteneklerini, becerilerini ve kimlik doğrulama gereksinimlerini açıklayan Ajan Kartını (Agent Card) döndürür.

---

Kimlik Doğrulama

Tüm /a2a istekleri Authorization başlığı aracılığıyla bir API anahtarı gerektirir:

Authorization: Bearer SIZIN_OMNIROUTE_API_ANAHTARINIZ

Sunucuda hiçbir API anahtarı yapılandırılmamışsa, kimlik doğrulama atlanır.

Etkinleştirme

A2A, Uç Noktalar → A2A anahtarıyla kontrol edilir ve varsayılan olarak devre dışıdır. Devre dışıyken, GET /api/a2a/status status: "disabled" ve online: false bildirir; POST /a2a çağrıları -32000 JSON-RPC hata koduyla HTTP 503 döndürür.

---

JSON-RPC 2.0 Metotları

message/send — Eşzamanlı Yürütme

Bir yeteneğe mesaj gönderir ve tam yanıtı bekler.

curl -X POST http://localhost:20128/a2a \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "message/send",
    "params": {
      "skill": "smart-routing",
      "messages": [{"role": "user", "content": "Write a hello world in Python"}],
      "metadata": {"model": "auto", "combo": "fast-coding"}
    }
  }'

message/stream — SSE Akışı

message/send ile aynıdır ancak gerçek zamanlı akış için Server-Sent Events döndürür.

tasks/get — Görev Durumu Alma

params.id ile bir görevin durumunu, yapıtlarını ve yürütme meta verilerini sorgular.

tasks/cancel — Görevi İptal Etme

Çalışan bir görevi iptal eder.

---

Desteklenen A2A Yetenekleri (Skills)

1. smart-routing — Akıllı yönlendirme ve çok sağlayıcılı geri dönüş ile mesaj gönderme.
2. quota-management — Tüm bağlı sağlayıcılardaki kota durumunu ve sıfırlanma sürelerini kontrol etme.
3. provider-discovery — Uygun sağlayıcıları ve modelleri yeteneklere göre listeleme.
4. cost-analysis — Oturum veya zaman dilimi bazında maliyet analiz raporu alma.
5. health-report — Sistem çalışma süresi, devre kesiciler ve sağlayıcı sağlık durumu.
6. list-capabilities — Desteklenen tüm modelleri, komboları ve stratejileri listeleme.