Magisterium AI

ഡെവലപ്പർമാർ
പങ്കിടുക:

A2A (പ്രോട്ടോക്കോൾ)
Beta

തുറന്ന A2A (Agent-to-Agent) പ്രോട്ടോക്കോൾ ഉപയോഗിച്ച് Magisterium AI-യെ കണ്ടെത്താനും, അതുമായി ആശയവിനിമയം നടത്താനും, ടാസ്‌ക്കുകൾ ഏൽപ്പിക്കാനും നിങ്ങളുടെ 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

എല്ലാ അഭ്യർത്ഥനകളും Content-Type: application/json ഹെഡറും സ്റ്റാൻഡേർഡ് JSON-RPC 2.0 എൻവലപ്പും ഉപയോഗിച്ച് POST ഉപയോഗിക്കുന്നു.

കഴിവുകൾ

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 രീതികൾ, പിശക് കോഡുകൾ, ടാസ്‌ക് ജീവിതചക്രം.