Omogočite svojim AI agentom, da odkrijejo Magisterium AI, komunicirajo z njim in mu dodeljujejo naloge z uporabo odprtega protokola A2A (Agent-to-Agent).

Zakaj A2A?

Medtem ko MCP omogoča AI orodjem dostop do znanja Magisterija, A2A omogoča AI agentom sodelovanje z Magisterijem kot enakovrednim partnerjem. Orkestracijski agent lahko odkrije zmogljivosti Magisterija, mu pošlje naloge in prejme strukturirane rezultate — vse preko standardnega JSON-RPC vmesnika.

Potreben je plačljiv načrt. Končna točka A2A je na voljo v načrtih Pro, Organization in Enterprise. Brezplačni računi prejmejo napako PLAN_REQUIRED (-32005). Za trenutne omejitve načrtov si oglejte MCP Cenik — A2A uporablja isti bazen omejitev zahtev.

Odkrivanje agenta

Magisterium AI objavlja javno Agent Card na naslovu:

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

Tako zunanji agenti odkrijejo razpoložljive veščine, zahteve za avtentifikacijo in URL končne točke A2A. Kartica je skladna s specifikacijo A2A in ne zahteva avtentifikacije za prenos.

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

Končna točka A2A

JSON-RPC končna točka za vse operacije A2A:

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

Vse zahteve uporabljajo POST z glavo Content-Type: application/json in standardno ovojnico JSON-RPC 2.0.

Zmogljivosti

Agent Card oglašuje naslednje zmogljivosti:

Avtentifikacija

A2A uporablja enako avtentifikacijo z uporabniškim žetonom OAuth 2.0 kot strežnik Magisterium MCP. Za klicanje končne točke A2A morate imeti račun na magisterium.com.

Magisterium objavlja metapodatke OAuth 2.0 na https://www.magisterium.com/.well-known/oauth-authorization-server, vključno z avtorizacijsko končno točko, končno točko za žeton in končno točko za dinamično registracijo odjemalca. Odjemalci, ki implementirajo OAuth 2.0 Authorization Code tok (s PKCE), lahko iz teh metapodatkov pridobijo dostopni žeton; standardno odjemalčevo nastavitev si oglejte v dokumentaciji avtentifikacije MCP.

Ko imate dostopni žeton, ga vključite v glavo Authorization vsake zahteve A2A:

Authorization: Bearer $MAGISTERIUM_TOKEN

Dolgotrajni API ključi, ustvarjeni v API Console, so namenjeni le za končne točke Chat Completions, Search in News — proti A2A se z njimi ne boste mogli avtentificirati. Namesto njih uporabite uporabniški žeton, izdan prek OAuth.

Manjkajoči ali neveljavni žetoni vrnejo napako UNAUTHORIZED (-32004).

Hitri primer

Pošljite vprašanje veščini catholic_qa:

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

Odziv je dokončana Task z odgovorom in citati znotraj result.artifacts:

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

Naslednji koraki

• Začetek — sprehodite se skozi svojo prvo zahtevo A2A v curl, Python in TypeScript.
• Veščine — celoten seznam veščin, na voljo preko A2A, z obliko vhodnih in izhodnih podatkov za vsako veščino.
• API Referenca — JSON-RPC metode, kode napak in življenjski cikel naloge.