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.".