Files
OmniRoute/docs/i18n/tr/docs/frameworks/A2A-SERVER.md
Diego Rodrigues de Sa e Souza 9debec71ec feat(i18n): 9 new locales — all 24 official EU languages (51 locales) (#13044)
Batch 1 of the locale expansion: Greek, Croatian, Serbian, Lithuanian, Estonian, Latvian, Slovenian, Maltese and Irish across the dashboard catalog, docs mirrors, CLI catalog, README, locale index and the site. 42 → 51 locales.

Also fixes the ICU literal escape the translation backend dropped around angle placeholders, four translations that invented or renamed a placeholder, the language bars that linked to mirrors that do not exist, and the migration count drift (171 → 172).

⚠️ base-red inherited: #12732 — the four unit shards and Fast Quality Gates fail identically on unrelated PRs cut from the same base.
2026-09-10 10:13:09 -03:00

5.9 KiB
Raw Blame History

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 · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇮🇩 id · 🇮🇹 it · 🇯🇵 ja · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇳🇱 nl · 🇳🇴 no · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇺🇦 uk-UA · 🇵🇰 ur · 🇻🇳 vi · 🇨🇳 zh-CN · 🇹🇼 zh-TW


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.