Позвольте вашим ИИ-агентам обнаруживать Magisterium AI, общаться с ним и делегировать ему задачи, используя открытый протокол A2A (Agent-to-Agent).

Зачем нужен A2A?

В то время как MCP позволяет ИИ-инструментам получать доступ к знаниям Magisterium, A2A позволяет ИИ-агентам взаимодействовать с 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

Именно так внешние агенты обнаруживают доступные навыки, требования к аутентификации и URL эндпоинта A2A. Карта соответствует спецификации A2A и не требует аутентификации для получения.

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

Эндпоинт A2A

JSON-RPC эндпоинт для всех операций A2A:

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.

Получив токен доступа, включайте его в заголовок Authorization каждого запроса A2A:

Authorization: Bearer $MAGISTERIUM_TOKEN

Долгоживущие API-ключи, создаваемые в API Console, предназначены только для эндпоинтов 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, коды ошибок и жизненный цикл задач.