Magisterium AI izlaže sljedeće vještine kroz protokol A2A. Vještinu za upotrebu odredite pomoću metadata.skillId u poruci. Ako je skillId izostavljen, koristi se catholic_qa kao zadani.

Sve vještine se pozivaju putem JSON-RPC metode 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" }
    }
  }
}

Odgovori se uvijek vraćaju kao Task (kind: "task") sa status.state: "completed" i jednim ili više artifacts. Svaki artefakt ima jedinstven artifactId, name specifičan za vještinu i jedan ili više parts (text, data ili file).

catholic_qa

Postavite pitanje prirodnim jezikom i primite citirani, opsežan odgovor. Ovo je najmoćnija (i najzahtjevnija) vještina — radi na istom modelu koji pokreće magisterium.com.

Ulaz: jedan tekstualni dio s pitanjem.

Artefakt: name: "catholic_qa_response" koji sadrži:

• Dio text s potpunim odgovorom.
• Dio data s citations (kada su korišteni izvori).
• Dio data s related_questions (kada model vraća prijedloge).

{
  "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 koristi strožu varijantu ograničenja zahtjeva od ostalih vještina. Vidi API Referenca → Ograničenja zahtjeva.

document_search

Dohvati reference dokumenata koji odgovaraju semantičkom upitu prema bazi znanja Magisterium.

Ulaz: jedan tekstualni dio s upitom.

Artefakt: name: "search_results" s jednim dijelom data:

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

Koristite polje id iz rezultata za pozivanje document_fetch radi dohvata cjelovitog teksta.

document_fetch

Dohvati cjelovit tekst i metapodatke dokumenta prema njegovom ID-u. Ova vještina prihvaća data dio umjesto tekstualnog dijela:

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

Ako pozivatelj šalje tekstualni dio, obrađivač ga prema zadanim postavkama tretira kao ID dokumenta.

Artefakt: name: "document" s dva dijela:

• Dio text koji sadrži tijelo dokumenta.
• Dio data s { id, title, author, ref }.

Ako dokument nije pronađen, artefakt sadrži jedan dio text sa sadržajem "Document not found.".

liturgical_readings

Dohvati katolička čitanja Mise za zadani datum. Prihvaća upit datuma na prirodnom jeziku — npr. "today", "next Sunday" ili "Easter Sunday 2026".

Ulaz: jedan tekstualni dio s upitom datuma.

Artefakt: name: "mass_readings" s jednim dijelom text koji sadrži formatirana čitanja. Ako za traženi datum nisu dostupna čitanja, dio sadrži "No mass readings found.".

saints_of_the_day

Potražite svece koji se spominju na zadani dan iz Rimskoga martirologija.

Ulaz: dio data s apsolutnim datumom ili tekstualni dio tretiran kao upit datuma:

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

Artefakt: name: "martyrology" s jednim dijelom text koji sadrži formatirani unos martirologija. Datumi koji nedostaju vraćaju "No martyrology data found.".

Pet vještina u nastavku su pretraživanja imenika. Svaka prihvaća upit prirodnim jezikom query (kao tekstualni dio ili kao polje data.query) plus neobavezni kanonski ID, a vraća strukturirani profil unutar jednoga data dijela. Ako nisu navedeni ni query ni kanonski ID, zahtjev se odbija s pogreškom INVALID_PARAMS (-32602).

Kada upit ne može biti razriješen, artefakt sadrži dio data u obliku { "error": "not_found", "query": "...", "hint"?: "..." } umjesto profila. Sam zadatak ipak završava uspješno — not_found je uobičajen rezultat pretrage, a ne pogreška protokola.

saint_lookup

Potražite sveca, blaženika, časnoga ili slugu Božjega iz imenika cd_saints (~12.500 osoba).

Ulaz: data.query (npr. "Therese of Lisieux") ili data.saint_id (kanonski primarni ključ, npr. "jerome"). Sam tekstualni dio prihvaća se kao query.

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

Artefakt: name: "saint_profile" s jednim dijelom data koji sadrži kanonski profil — saint_id, primary_name, canonical_status, vocation, image_url, learn_more_url, podatke o životu i smrti, blagdan, kanonizacijski postupak, zaštitništvo, ikonografiju, životopis i (ako je pronađeno više kandidata) polje alternates.

person_lookup

Potražite katoličkoga klerika (biskup, kardinal, nadbiskup itd.) iz imenika cd_persons (živući, ~3.500) i cd_persons_historical (~2.200). Pape su izložene zasebnom vještinom pope_lookup.

Ulaz: data.query (npr. "Cardinal Tagle") ili data.person_id (kanonski primarni ključ). Sam tekstualni dio prihvaća se kao query.

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

Artefakt: name: "person_profile" s jednim dijelom data koji sadrži kanonski profil — person_id, source_table, primary_name, current_position, image_url, coat_of_arms_url, datume ređenja i posvete, kardinalsku kreaciju, biskupsku liniju, obrazovanje, geslo i moguće alternates.

Ako se upit razriješi samo do pape, odgovor je { "error": "not_found", "hint": "Top match looks like a pope; try get_pope." }.

pope_lookup

Potražite papu iz imenika cd_popes (267 osoba).

Ulaz: data.query (npr. "Pope Francis", "John Paul II") ili data.pope_id (kanonski primarni ključ, npr. "benedict-xvi"). Sam tekstualni dio prihvaća se kao query.

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

Artefakt: name: "pope_profile" s jednim dijelom data koji sadrži kanonski papinski profil — pope_id, primary_name, papal_name, ordinal, pope_title, image_url, coat_of_arms_url, birth_name, origin, pontificate, status beatifikacije i kanonizacije te moguće alternates.

Ako se upit razriješi samo do klerika koji nije papa, odgovor je { "error": "not_found", "hint": "Top match looks like a non-pope clergy member; try get_person." }.

diocese_lookup

Potražite crkvenu jurisdikciju (biskupija, nadbiskupija, eparhija itd.) iz imenika biskupija (~3.200 jurisdikcija širom svijeta).

Ulaz: data.query (npr. "Archdiocese of Manila") ili data.source_code (kanonski primarni ključ, npr. "dmaml"). Sam tekstualni dio prihvaća se kao query.

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

Artefakt: name: "diocese_profile" s jednim dijelom data koji sadrži metapodatke imenika (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 — do 5 godina glavnih pokazatelja (katolici, ukupna populacija, postotak katolika, ukupan broj svećenika, župe, krštenja, sjemeništarci).
• latest_financials — glavni pokazatelji najnovije fiskalne godine (ukupni prihodi, ukupni rashodi, neto imovina, ukupna imovina, višak/manjak) kada su dostupni, s valutom.
• alternates — kada se podudaralo više kandidata.

Za višegodišnju analizu trendova umjesto toga koristite diocese_statistics_lookup.

diocese_statistics_lookup

Vraća cjelovitu godišnju vremensku seriju statistika za biskupiju — svih 19 pokazatelja praćenih u diocese_statistics.

Ulaz: data.query ili data.source_code (jedno je obavezno), plus neobavezne uključive granice:

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

Artefakt: name: "diocese_statistics_time_series" s jednim dijelom data koji sadrži source_code, diocese_name, year_range: { start, end } i polje rows. Svaki red nosi 19 pokazatelja za jednu godinu: 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.