Magisterium AI

ডেভেলপাররা
শেয়ার:

A2A (প্রোটোকল)
Beta

উন্মুক্ত A2A (Agent-to-Agent) প্রোটোকল ব্যবহার করে আপনার AI এজেন্টদের ম্যাজিস্টেরিয়াম 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 পদ্ধতি, ত্রুটি কোড এবং কাজের জীবনচক্র।