Magisterium AI

டெவலப்பர்கள்
பகிர்:

A2A (நெறிமுறை)
Beta

திறந்த A2A (Agent-to-Agent) நெறிமுறையைப் பயன்படுத்தி உங்கள் AI முகவர்களை Magisterium AI-ஐக் கண்டறியவும், அதனுடன் தொடர்பு கொள்ளவும், பணிகளை ஒப்படைக்கவும் உதவுங்கள்.

A2A ஏன்?

MCP AI கருவிகளுக்கு Magisterium-இன் அறிவை அணுக அனுமதிக்கின்றது, அதே சமயம் A2A AI முகவர்களை Magisterium-உடன் சகாவாக ஒத்துழைக்க அனுமதிக்கிறது. ஒரு ஆர்கெஸ்ட்ரேட்டிங் முகவர் Magisterium-இன் திறன்களைக் கண்டறியலாம், அதற்கு பணிகளை அனுப்பலாம், கட்டமைக்கப்பட்ட முடிவுகளைப் பெறலாம் — எல்லாமே ஒரு நிலையான JSON-RPC இடைமுகம் மூலம்.

கட்டண திட்டம் தேவை. A2A எண்ட்பாயிண்ட் Pro, Organization, மற்றும் Enterprise திட்டங்களில் கிடைக்கிறது. இலவச கணக்குகளுக்கு PLAN_REQUIRED (-32005) பிழை கிடைக்கும். தற்போதைய திட்ட வரம்புகளுக்கு MCP விலை நிர்ணயம் பார்க்கவும் — A2A ஒரே ரேட்-லிமிட் குளத்தைப் பகிர்ந்து கொள்கிறது.

முகவர் கண்டறிதல்

Magisterium 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 envelope-உடன்.

திறன்கள்

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

பதிலானது, result.artifacts-க்குள் பதில் மற்றும் மேற்கோள்களுடன் நிறைவு செய்யப்பட்ட ஒரு Task:

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 முறைகள், பிழை குறியீடுகள், மற்றும் பணி வாழ்க்கைச் சுழற்சி.