Magisterium AI facultates sequentes per protocollum A2A exponit. Specifica facultatem adhibendam per metadata.skillId in nuntio. Si skillId omittitur, catholic_qa tamquam praesumpta adhibetur.

Omnes facultates per methodum JSON-RPC message/send invocantur.

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

Responsa semper reveniunt sicut Task (kind: "task") cum status.state: "completed" et una vel pluribus artifacts. Unumquodque artefactum habet unicam artifactId, name facultati propriam, et unam vel plures parts (text, data, vel file).

catholic_qa

Pone quaestionem in lingua naturali et accipe responsum longum cum citationibus. Haec est facultas maxime capax (et maxime opum intensiva) — in eodem modello currit quod magisterium.com alit.

Ingressus: una pars textus cum quaestione.

Artefactum: name: "catholic_qa_response" continens:

• Partem text cum responso integro.
• Partem data cum citations (cum fontes adhibiti sunt).
• Partem data cum related_questions (cum modellum suggestiones reddit).

{
  "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 variante rate-limit strictiore utitur quam ceterae facultates. Vide API Referentiam → Limites rate.

document_search

Recupera referentias documenti quae quaesitioni semanticae contra scientiae basem Magisterii respondent.

Ingressus: una pars textus cum quaesitione.

Artefactum: name: "search_results" cum unica parte data:

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

Utere campo id ex resultato ad invocandum document_fetch pro textu integro.

document_fetch

Recupera textum integrum et metadata documenti per ID eius. Haec facultas partem data accipit loco partis textus:

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

Si vocator partem textus mittit, tractator eam tractat sicut ID documenti.

Artefactum: name: "document" cum duabus partibus:

• Parte text continente corpus documenti.
• Parte data cum { id, title, author, ref }.

Si documentum non invenitur, artefactum unam partem text continet legentem "Document not found.".

liturgical_readings

Obtine lectiones Missae catholicae pro data certa. Accipit quaesitionem datae in lingua naturali — exempli gratia "today", "next Sunday", vel "Easter Sunday 2026".

Ingressus: una pars textus cum quaesitione datae.

Artefactum: name: "mass_readings" cum unica parte text continente lectiones formatas. Si nullae lectiones praesto sunt pro data petita, pars legit "No mass readings found.".

saints_of_the_day

Inquire sanctos qui data data celebrantur ex Martyrologio Romano.

Ingressus: pars data cum data absoluta, aut pars textus tractata sicut quaesitio datae:

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

Artefactum: name: "martyrology" cum unica parte text continente ingressum martyrologii formatum. Datae deficientes reddunt "No martyrology data found.".