Magisterium AI предоставляет следующие навыки через протокол A2A. Укажите используемый навык через metadata.skillId в сообщении. Если skillId опущен, по умолчанию используется catholic_qa.

Все навыки вызываются с помощью JSON-RPC метода message/send.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "messageId": "unique-id",
      "kind": "message",
      "parts": [{ "kind": "text", "text": "your query here" }],
      "metadata": { "skillId": "document_search" }
    }
  }
}

Ответы всегда возвращаются в виде Task (kind: "task") со status.state: "completed" и одним или несколькими artifacts. Каждый артефакт имеет уникальный artifactId, специфичное для навыка name и одну или несколько parts (text, data или file).

catholic_qa

Задайте вопрос на естественном языке и получите подробный ответ с цитатами. Это самый мощный (и наиболее ресурсоёмкий) навык — он работает с той же моделью, что питает magisterium.com.

Входные данные: одна text-часть с вопросом.

Артефакт: name: "catholic_qa_response", содержащий:

• text-часть с полным ответом.
• data-часть с citations (когда использовались какие-либо источники).
• data-часть с related_questions (когда модель возвращает предложения).

{
  "artifactId": "art_...",
  "name": "catholic_qa_response",
  "parts": [
    { "kind": "text", "text": "The Catholic Church teaches..." },
    { "kind": "data", "data": { "citations": [ /* ... */ ] } },
    { "kind": "data", "data": { "related_questions": [ /* ... */ ] } }
  ]
}

catholic_qa использует более строгий вариант лимита запросов, чем другие навыки. См. Справочник API → Лимиты запросов.

document_search

Получить ссылки на документы, соответствующие семантическому запросу по базе знаний Magisterium.

Входные данные: одна text-часть с запросом.

Артефакт: name: "search_results" с одной data-частью:

{
  "artifactId": "art_...",
  "name": "search_results",
  "parts": [
    {
      "kind": "data",
      "data": {
        "results": [
          { "id": "12345", "url": "https://...", "title": "Lumen Gentium" }
        ]
      }
    }
  ]
}

Используйте поле id из результата, чтобы вызвать document_fetch для получения полного текста.

document_fetch

Получение полного текста и метаданных документа по его ID. Этот навык принимает data-часть вместо text-части:

{
  "parts": [{ "kind": "data", "data": { "id": "12345" } }]
}

Если вызывающая сторона отправляет text-часть, обработчик по умолчанию рассматривает её как ID документа.

Артефакт: name: "document" с двумя частями:

• text-часть, содержащая тело документа.
• data-часть с { id, title, author, ref }.

Если документ не найден, артефакт содержит одну text-часть со значением "Document not found.".

liturgical_readings

Получение католических чтений Мессы на заданную дату. Принимает запрос даты на естественном языке — например, "today", "next Sunday" или "Easter Sunday 2026".

Входные данные: одна text-часть с запросом даты.

Артефакт: name: "mass_readings" с одной text-частью, содержащей отформатированные чтения. Если на запрошенную дату чтений нет, часть содержит "No mass readings found.".

saints_of_the_day

Узнайте, какие святые поминаются в заданный день, согласно Римскому Мартирологу.

Входные данные: data-часть с абсолютной датой, или text-часть, рассматриваемая как запрос даты:

{
  "parts": [{ "kind": "data", "data": { "date": "2026-03-19" } }]
}

Артефакт: name: "martyrology" с одной text-частью, содержащей отформатированную запись мартиролога. Отсутствующие даты возвращают "No martyrology data found.".