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

Pět dovedností níže jsou vyhledávání v adresářích. Každá přijímá dotaz v přirozeném jazyce query (jako textovou část nebo pole data.query) plus volitelný kanonický ID a vrací strukturovaný profil v jediné části data. Pokud nejsou poskytnuty ani query, ani kanonický ID, požadavek je odmítnut chybou INVALID_PARAMS (-32602).

Pokud dotaz nelze vyřešit, artefakt obsahuje část data ve tvaru { "error": "not_found", "query": "...", "hint"?: "..." } namísto profilu. Samotná úloha přesto úspěšně skončí — not_found je běžný výsledek vyhledávání, nikoli chyba protokolu.

saint_lookup

Vyhledejte svatého, blahoslaveného, ctihodného nebo služebníka Božího z adresáře cd_saints (~12 500 osob).

Vstup: data.query (např. "Therese of Lisieux") nebo data.saint_id (kanonický primární klíč, např. "jerome"). Samostatná textová část je přijímána jako query.

{
  "parts": [{ "kind": "data", "data": { "query": "Catherine of Siena" } }]
}

Artefakt: name: "saint_profile" s jednou částí data obsahující kanonický profil — saint_id, primary_name, canonical_status, vocation, image_url, learn_more_url, údaje o životě a smrti, svátek, kanonizační proces, patronát, ikonografii, životopis a (pokud bylo nalezeno více kandidátů) pole alternates.

person_lookup

Vyhledejte katolického duchovního (biskup, kardinál, arcibiskup atd.) z adresářů cd_persons (žijící, ~3 500) a cd_persons_historical (~2 200). Papežové jsou zpřístupněni samostatnou dovedností pope_lookup.

Vstup: data.query (např. "Cardinal Tagle") nebo data.person_id (kanonický primární klíč). Samostatná textová část je přijímána jako query.

{
  "parts": [{ "kind": "data", "data": { "query": "Cardinal Tagle" } }]
}

Artefakt: name: "person_profile" s jednou částí data obsahující kanonický profil — person_id, source_table, primary_name, current_position, image_url, coat_of_arms_url, data svěcení a konsekrace, kardinálské povýšení, biskupskou linii, vzdělání, heslo a případné alternates.

Pokud dotaz odpovídá pouze papeži, odpověď je { "error": "not_found", "hint": "Top match looks like a pope; try get_pope." }.

pope_lookup

Vyhledejte papeže z adresáře cd_popes (267 osob).

Vstup: data.query (např. "Pope Francis", "John Paul II") nebo data.pope_id (kanonický primární klíč, např. "benedict-xvi"). Samostatná textová část je přijímána jako query.

{
  "parts": [{ "kind": "data", "data": { "query": "John Paul II" } }]
}

Artefakt: name: "pope_profile" s jednou částí data obsahující kanonický papežský profil — pope_id, primary_name, papal_name, ordinal, pope_title, image_url, coat_of_arms_url, birth_name, origin, pontificate, status beatifikace a kanonizace a případné alternates.

Pokud dotaz odpovídá pouze duchovnímu, který není papežem, odpověď je { "error": "not_found", "hint": "Top match looks like a non-pope clergy member; try get_person." }.

diocese_lookup

Vyhledejte církevní jurisdikci (diecéze, arcidiecéze, eparchie atd.) z adresáře diecézí (~3 200 jurisdikcí po celém světě).

Vstup: data.query (např. "Archdiocese of Manila") nebo data.source_code (kanonický primární klíč, např. "dmaml"). Samostatná textová část je přijímána jako query.

{
  "parts": [{ "kind": "data", "data": { "query": "Archdiocese of Manila" } }]
}

Artefakt: name: "diocese_profile" s jednou částí data obsahující metadata adresáře (source_code, primary_name, jurisdiction_type, rite, country, region_primary, state, city, metropolitan, depends_on, province, cathedral, patron_saint, area, erected, elevated, official_website, image_url, current_bishop) plus:

• recent_statistics — až 5 let hlavních ukazatelů (katolíci, celková populace, procento katolíků, celkový počet kněží, farnosti, křty, seminaristé).
• latest_financials — hlavní ukazatele za nejnovější účetní rok (celkové výnosy, celkové výdaje, čistá aktiva, celková aktiva, přebytek/schodek), pokud jsou k dispozici, s měnou.
• alternates — když odpovídalo více kandidátů.

Pro víceletou analýzu trendů použijte místo toho diocese_statistics_lookup.

diocese_statistics_lookup

Vrátí úplnou roční časovou řadu statistik pro diecézi — všech 19 ukazatelů sledovaných v diocese_statistics.

Vstup: data.query nebo data.source_code (jeden je vyžadován), plus volitelné inkluzivní hranice:

{
  "parts": [{
    "kind": "data",
    "data": {
      "source_code": "dmaml",
      "start_year": 2010,
      "end_year": 2024
    }
  }]
}

Artefakt: name: "diocese_statistics_time_series" s jednou částí data obsahující source_code, diocese_name, year_range: { start, end } a pole rows. Každý řádek nese 19 ukazatelů za jeden rok: catholics, total_population, percent_catholic, diocesan_priests, religious_priests, total_priests, catholics_per_priest, permanent_deacons, male_religious, female_religious, parishes, area_km2, churches_or_stations, diocesan_priests_ordained, religious_priests_ordained, seminarians, educational_institutes, charitable_institutes, baptisms.