Տվեք ձեր AI գործակալներին հնարավորություն՝ բաց A2A (Agent-to-Agent) արձանագրության միջոցով հայտնաբերել Magisterium AI-ն, շփվել նրա հետ և պատվիրակել նրան առաջադրանքներ։

Ինչու՞ A2A։

Եթե MCP-ն AI գործիքներին թույլ է տալիս մուտք գործել Մագիստրիումի գիտելիքներին, ապա A2A-ն AI գործակալներին թույլ է տալիս համագործակցել Magisterium-ի հետ որպես հավասար գործընկեր։ Համադրող գործակալը կարող է հայտնաբերել Magisterium-ի հնարավորությունները, ուղարկել նրան առաջադրանքներ և ստանալ կառուցվածքային արդյունքներ — և այս ամենը՝ ստանդարտ JSON-RPC միջերեսի միջոցով։

Պահանջվում է վճարովի պլան։ A2A վերջնակետը հասանելի է Pro, Կազմակերպություն և Տնտեսություն պլաններում։ Անվճար հաշիվները ստանում են PLAN_REQUIRED (-32005) սխալ։ Տե՛ս MCP-ի գները ընթացիկ պլանի սահմանափակումների համար — A2A-ն կիսում է նույն արագության սահմանաչափի ավազանը։

Գործակալի հայտնաբերում

Magisterium AI-ն հրապարակում է հանրային 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 ծրարը։

Հնարավորություններ

Agent Card-ը հայտարարում է հետևյալ հնարավորությունները.

Որակավորում

A2A-ն օգտագործում է նույն OAuth 2.0 օգտատիրոջ թոքենի որակավորումը, ինչ Magisterium MCP սերվերը։ A2A վերջնակետը կանչելու համար անհրաժեշտ է magisterium.com-ում ունենալ հաշիվ։

Magisterium-ը հրապարակում է OAuth 2.0 մետատվյալները https://www.magisterium.com/.well-known/oauth-authorization-server հասցեում՝ ներառյալ որակավորման վերջնակետը, թոքենի վերջնակետը և դինամիկ հաճախորդի գրանցման վերջնակետը։ Հաճախորդները, որոնք իրականացնում են 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 հմտությանը.

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-ի ներսում.

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

Հաջորդ քայլերը

• Սկսելը — քայլ առ քայլ անցեք ձեր առաջին A2A հարցումը curl-ով, Python-ով և TypeScript-ով։
• Հմտություններ — A2A-ի միջոցով բացահայտված հմտությունների ամբողջական ցանկը՝ յուրաքանչյուրի մուտքային և ելքային կառուցվածքներով։
• API հղում — JSON-RPC մեթոդներ, սխալի կոդեր և առաջադրանքի կյանքի ցիկլ։