Magisterium AI preko protokola A2A izpostavlja naslednje veščine. Veščino za uporabo določite preko metadata.skillId v sporočilu. Če je skillId izpuščen, se privzeto uporabi catholic_qa.

Vse veščine se prikličejo preko 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" }
    }
  }
}

Odzivi se vedno vrnejo kot Task (kind: "task") s status.state: "completed" in enim ali več artifacts. Vsak artefakt ima edinstven artifactId, veščini specifičen name in enega ali več parts (text, data ali file).

catholic_qa

Postavite vprašanje v naravnem jeziku in prejmite citirani, obsežen odgovor. To je najzmogljivejša (in najbolj zahtevna) veščina — teče na istem modelu, ki poganja magisterium.com.

Vhod: en tekstovni del z vprašanjem.

Artefakt: name: "catholic_qa_response", ki vsebuje:

• Del text s celotnim odgovorom.
• Del data s citations (ko so bili uporabljeni viri).
• Del data s related_questions (ko model vrne predloge).

{
  "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 uporablja strožjo različico omejitve zahtev kot druge veščine. Oglejte si API Referenca → Omejitve zahtev.

document_search

Pridobi reference dokumentov, ki se ujemajo s semantično poizvedbo v znanja bazi Magisterium.

Vhod: en tekstovni del s poizvedbo.

Artefakt: name: "search_results" z enim delom data:

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

Uporabite polje id iz rezultata za klic document_fetch za celotno besedilo.

document_fetch

Pridobivanje celotnega besedila in metapodatkov dokumenta po njegovem ID-ju. Ta veščina namesto tekstovnega dela sprejema del data:

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

Če klicatelj pošlje tekstovni del, ga obravnavalec obravnava kot ID dokumenta.

Artefakt: name: "document" z dvema deloma:

• Del text, ki vsebuje telo dokumenta.
• Del data s { id, title, author, ref }.

Če dokument ni najden, artefakt vsebuje en del text z vsebino "Document not found.".

liturgical_readings

Pridobivanje katoliških maših beril za dani datum. Sprejme poizvedbo datuma v naravnem jeziku — npr. "today", "next Sunday" ali "Easter Sunday 2026".

Vhod: en tekstovni del s poizvedbo datuma.

Artefakt: name: "mass_readings" z enim delom text, ki vsebuje oblikovana berila. Če za zahtevani datum ni na voljo beril, del vsebuje "No mass readings found.".

saints_of_the_day

Poiščite svetnike, ki se jih spominja na dani dan iz Rimskega martirologija.

Vhod: del data z absolutnim datumom ali tekstovni del, obravnavan kot poizvedba datuma:

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

Artefakt: name: "martyrology" z enim delom text, ki vsebuje oblikovan vnos martirologija. Manjkajoči datumi vrnejo "No martyrology data found.".

Spodnjih pet veščin so iskanja po imeniku. Vsaka sprejme poizvedbo v naravnem jeziku query (kot tekstovni del ali polje data.query) in neobvezni kanonični ID, ter vrne strukturiran profil v enem data delu. Če ne query ne kanonični ID nista podana, je zahteva zavrnjena z napako INVALID_PARAMS (-32602).

Kadar poizvedbe ni mogoče razrešiti, artefakt namesto profila vsebuje del data v obliki { "error": "not_found", "query": "...", "hint"?: "..." }. Naloga sama se vseeno uspešno zaključi — not_found je običajen rezultat iskanja, ne protokolarna napaka.

saint_lookup

Poiščite svetnika, blaženega, častitljivega ali Božjega služabnika iz imenika cd_saints (~12.500 oseb).

Vhod: data.query (npr. "Therese of Lisieux") ali data.saint_id (kanonični primarni ključ, npr. "jerome"). Goli tekstovni del je sprejet kot query.

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

Artefakt: name: "saint_profile" z enim delom data, ki vsebuje kanonični profil — saint_id, primary_name, canonical_status, vocation, image_url, learn_more_url, podatke o življenju in smrti, god, kanonizacijski postopek, zavetništvo, ikonografijo, življenjepis in (če je bilo najdenih več kandidatov) polje alternates.

person_lookup

Poiščite katoliškega duhovnika (škof, kardinal, nadškof itd.) iz imenikov cd_persons (živeči, ~3.500) in cd_persons_historical (~2.200). Papeži so izpostavljeni preko ločene veščine pope_lookup.

Vhod: data.query (npr. "Cardinal Tagle") ali data.person_id (kanonični primarni ključ). Goli tekstovni del je sprejet kot query.

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

Artefakt: name: "person_profile" z enim delom data, ki vsebuje kanonični profil — person_id, source_table, primary_name, current_position, image_url, coat_of_arms_url, datume mašniškega in škofovskega posvečenja, kardinalsko povišanje, škofovsko nasledstvo, izobrazbo, geslo in morebitne alternates.

Če se poizvedba razreši samo do papeža, je odgovor { "error": "not_found", "hint": "Top match looks like a pope; try get_pope." }.

pope_lookup

Poiščite papeža iz imenika cd_popes (267 oseb).

Vhod: data.query (npr. "Pope Francis", "John Paul II") ali data.pope_id (kanonični primarni ključ, npr. "benedict-xvi"). Goli tekstovni del je sprejet kot query.

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

Artefakt: name: "pope_profile" z enim delom data, ki vsebuje kanonični papeški profil — pope_id, primary_name, papal_name, ordinal, pope_title, image_url, coat_of_arms_url, birth_name, origin, pontificate, status beatifikacije in kanonizacije ter morebitne alternates.

Če se poizvedba razreši samo do duhovnika, ki ni papež, je odgovor { "error": "not_found", "hint": "Top match looks like a non-pope clergy member; try get_person." }.

diocese_lookup

Poiščite cerkveno pristojnost (škofija, nadškofija, eparhija itd.) iz imenika škofij (~3.200 pristojnosti po vsem svetu).

Vhod: data.query (npr. "Archdiocese of Manila") ali data.source_code (kanonični primarni ključ, npr. "dmaml"). Goli tekstovni del je sprejet kot query.

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

Artefakt: name: "diocese_profile" z enim delom data, ki vsebuje 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) ter:

• recent_statistics — do 5 let glavnih kazalnikov (katoličani, skupna populacija, odstotek katoličanov, skupno število duhovnikov, župnije, krsti, bogoslovci).
• latest_financials — glavni kazalniki najnovejšega finančnega leta (skupni prihodki, skupni odhodki, neto sredstva, skupna sredstva, presežek/primanjkljaj), kadar so na voljo, z valuto.
• alternates — ko se je ujemalo več kandidatov.

Za večletno analizo trendov uporabite diocese_statistics_lookup.

diocese_statistics_lookup

Vrne celotno letno časovno vrsto statistike za škofijo — vseh 19 kazalnikov, sledenih v diocese_statistics.

Vhod: data.query ali data.source_code (eno od njiju je obvezno) ter neobvezne vključujoče meje:

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

Artefakt: name: "diocese_statistics_time_series" z enim delom data, ki vsebuje source_code, diocese_name, year_range: { start, end } in polje rows. Vsaka vrstica nosi 19 kazalnikov za eno leto: 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.