Omogućite svojim AI agentima da otkriju Magisterium AI, komuniciraju s njim i delegiraju mu zadatke koristeći otvoreni protokol A2A (Agent-to-Agent).

Zašto A2A?

Dok MCP dopušta AI alatima pristup znanju Magisterija, A2A dopušta AI agentima da surađuju s Magisterijem kao ravnopravni partneri. Orkestracijski agent može otkriti mogućnosti Magisterija, slati mu zadatke i primati strukturirane rezultate — sve putem standardnog JSON-RPC sučelja.

Potreban je plaćeni plan. A2A endpoint je dostupan na planovima Pro, Organization i Enterprise. Besplatni računi dobivaju pogrešku PLAN_REQUIRED (-32005). Pogledajte Cijene MCP-a za trenutna ograničenja planova — A2A dijeli isti bazen ograničenja zahtjeva.

Otkrivanje agenta

Magisterium AI objavljuje javnu Agent Card na:

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

Tako vanjski agenti otkrivaju dostupne vještine, zahtjeve za autentifikaciju i URL A2A endpointa. Kartica prati specifikaciju A2A i ne zahtijeva autentifikaciju za dohvat.

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

A2A endpoint

JSON-RPC endpoint za sve A2A operacije:

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

Svi zahtjevi koriste POST sa zaglavljem Content-Type: application/json i standardnim JSON-RPC 2.0 omotom.

Mogućnosti

Agent Card objavljuje sljedeće mogućnosti:

Autentifikacija

A2A koristi istu autentifikaciju s korisničkim OAuth 2.0 tokenom kao i Magisterium MCP poslužitelj. Za pozivanje A2A endpointa morate imati račun na magisterium.com.

Magisterium objavljuje OAuth 2.0 metapodatke na https://www.magisterium.com/.well-known/oauth-authorization-server, uključujući autorizacijski endpoint, token endpoint i endpoint za dinamičku registraciju klijenta. Klijenti koji implementiraju OAuth 2.0 Authorization Code tok (s PKCE) iz tih metapodataka mogu dobiti pristupni token; za standardnu klijentsku konfiguraciju pogledajte dokumentaciju autentifikacije MCP-a.

Kada imate pristupni token, uključite ga u zaglavlje Authorization svakog A2A zahtjeva:

Authorization: Bearer $MAGISTERIUM_TOKEN

Dugotrajni API ključevi generirani u API Console namijenjeni su samo endpointima Chat Completions, Search i News — protiv A2A se s njima ne može autentificirati. Umjesto toga koristite korisnički token izdan putem OAutha.

Nedostajući ili nevažeći tokeni vraćaju pogrešku UNAUTHORIZED (-32004).

Brzi primjer

Pošaljite pitanje vještini 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" }
        }
      }
    }'

Odgovor je dovršeni Task s odgovorom i citatima unutar 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": [ /* ... */ ] } }
        ]
      }
    ]
  }
}

Sljedeći koraci

• Kako početi — prošetajte se kroz svoj prvi A2A zahtjev u curl, Python i TypeScript.
• Vještine — cjelovit popis vještina izloženih putem A2A, s formatima ulaznih i izlaznih podataka za svaku vještinu.
• API Referenca — JSON-RPC metode, kodovi pogrešaka i životni ciklus zadatka.