Ippermetti lill-aġenti AI tiegħek li jiskopru, jikkomunikaw ma' u jiddelegaw xogħlijiet lil Magisterium AI billi jużaw il-protokoll miftuħ A2A (Agent-to-Agent).

Għaliex A2A?

Filwaqt li MCP jippermetti lill-għodod AI jaċċessaw l-għarfien tal-Magisterium, A2A jippermetti lill-aġenti AI jikkollaboraw ma' Magisterium bħala pari. Aġent orkestratur jista' jiskopri l-ħiliet ta' Magisterium, jibagħatlu xogħlijiet, u jirċievi riżultati strutturati — kollha permezz ta' interfaċċja JSON-RPC standard.

Pjan imħallas meħtieġ. L-endpoint A2A huwa disponibbli fuq il-pjanijiet Pro, Organizzazzjoni, u Enterprise. Il-kontijiet b'xejn jirċievu żball PLAN_REQUIRED (-32005). Ara Prezzijiet MCP għal-limiti attwali tal-pjan — A2A jaqsam l-istess pool tar-rate-limit.

Skoperta tal-Aġent

Magisterium AI jippubblika Agent Card pubblika f':

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

Dan huwa kif aġenti esterni jiskopru l-iskills disponibbli, ir-rekwiżiti tal-awtentikazzjoni, u l-URL tal-endpoint A2A. Il-karta ssegwi l-ispeċifikazzjoni A2A u ma teħtieġ l-ebda awtentikazzjoni biex tinġieb.

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

Endpoint A2A

L-endpoint JSON-RPC għall-operazzjonijiet kollha A2A huwa:

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

It-talbiet kollha jużaw POST b'header Content-Type: application/json u envelope JSON-RPC 2.0 standard.

Ħiliet

L-Agent Card tħabbar il-ħiliet li ġejjin:

Awtentikazzjoni

A2A juża l-istess awtentikazzjoni b'token tal-utent OAuth 2.0 bħas-server MCP tal-Magisterium. Trid ikollok kont fuq magisterium.com biex issejjaħ l-endpoint A2A.

Magisterium jippubblika l-metadata OAuth 2.0 fuq https://www.magisterium.com/.well-known/oauth-authorization-server, inklużi l-endpoint tal-awtorizzazzjoni, l-endpoint tat-token, u l-endpoint għar-reġistrazzjoni dinamika tal-klijent. Klijenti li jimplimentaw l-OAuth 2.0 Authorization Code flow (b'PKCE) jistgħu jiksbu access token minn dawn il-metadata; ara d-dokumentazzjoni dwar l-awtentikazzjoni MCP għall-konfigurazzjoni standard min-naħa tal-klijent.

Ladarba jkollok access token, inkludih fl-header Authorization ta' kull talba A2A:

Authorization: Bearer $MAGISTERIUM_TOKEN

Iċ-ċwievet API twal fiż-żmien iġġenerati fl-API Console huma biss għall-endpoints Chat Completions, Search, u News — ma jawtentikawx kontra A2A. Uża minflok token tal-utent maħruġ permezz ta' OAuth.

Tokens nieqsa jew invalidi jagħtu lura żball UNAUTHORIZED (-32004).

Eżempju Veloċi

Ibgħat mistoqsija lill-iskill 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" }
        }
      }
    }'

Ir-rispons huwa Task komplut bir-risposta u ċitazzjonijiet ġewwa 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": [ /* ... */ ] } }
        ]
      }
    ]
  }
}

Passi Li Jmiss

• Kif Tibda — aqsam l-ewwel talba A2A tiegħek f'curl, Python, u TypeScript.
• Skills — il-lista sħiħa tal-iskills esposti permezz ta' A2A, bis-sura ta' input u output għal kull skill.
• Referenza API — metodi JSON-RPC, kodiċi tal-iżbalji, u ċiklu tal-ħajja tax-xogħol.