Ermöglichen Sie Ihren KI-Agenten, Magisterium AI mithilfe des offenen Protokolls A2A (Agent-to-Agent) zu entdecken, mit ihm zu kommunizieren und Aufgaben an es zu delegieren.

Warum A2A?

Während MCP es KI-Tools ermöglicht, auf das Wissen des Magisteriums zuzugreifen, erlaubt A2A KI-Agenten, mit Magisterium als gleichrangigem Partner zusammenzuarbeiten. Ein orchestrierender Agent kann die Fähigkeiten von Magisterium entdecken, ihm Aufgaben senden und strukturierte Ergebnisse erhalten — alles über eine standardisierte JSON-RPC-Schnittstelle.

Kostenpflichtiger Plan erforderlich. Der A2A-Endpunkt ist in den Plänen Pro, Organisation und Enterprise verfügbar. Kostenlose Konten erhalten einen PLAN_REQUIRED (-32005) Fehler. Siehe MCP-Preise für die aktuellen Planlimits — A2A teilt sich denselben Rate-Limit-Pool.

Agent Discovery

Magisterium AI veröffentlicht eine öffentliche Agent Card unter:

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

So entdecken externe Agenten die verfügbaren Skills, Authentifizierungsanforderungen und die A2A-Endpunkt-URL. Die Karte folgt der A2A-Spezifikation und erfordert keine Authentifizierung zum Abrufen.

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

A2A-Endpunkt

Der JSON-RPC-Endpunkt für alle A2A-Operationen lautet:

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

Alle Anfragen verwenden POST mit einem Content-Type: application/json Header und einem standardmäßigen JSON-RPC-2.0-Envelope.

Fähigkeiten

Die Agent Card kündigt folgende Fähigkeiten an:

Authentifizierung

A2A verwendet dieselbe OAuth-2.0-Benutzer-Token-Authentifizierung wie der Magisterium MCP-Server. Sie benötigen ein Konto auf magisterium.com, um den A2A-Endpunkt aufzurufen.

Magisterium veröffentlicht OAuth-2.0-Metadaten unter https://www.magisterium.com/.well-known/oauth-authorization-server, einschließlich des Autorisierungs-Endpunkts, Token-Endpunkts und Endpunkts für die dynamische Client-Registrierung. Clients, die den OAuth-2.0-Authorization-Code-Flow (mit PKCE) implementieren, können aus diesen Metadaten ein Access Token beziehen; siehe die MCP-Authentifizierungsdokumentation für die übliche Client-seitige Einrichtung.

Sobald Sie ein Access Token haben, fügen Sie es dem Authorization-Header jeder A2A-Anfrage hinzu:

Authorization: Bearer $MAGISTERIUM_TOKEN

Die langlebigen API-Schlüssel, die in der API-Konsole erzeugt werden, sind ausschließlich für die Endpunkte Chat Completions, Search und News bestimmt — sie authentifizieren sich nicht gegen A2A. Verwenden Sie stattdessen ein über OAuth ausgestelltes Benutzer-Token.

Fehlende oder ungültige Tokens geben einen UNAUTHORIZED (-32004) Fehler zurück.

Schnellbeispiel

Senden Sie eine Frage an den 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" }
        }
      }
    }'

Die Antwort ist eine abgeschlossene Task mit der Antwort und den Zitaten 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": [ /* ... */ ] } }
        ]
      }
    ]
  }
}

Nächste Schritte

• Erste Schritte — führen Sie Ihre erste A2A-Anfrage mit curl, Python und TypeScript durch.
• Skills — die vollständige Liste der über A2A bereitgestellten Skills mit Ein- und Ausgabeformaten pro Skill.
• API-Referenz — JSON-RPC-Methoden, Fehlercodes und Aufgaben-Lebenszyklus.