Concede agentibus tuis AI ut Magisterium AI per protocollum apertum A2A (Agent-to-Agent) inveniant, cum eo communicent, et munia ei delegent.

Quare A2A?

Dum MCP instrumentis AI accessum ad scientiam Magisterii praebet, A2A agentibus AI permittit ut cum Magisterio sicut par cooperentur. Agens dispositor facultates Magisterii invenire potest, munia ei mittere, et resultata structurata accipere — omnia per interfaciem JSON-RPC standardem.

Consilium solvendum requiritur. Terminus A2A praesto est in consiliis Pro, Organization, et Enterprise. Rationes liberae errorem PLAN_REQUIRED (-32005) accipiunt. Vide Pretium MCP pro praesentibus limitibus consiliorum — A2A eandem copiam rate-limit communicat.

Inventio Agentis

Magisterium AI Chartam Agentis publicam edit apud:

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

Hoc modo agentes externi inveniunt facultates praesto, requisita authentificationis, et URL termini A2A. Charta specificationem A2A sequitur et nullam authentificationem ad petendum requirit.

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

Terminus A2A

Terminus JSON-RPC pro omnibus operationibus A2A est:

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

Omnes postulationes POST utuntur cum capite Content-Type: application/json et involucro standardi JSON-RPC 2.0.

Facultates

Charta Agentis facultates sequentes annuntiat:

Authentication

A2A eadem authentificatione pignoris usuarii OAuth 2.0 utitur ac serviens Magisterii MCP. Necesse est rationem habere apud magisterium.com ad terminum A2A invocandum.

Magisterium metadata OAuth 2.0 edit apud https://www.magisterium.com/.well-known/oauth-authorization-server, comprehendens terminum auctorizationis, terminum pignoris, et terminum dynamicae inscriptionis clientis. Clientes qui fluxum OAuth 2.0 Authorization Code (cum PKCE) implementant pignus accessus ex his metadatis obtinere possunt; vide documenta authentificationis MCP pro institutione standardi ex parte clientis.

Cum pignus accessus habeas, illud in capite Authorization cuiusque postulationis A2A include:

Authorization: Bearer $MAGISTERIUM_TOKEN

Claves API diuturnae quae in API Console generantur sunt solum pro terminis Chat Completions, Search, et News — eae non authentificantur contra A2A. Utere potius pignore usuarii per OAuth emisso.

Pignora deficientia vel invalida errorem UNAUTHORIZED (-32004) reddunt.

Exemplum breve

Mitte quaestionem ad facultatem 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" }
        }
      }
    }'

Responsum est Task completum cum responso et citationibus intra 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": [ /* ... */ ] } }
        ]
      }
    ]
  }
}

Gradus sequentes

• Initium — primam postulationem A2A in curl, Python, et TypeScript transi.
• Facultates — integer index facultatum per A2A expositarum, cum formis ingressus et egressus per facultatem.
• API Referentia — methodi JSON-RPC, codices errorum, et vitae cursus muneris.