Stel uw AI-agenten in staat Magisterium AI te ontdekken, ermee te communiceren en taken aan haar te delegeren via het open A2A (Agent-to-Agent) protocol.

Waarom A2A?

Waar MCP AI-tools toegang geeft tot de kennis van het Magisterium, laat A2A AI-agenten als gelijkwaardige partner met Magisterium samenwerken. Een orkestrerende agent kan de mogelijkheden van Magisterium ontdekken, er taken naar sturen en gestructureerde resultaten ontvangen — alles via een standaard JSON-RPC-interface.

Betaald plan vereist. Het A2A-eindpunt is beschikbaar op de Pro-, Organisatie- en Enterprise-plannen. Gratis accounts ontvangen een PLAN_REQUIRED (-32005) fout. Zie MCP-prijzen voor de huidige planlimieten — A2A deelt dezelfde rate-limit-pool.

Agent Discovery

Magisterium AI publiceert een openbare Agent Card op:

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

Zo ontdekken externe agenten de beschikbare skills, authenticatievereisten en de URL van het A2A-eindpunt. De kaart volgt de A2A-specificatie en vereist geen authenticatie om op te halen.

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

A2A-eindpunt

Het JSON-RPC-eindpunt voor alle A2A-bewerkingen is:

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

Alle verzoeken gebruiken POST met een Content-Type: application/json header en een standaard JSON-RPC 2.0-envelop.

Mogelijkheden

De Agent Card kondigt de volgende mogelijkheden aan:

Authenticatie

A2A gebruikt dezelfde OAuth 2.0-gebruikerstoken-authenticatie als de Magisterium MCP-server. U moet een account hebben op magisterium.com om het A2A-eindpunt aan te roepen.

Magisterium publiceert OAuth 2.0-metadata op https://www.magisterium.com/.well-known/oauth-authorization-server, met daarin het autorisatie-eindpunt, het token-eindpunt en het eindpunt voor dynamische clientregistratie. Clients die de OAuth 2.0 Authorization Code-flow (met PKCE) implementeren, kunnen op basis van deze metadata een access token verkrijgen; zie de MCP-authenticatiedocumentatie voor de standaard client-side opzet.

Zodra u een access token heeft, voegt u het toe aan de Authorization-header van elk A2A-verzoek:

Authorization: Bearer $MAGISTERIUM_TOKEN

De langlevende API-sleutels die in de API-console worden aangemaakt, zijn uitsluitend bedoeld voor de Chat Completions-, Search- en News-eindpunten — ze authenticeren niet tegen A2A. Gebruik in plaats daarvan een via OAuth uitgegeven gebruikerstoken.

Ontbrekende of ongeldige tokens geven een UNAUTHORIZED (-32004) fout terug.

Snel voorbeeld

Stuur een vraag naar de catholic_qa-skill:

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

De respons is een voltooide Task met het antwoord en de citaten in 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": [ /* ... */ ] } }
        ]
      }
    ]
  }
}

Volgende stappen

• Aan de slag — doorloop uw eerste A2A-verzoek in curl, Python en TypeScript.
• Skills — de volledige lijst met skills die via A2A beschikbaar zijn, met in- en uitvoervormen per skill.
• API-referentie — JSON-RPC-methoden, foutcodes en taaklevenscyclus.