Magisterium AI

डेवलपर्स
साझा करें:

A2A (प्रोटोकॉल)
Beta

अपने AI एजेंटों को खुले A2A (Agent-to-Agent) प्रोटोकॉल का उपयोग करके मैजिस्टीरियम AI को खोजने, उसके साथ संवाद करने, और उसे कार्य सौंपने में सक्षम बनाएं।

A2A क्यों?

जहाँ MCP AI उपकरणों को मैजिस्टीरियम के ज्ञान तक पहुँच देता है, वहीं A2A AI एजेंटों को मैजिस्टीरियम के साथ एक सहकर्मी के रूप में सहयोग करने की अनुमति देता है। एक ऑर्केस्ट्रेटिंग एजेंट मैजिस्टीरियम की क्षमताओं की खोज कर सकता है, उसे कार्य भेज सकता है, और संरचित परिणाम प्राप्त कर सकता है — सब कुछ एक मानक JSON-RPC इंटरफ़ेस के माध्यम से।

भुगतान की गई योजना आवश्यक। A2A एंडपॉइंट Pro, Organization, और Enterprise योजनाओं पर उपलब्ध है। मुफ्त खातों को PLAN_REQUIRED (-32005) त्रुटि प्राप्त होती है। वर्तमान योजना सीमाओं के लिए MCP मूल्य निर्धारण देखें — A2A समान रेट-लिमिट पूल साझा करता है।

एजेंट खोज

मैजिस्टीरियम AI एक सार्वजनिक Agent Card यहाँ प्रकाशित करता है:

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

इस प्रकार बाहरी एजेंट उपलब्ध कौशलों, प्रमाणीकरण आवश्यकताओं, और A2A एंडपॉइंट URL की खोज करते हैं। कार्ड A2A विनिर्देश का पालन करता है और इसे लाने के लिए किसी प्रमाणीकरण की आवश्यकता नहीं होती।

bash
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 लिफ़ाफ़ा होता है।

क्षमताएँ

Agent Card निम्नलिखित क्षमताओं की घोषणा करता है:

क्षमतासमर्थितटिप्पणियाँ
streamingनहींसभी कौशल तुल्यकालिक हैं — पूर्ण कार्य एक ही प्रतिक्रिया में लौटाया जाता है।
pushNotificationsनहींग्राहक पहले से पूर्ण किए गए कार्य को पुनः प्राप्त करने के लिए tasks/get को पोल करते हैं।
stateTransitionHistoryहाँप्रत्येक कार्य उपयोगकर्ता और एजेंट संदेशों का अपना history सुरक्षित रखता है।

प्रमाणीकरण

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

Magisterium https://www.magisterium.com/.well-known/oauth-authorization-server पर OAuth 2.0 मेटाडेटा प्रकाशित करता है, जिसमें प्राधिकरण एंडपॉइंट, टोकन एंडपॉइंट, और डायनेमिक क्लाइंट-पंजीकरण एंडपॉइंट शामिल हैं। OAuth 2.0 Authorization Code फ्लो (PKCE के साथ) लागू करने वाले क्लाइंट इस मेटाडेटा से एक एक्सेस टोकन प्राप्त कर सकते हैं; मानक क्लाइंट-साइड सेटअप के लिए MCP प्रमाणीकरण दस्तावेज़ देखें।

एक बार जब आपके पास एक्सेस टोकन हो, तो इसे प्रत्येक A2A अनुरोध के Authorization हेडर में शामिल करें:

Authorization: Bearer $MAGISTERIUM_TOKEN

API Console में जनरेट की गई दीर्घकालिक API कुंजियाँ केवल Chat Completions, Search, और News एंडपॉइंट के लिए हैं — वे A2A के विरुद्ध प्रमाणित नहीं होंगी। इसके बजाय OAuth द्वारा जारी उपयोगकर्ता टोकन का उपयोग करें।

गायब या अमान्य टोकन UNAUTHORIZED (-32004) त्रुटि लौटाते हैं।

त्वरित उदाहरण

catholic_qa कौशल को एक प्रश्न भेजें:

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

प्रतिक्रिया एक पूर्ण Task है जिसमें उत्तर और उद्धरण result.artifacts के अंदर होते हैं:

json
{
  "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 के माध्यम से उजागर किए गए कौशलों की पूरी सूची, प्रत्येक कौशल के इनपुट और आउटपुट आकार के साथ।
  • API संदर्भ — JSON-RPC विधियाँ, त्रुटि कोड, और कार्य जीवनचक्र।