Magisterium AI zpřístupňuje prostřednictvím protokolu A2A následující dovednosti. Dovednost pro použití určete přes metadata.skillId ve zprávě. Pokud skillId chybí, použije se jako výchozí catholic_qa.

Všechny dovednosti se vyvolávají přes JSON-RPC metodu 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" }
    }
  }
}

Odpovědi se vždy vrací jako Task (kind: "task") se status.state: "completed" a jedním nebo více artifacts. Každý artefakt má unikátní artifactId, name specifické pro dovednost a jednu nebo více parts (text, data nebo file).

catholic_qa

Položte dotaz v přirozeném jazyce a obdržíte citovanou rozsáhlou odpověď. Toto je nejvýkonnější (a nejnáročnější) dovednost — běží na stejném modelu, který pohání magisterium.com.

Vstup: jedna textová část s otázkou.

Artefakt: name: "catholic_qa_response" obsahující:

• Část text s úplnou odpovědí.
• Část data s citations (pokud byly použity nějaké zdroje).
• Část data s related_questions (když model vrací návrhy).

{
  "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 používá přísnější variantu limitu požadavků než ostatní dovednosti. Viz API Reference → Limity požadavků.

document_search

Získá odkazy na dokumenty, které odpovídají sémantickému dotazu vůči znalostní bázi Magisteria.

Vstup: jedna textová část s dotazem.

Artefakt: name: "search_results" s jednou částí data:

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

Použijte pole id z výsledku k volání document_fetch pro úplný text.

document_fetch

Načtení plného textu a metadat dokumentu podle jeho ID. Tato dovednost přijímá místo textové části část data:

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

Pokud volající pošle textovou část, handler ji ve výchozím nastavení zpracuje jako ID dokumentu.

Artefakt: name: "document" se dvěma částmi:

• Část text obsahující tělo dokumentu.
• Část data s { id, title, author, ref }.

Pokud dokument není nalezen, artefakt obsahuje jednu část text se zněním "Document not found.".

liturgical_readings

Získání katolických čtení při mši pro daný den. Akceptuje dotaz na datum v přirozeném jazyce — např. "today", "next Sunday" nebo "Easter Sunday 2026".

Vstup: jedna textová část s dotazem na datum.

Artefakt: name: "mass_readings" s jednou částí text obsahující naformátovaná čtení. Pokud pro požadované datum nejsou k dispozici žádná čtení, část obsahuje "No mass readings found.".

saints_of_the_day

Vyhledejte svaté připomínané v daný den podle Římského martyrologia.

Vstup: část data s absolutním datem nebo textová část považovaná za dotaz na datum:

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

Artefakt: name: "martyrology" s jednou částí text obsahující naformátovaný záznam martyrologia. Chybějící data vrací "No martyrology data found.".