Memungkinkan agen AI Anda untuk menemukan, berkomunikasi dengan, dan mendelegasikan tugas ke Magisterium AI menggunakan protokol terbuka A2A (Agent-to-Agent).

Mengapa A2A?

Jika MCP memungkinkan alat AI mengakses pengetahuan Magisterium, A2A memungkinkan agen AI berkolaborasi dengan Magisterium sebagai sesama rekan. Sebuah agen orkestrator dapat menemukan kemampuan Magisterium, mengirimkan tugas kepadanya, dan menerima hasil terstruktur — semuanya melalui antarmuka JSON-RPC standar.

Memerlukan paket berbayar. Endpoint A2A tersedia pada paket Pro, Organisasi, dan Perusahaan. Akun gratis akan menerima error PLAN_REQUIRED (-32005). Lihat Harga MCP untuk batas paket saat ini — A2A berbagi pool pembatas laju yang sama.

Penemuan Agen

Magisterium AI menerbitkan Agent Card publik di:

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

Inilah cara agen eksternal menemukan keterampilan yang tersedia, persyaratan autentikasi, dan URL endpoint A2A. Kartu ini mengikuti spesifikasi A2A dan tidak memerlukan autentikasi untuk diambil.

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

Endpoint A2A

Endpoint JSON-RPC untuk semua operasi A2A adalah:

https://www.magisterium.com/api/v1/a2a

Semua permintaan menggunakan POST dengan header Content-Type: application/json dan envelope JSON-RPC 2.0 standar.

Kemampuan

Agent Card mengumumkan kemampuan berikut:

Autentikasi

A2A menggunakan autentikasi token pengguna OAuth 2.0 yang sama seperti server Magisterium MCP. Anda harus memiliki akun di magisterium.com untuk memanggil endpoint A2A.

Magisterium menerbitkan metadata OAuth 2.0 di https://www.magisterium.com/.well-known/oauth-authorization-server, termasuk endpoint otorisasi, endpoint token, dan endpoint pendaftaran klien dinamis. Klien yang mengimplementasikan alur OAuth 2.0 Authorization Code (dengan PKCE) dapat memperoleh access token dari metadata ini; lihat dokumentasi autentikasi MCP untuk pengaturan sisi klien standar.

Setelah Anda memiliki access token, sertakan di header Authorization pada setiap permintaan A2A:

Authorization: Bearer $MAGISTERIUM_TOKEN

Kunci API berumur panjang yang dibuat di API Console hanya untuk endpoint Chat Completions, Search, dan News — kunci tersebut tidak akan terautentikasi terhadap A2A. Gunakan token pengguna yang diterbitkan OAuth sebagai gantinya.

Token yang hilang atau tidak valid akan mengembalikan error UNAUTHORIZED (-32004).

Contoh Cepat

Kirim pertanyaan ke keterampilan 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" }
        }
      }
    }'

Respons berupa Task yang telah selesai dengan jawaban dan kutipan di dalam 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": [ /* ... */ ] } }
        ]
      }
    ]
  }
}

Langkah Selanjutnya

• Memulai — jalankan permintaan A2A pertama Anda di curl, Python, dan TypeScript.
• Keterampilan — daftar lengkap keterampilan yang dipaparkan melalui A2A, dengan bentuk input dan output per keterampilan.
• Referensi API — metode JSON-RPC, kode error, dan siklus hidup tugas.