Açık A2A (Agent-to-Agent) protokolünü kullanarak AI ajanlarınızın Magisterium AI'ı keşfetmesini, onunla iletişim kurmasını ve ona görev delege etmesini sağlayın.

Neden A2A?

MCP, AI araçlarına Magisterium'un bilgisine erişme imkânı verirken, A2A, AI ajanlarının Magisterium ile bir eş olarak işbirliği yapmasını sağlar. Orkestre eden bir ajan, Magisterium'un yeteneklerini keşfedebilir, ona görev gönderebilir ve yapılandırılmış sonuçlar alabilir — tüm bunlar standart bir JSON-RPC arayüzü aracılığıyla gerçekleşir.

Ücretli plan gereklidir. A2A uç noktası Pro, Organizasyon ve Kurumsal planlarda kullanılabilir. Ücretsiz hesaplar PLAN_REQUIRED (-32005) hatası alır. Güncel plan limitleri için MCP Fiyatlandırma bölümüne bakın — A2A aynı hız sınırı havuzunu MCP ile paylaşır.

Ajan Keşfi

Magisterium AI, aşağıdaki adreste bir kamuya açık Agent Card yayımlar:

https://www.magisterium.com/.well-known/agent.json

Dış ajanlar, mevcut yetenekleri, kimlik doğrulama gereksinimlerini ve A2A uç nokta URL'sini bu şekilde keşfeder. Bu kart A2A spesifikasyonunu izler ve alınması için kimlik doğrulama gerektirmez.

curl https://www.magisterium.com/.well-known/agent.json

A2A Uç Noktası

Tüm A2A işlemleri için JSON-RPC uç noktası:

https://www.magisterium.com/api/v1/a2a

Tüm istekler POST yöntemini, Content-Type: application/json başlığını ve standart bir JSON-RPC 2.0 zarfını kullanır.

Yetenekler

Agent Card aşağıdaki yetenekleri ilan eder:

Kimlik Doğrulama

A2A, Magisterium MCP sunucusu ile aynı OAuth 2.0 kullanıcı-token kimlik doğrulamasını kullanır. A2A uç noktasını çağırabilmek için magisterium.com üzerinde bir hesabınızın olması gerekir.

Magisterium, https://www.magisterium.com/.well-known/oauth-authorization-server adresinde OAuth 2.0 meta verilerini yayımlar; bunlar yetkilendirme uç noktası, token uç noktası ve dinamik istemci kayıt uç noktasını içerir. OAuth 2.0 Authorization Code akışını (PKCE ile) uygulayan istemciler bu meta verilerden bir erişim token'ı alabilir; standart istemci tarafı kurulum için MCP kimlik doğrulama dokümanlarına bakın.

Bir erişim token'ınız olduktan sonra, bunu her A2A isteğinin Authorization başlığına ekleyin:

Authorization: Bearer $MAGISTERIUM_TOKEN

API Konsolu'nda oluşturulan uzun ömürlü API anahtarları yalnızca Chat Completions, Search ve News uç noktaları içindir — bunlar A2A'ya karşı kimlik doğrulaması yapmaz. Bunun yerine OAuth tarafından verilmiş bir kullanıcı token'ı kullanın.

Eksik veya geçersiz token'lar UNAUTHORIZED (-32004) hatasını döndürür.

Hızlı Örnek

catholic_qa yeteneğine bir soru gönderin:

curl -X POST https://www.magisterium.com/api/v1/a2a \
    -H "Authorization: Bearer $MAGISTERIUM_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "message/send",
      "params": {
        "message": {
          "role": "user",
          "messageId": "msg-001",
          "kind": "message",
          "parts": [{ "kind": "text", "text": "What does the Church teach about the Real Presence?" }],
          "metadata": { "skillId": "catholic_qa" }
        }
      }
    }'

Yanıt, cevap ve alıntıların result.artifacts içinde yer aldığı tamamlanmış bir Task'tır:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "id": "task_abc123",
    "contextId": "ctx_def456",
    "kind": "task",
    "status": { "state": "completed", "timestamp": "2026-04-20T12:00:00.000Z" },
    "artifacts": [
      {
        "artifactId": "art_ghi789",
        "name": "catholic_qa_response",
        "parts": [
          { "kind": "text", "text": "The Catholic Church teaches..." },
          { "kind": "data", "data": { "citations": [ /* ... */ ] } }
        ]
      }
    ]
  }
}

Sonraki Adımlar

• Başlarken — curl, Python ve TypeScript ile ilk A2A isteğinizi adım adım deneyin.
• Yetenekler — A2A aracılığıyla sunulan yeteneklerin tam listesi ve her yeteneğin giriş/çıkış biçimi.
• API Referansı — JSON-RPC yöntemleri, hata kodları ve görev yaşam döngüsü.