A Magisterium AI az A2A protokollon keresztül a következő képességeket teszi elérhetővé. Az üzenet metadata.skillId mezőjén keresztül adja meg a használni kívánt képességet. Ha a skillId kimarad, alapértelmezésként a catholic_qa kerül felhasználásra.

Minden képesség a message/send JSON-RPC metóduson keresztül hívható meg.

{
  "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" }
    }
  }
}

A válaszok mindig Task (kind: "task") formájában érkeznek vissza status.state: "completed" állapottal és egy vagy több artifacts elemmel. Minden artefaktumnak van egy egyedi artifactId-ja, egy képességspecifikus name-je és egy vagy több parts eleme (text, data vagy file).

catholic_qa

Tegyen fel egy természetes nyelvű kérdést, és idézetekkel ellátott, hosszabb választ fog kapni. Ez a legerősebb (és a legerőforrás-igényesebb) képesség — ugyanazon a modellen fut, amely a magisterium.com-ot is működteti.

Bemenet: egyetlen szöveges rész a kérdéssel.

Artefaktum: name: "catholic_qa_response", amely tartalmazza:

• Egy text részt a teljes válasszal.
• Egy data részt citations-szel (ha voltak források).
• Egy data részt related_questions-szel (ha a modell javaslatokat ad vissza).

{
  "artifactId": "art_...",
  "name": "catholic_qa_response",
  "parts": [
    { "kind": "text", "text": "The Catholic Church teaches..." },
    { "kind": "data", "data": { "citations": [ /* ... */ ] } },
    { "kind": "data", "data": { "related_questions": [ /* ... */ ] } }
  ]
}

A catholic_qa a többi képességnél szigorúbb kéréskorlát-variánst használ. Lásd: API referencia → Kérési korlátok.

document_search

Dokumentumhivatkozásokat kér le, amelyek megfelelnek egy szemantikus lekérdezésnek a Magisterium tudásbázisa ellenében.

Bemenet: egyetlen szöveges rész a lekérdezéssel.

Artefaktum: name: "search_results" egyetlen data résszel:

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

Használja a találat id mezőjét a document_fetch meghívásához a teljes szöveg lekéréséhez.

document_fetch

Egy dokumentum teljes szövegének és metaadatainak lekérése az azonosítója alapján. Ez a képesség egy data részt fogad el szöveges rész helyett:

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

Ha a hívó szöveges részt küld, a kezelő alapértelmezés szerint azt dokumentumazonosítónak tekinti.

Artefaktum: name: "document" két résszel:

• Egy text rész a dokumentum törzsével.
• Egy data rész a { id, title, author, ref } mezőkkel.

Ha a dokumentum nem található, az artefaktum egyetlen text részt tartalmaz a következő tartalommal: "Document not found.".

liturgical_readings

Katolikus szentmise-olvasmányok lekérése egy adott dátumra. Természetes nyelvű dátum-lekérdezést fogad el — például "today", "next Sunday" vagy "Easter Sunday 2026".

Bemenet: egyetlen szöveges rész a dátum lekérdezéssel.

Artefaktum: name: "mass_readings" egyetlen text résszel, amely a formázott olvasmányokat tartalmazza. Ha a kért dátumra nincsenek elérhető olvasmányok, a rész tartalma: "No mass readings found.".

saints_of_the_day

Keresse meg a Római Martirológium szerint egy adott napra megemlékezett szenteket.

Bemenet: egy data rész abszolút dátummal, vagy egy dátum-lekérdezésként kezelt szöveges rész:

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

Artefaktum: name: "martyrology" egyetlen text résszel, amely a formázott martirológiumi bejegyzést tartalmazza. Hiányzó dátumok esetén a válasz "No martyrology data found.".

Az alábbi öt képesség katalóguskereső. Mindegyik elfogad egy természetes nyelvű query lekérdezést (szöveges részként vagy data.query mezőként), valamint egy opcionális kanonikus azonosítót, és egyetlen data részben strukturált profilt ad vissza. Ha sem query, sem kanonikus azonosító nincs megadva, a kérést INVALID_PARAMS (-32602) hibával utasítja vissza.

Ha a lekérdezés nem oldható fel, az artefaktum egy data részt tartalmaz { "error": "not_found", "query": "...", "hint"?: "..." } formában a profil helyett. Maga a feladat továbbra is sikerrel zárul — a not_found normális keresési eredmény, nem protokollhiba.

saint_lookup

Szent, boldog, tiszteletreméltó vagy Isten szolgája keresése a cd_saints katalógusban (~12 500 alak).

Bemenet: data.query (pl. "Therese of Lisieux") vagy data.saint_id (kanonikus elsődleges kulcs, pl. "jerome"). Egy önálló szöveges rész query-ként elfogadott.

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

Artefaktum: name: "saint_profile" egyetlen data résszel, amely tartalmazza a kanonikus profilt — saint_id, primary_name, canonical_status, vocation, image_url, learn_more_url, élet- és haláladatok, ünnepnap, kanonizációs ügy, patrónusság, ikonográfia, életrajz, és (ha több jelölt is volt) egy alternates tömb.

person_lookup

Katolikus klerikus (püspök, bíboros, érsek stb.) keresése a cd_persons (élő, ~3 500) és a cd_persons_historical (~2 200) katalógusokban. A pápákat külön pope_lookup képesség teszi elérhetővé.

Bemenet: data.query (pl. "Cardinal Tagle") vagy data.person_id (kanonikus elsődleges kulcs). Egy önálló szöveges rész query-ként elfogadott.

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

Artefaktum: name: "person_profile" egyetlen data résszel, amely tartalmazza a kanonikus profilt — person_id, source_table, primary_name, current_position, image_url, coat_of_arms_url, papp- és püspökszentelés dátumai, bíborosi kreáció, püspöki utódlási vonal, tanulmányok, jelmondat és bármely alternates.

Ha a lekérdezés csak egy pápára illeszthető, a válasz { "error": "not_found", "hint": "Top match looks like a pope; try get_pope." }.

pope_lookup

Pápa keresése a cd_popes katalógusban (267 alak).

Bemenet: data.query (pl. "Pope Francis", "John Paul II") vagy data.pope_id (kanonikus elsődleges kulcs, pl. "benedict-xvi"). Egy önálló szöveges rész query-ként elfogadott.

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

Artefaktum: name: "pope_profile" egyetlen data résszel, amely tartalmazza a kanonikus pápai profilt — pope_id, primary_name, papal_name, ordinal, pope_title, image_url, coat_of_arms_url, birth_name, origin, pontificate, boldoggá- és szenttéavatási státusz, és bármely alternates.

Ha a lekérdezés csak nem pápa klerikusra illeszthető, a válasz { "error": "not_found", "hint": "Top match looks like a non-pope clergy member; try get_person." }.

diocese_lookup

Egyházi joghatóság (egyházmegye, főegyházmegye, eparchia stb.) keresése az egyházmegye-katalógusból (~3 200 joghatóság világszerte).

Bemenet: data.query (pl. "Archdiocese of Manila") vagy data.source_code (kanonikus elsődleges kulcs, pl. "dmaml"). Egy önálló szöveges rész query-ként elfogadott.

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

Artefaktum: name: "diocese_profile" egyetlen data résszel, amely tartalmazza a katalógus metaadatait (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), valamint:

• recent_statistics — legfeljebb 5 év kiemelt mutatói (katolikusok, teljes népesség, katolikus arány, papok teljes száma, plébániák, keresztelések, kispapok).
• latest_financials — a legfrissebb pénzügyi év kiemelt mutatói (összes bevétel, összes kiadás, nettó eszközök, összes eszköz, többlet/hiány), ha rendelkezésre állnak, pénznemmel együtt.
• alternates — ha több jelölt illeszkedett.

Több éves trendelemzéshez használja inkább a diocese_statistics_lookup képességet.

diocese_statistics_lookup

Az egyházmegye teljes éves statisztikai idősorát adja vissza — a diocese_statistics által nyilvántartott mind a 19 mutatót.

Bemenet: data.query vagy data.source_code (egyik kötelező), plusz opcionális, mindkét végén záró határok:

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

Artefaktum: name: "diocese_statistics_time_series" egyetlen data résszel, amely tartalmazza a source_code, diocese_name, year_range: { start, end } mezőket és egy rows tömböt. Minden sor 19 mutatót hordoz egy évre vonatkozóan: 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.