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