उजळ्या A2A (Agent-to-Agent) प्रोटोकॉलाचो वापर करून तुमच्या ए.आय. एजंटांना मागिस्टरियम ए.आय.चो शोध घेवपाक, तांच्याशी संवाद करूंक, आनी कार्यां सोंपोवपाक सक्षम करा.

A2A कित्याक?

जंय MCP ए.आय. उपकरणांनां मागिस्टरियमाचें ज्ञान अधिगोचर करपाक दितें, थंय A2A ए.आय. एजंटांनां मागिस्टरियमाशी एका सहकाऱ्या रुपान सहकार करूंक दितें. एक ऑर्केस्ट्रेटिंग एजंट मागिस्टरियमाचे सामर्थ्य शोधू शकता, कार्यां धाडूं शकता, आनी संरचित निकाल मेळवूं शकता — सगळें एका मानक JSON-RPC इंटरफेसा आदारान.

पेड प्लॅन गरजेचो. A2A एंडपॉइंट Pro, Organization, आनी Enterprise प्लॅनांचेर उपलब्ध आसा. फुकट खात्यांक PLAN_REQUIRED (-32005) त्रुटी मेळटा. सद्द्याच्या प्लॅन सीमांखातीर MCP किमती पळयात — A2A तोच रेट-लिमिट पूल वांट्टा.

एजंट शोधप

मागिस्टरियम ए.आय. एक सार्वजनिक Agent Card हांगां प्रकाशित करता:

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

हेच वरीं भायले एजंट उपलब्ध कौशल्यां, प्रमाणीकरण गरजो, आनी A2A एंडपॉइंट URL शोधतात. कार्ड A2A विशिष्टीकरणाचे पालन करता आनी तें घेवपाक कसलोच प्रमाणीकरण गरजेचो ना.

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

A2A एंडपॉइंट

सगळ्या A2A ऑपरेशनांक JSON-RPC एंडपॉइंट आसा:

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

सगळ्यो विनंत्यो POST वापरतात, Content-Type: application/json हेडर आनी मानक JSON-RPC 2.0 envelope सयत.

क्षमता

Agent Card सकयल्या क्षमतांची घोषणा करता:

प्रमाणीकरण

A2A Magisterium MCP सर्व्हर-सारकेंच OAuth 2.0 वापरकर्ता-टोकन प्रमाणीकरण वापरता. A2A एंडपॉइंट कॉल करपाक तुमका magisterium.com-वयर एक खातें आसप गरजेचें.

Magisterium https://www.magisterium.com/.well-known/oauth-authorization-server-वयर OAuth 2.0 metadata प्रकाशित करता, ज्यांत authorization endpoint, token endpoint, आनी dynamic client-registration endpoint आसात. OAuth 2.0 Authorization Code फ्लो (PKCE सयत) चालू करपी क्लायंट ह्या metadata-थावन एक access टोकन मेळोवू शकतात; मानक client-side सेटअपाखातीर MCP प्रमाणीकरण दस्तऐवज पळयात.

एक फावटीं तुमकां access टोकन मेळल्या उपरांत, तिका दरेक A2A विनंतीच्या Authorization हेडरांत घालात:

Authorization: Bearer $MAGISTERIUM_TOKEN

API Console-त तयार केल्ल्यो दीर्गकाळिक API-यो फकत Chat Completions, Search, आनी News endpoints खातीर — त्यो A2A विरुद्ध प्रमाणीकरण कर्तल्यो ना. त्या बदल्यांत OAuth-न जारी केल्लो वापरकर्ता टोकन वापरात.

उणो वा अवैध टोकन UNAUTHORIZED (-32004) त्रुटी परत करतात.

बेगीन उदाहरण

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

प्रतिसाद हो result.artifacts-भितर उत्तर आनी संदर्भांसयत एक पुराय जाल्लें Task आसता:

{
  "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": [ /* ... */ ] } }
        ]
      }
    ]
  }
}

फुडले पांवडे

• सुरुवात करप — curl, Python, आनी TypeScript-मदीं तुमची पयली A2A विनंती करा.
• कौशल्यां — A2A-च्या मार्फत उपलब्ध कौशल्यांची पुराय वळेरी, दरेक कौशल्याच्या input आनी output आकृतींसयत.
• API संदर्भ — JSON-RPC पद्दतो, त्रुटी कोड, आनी कार्य जीवन-चक्र.