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