Tegye lehetővé AI ügynökeinek, hogy felfedezzék a Magisterium AI-t, kommunikáljanak vele és feladatokat delegáljanak neki a nyílt A2A (Agent-to-Agent) protokoll segítségével.

Miért A2A?

Míg az MCP AI eszközök számára teszi lehetővé a Magisterium tudásához való hozzáférést, az A2A AI ügynökök számára teszi lehetővé, hogy a Magisteriummal egyenrangú partnerként működjenek együtt. Egy orkesztráló ügynök képes felfedezni a Magisterium képességeit, feladatokat küldeni neki és strukturált eredményeket fogadni — mindezt szabványos JSON-RPC felületen keresztül.

Fizetős csomag szükséges. Az A2A végpont a Pro, Organization és Enterprise csomagokban érhető el. Az ingyenes fiókok PLAN_REQUIRED (-32005) hibát kapnak. Az aktuális csomagkorlátokról lásd: MCP Árazás — az A2A ugyanazt a kérésikorlát-készletet használja.

Ügynök felfedezése

A Magisterium AI nyilvános Agent Card-ot tesz közzé a következő címen:

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

Így fedezik fel a külső ügynökök az elérhető képességeket, a hitelesítési követelményeket és az A2A végpont URL-jét. A kártya megfelel az A2A specifikációnak és nem igényel hitelesítést a lekéréshez.

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

A2A végpont

A JSON-RPC végpont minden A2A művelethez:

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

Minden kérés POST metódust használ Content-Type: application/json fejléccel és szabványos JSON-RPC 2.0 borítékkal.

Képességek

Az Agent Card a következő képességeket hirdeti:

Hitelesítés

Az A2A ugyanazt az OAuth 2.0 felhasználói tokenes hitelesítést használja, mint a Magisterium MCP szerver. Az A2A végpont hívásához rendelkeznie kell egy magisterium.com fiókkal.

A Magisterium OAuth 2.0 metaadatokat tesz közzé a https://www.magisterium.com/.well-known/oauth-authorization-server címen, beleértve az engedélyezési végpontot, a token végpontot és a dinamikus kliensregisztrációs végpontot. Az OAuth 2.0 Authorization Code folyamatot (PKCE-vel) megvalósító kliensek e metaadatokból szerezhetnek hozzáférési tokent; a standard kliensoldali beállításhoz lásd az MCP hitelesítési dokumentációt.

Ha rendelkezik hozzáférési tokennel, mellékelje az Authorization fejléchez minden A2A kérésben:

Authorization: Bearer $MAGISTERIUM_TOKEN

Az API Console-ban generált hosszú élettartamú API kulcsok csak a Chat Completions, Search és News végpontokhoz használhatók — A2A ellen nem hitelesítenek. Helyettük használjon OAuth által kibocsátott felhasználói tokent.

A hiányzó vagy érvénytelen tokenek UNAUTHORIZED (-32004) hibát eredményeznek.

Gyors példa

Küldjön egy kérdést a catholic_qa képességnek:

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" }
        }
      }
    }'

A válasz egy befejezett Task, a válasszal és az idézetekkel a result.artifacts belsejében:

{
  "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": [ /* ... */ ] } }
        ]
      }
    ]
  }
}

Következő lépések

• Kezdő lépések — sétáljon végig az első A2A kérésén curl, Python és TypeScript nyelven.
• Képességek — az A2A-n keresztül elérhető képességek teljes listája, képességenkénti bemeneti és kimeneti formátumokkal.
• API referencia — JSON-RPC metódusok, hibakódok és a feladat életciklusa.