Magisterium AI stellt die folgenden Skills über das A2A-Protokoll bereit. Geben Sie den zu verwendenden Skill über metadata.skillId in der Nachricht an. Wird skillId weggelassen, wird standardmäßig catholic_qa verwendet.

Alle Skills werden über die JSON-RPC-Methode message/send aufgerufen.

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

Die Antworten kommen immer als Task (kind: "task") mit status.state: "completed" und einem oder mehreren artifacts zurück. Jedes Artefakt hat eine eindeutige artifactId, einen skill-spezifischen name und einen oder mehrere parts (text, data oder file).

catholic_qa

Stellen Sie eine Frage in natürlicher Sprache und erhalten Sie eine zitierte, ausführliche Antwort. Dies ist der leistungsfähigste (und ressourcenintensivste) Skill — er läuft auf demselben Modell, das auch magisterium.com antreibt.

Eingabe: ein einzelner Text-Part mit der Frage.

Artefakt: name: "catholic_qa_response" enthält:

• Einen text-Part mit der vollständigen Antwort.
• Einen data-Part mit citations (wenn Quellen verwendet wurden).
• Einen data-Part mit related_questions (wenn das Modell Vorschläge zurückgibt).

{
  "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 verwendet eine strengere Rate-Limit-Variante als die anderen Skills. Siehe API-Referenz → Rate-Limits.

document_search

Abruf von Dokumentreferenzen, die einer semantischen Abfrage gegen die Magisterium-Wissensdatenbank entsprechen.

Eingabe: ein einzelner Text-Part mit der Abfrage.

Artefakt: name: "search_results" mit einem einzigen data-Part:

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

Verwenden Sie das id-Feld eines Ergebnisses, um document_fetch für den vollständigen Text aufzurufen.

document_fetch

Abruf des vollständigen Textes und der Metadaten eines Dokuments anhand seiner ID. Dieser Skill akzeptiert einen data-Part anstelle eines Text-Parts:

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

Sendet der Aufrufer einen Text-Part, greift der Handler darauf zurück, ihn als Dokument-ID zu behandeln.

Artefakt: name: "document" mit zwei Parts:

• Einem text-Part mit dem Dokumenteninhalt.
• Einem data-Part mit { id, title, author, ref }.

Wird das Dokument nicht gefunden, enthält das Artefakt einen einzelnen text-Part mit "Document not found.".

liturgical_readings

Abruf der katholischen Messlesungen für ein bestimmtes Datum. Akzeptiert eine Datumsabfrage in natürlicher Sprache — z. B. „heute", „nächsten Sonntag" oder „Ostersonntag 2026".

Eingabe: ein einzelner Text-Part mit der Datumsabfrage.

Artefakt: name: "mass_readings" mit einem einzigen text-Part, der die formatierten Lesungen enthält. Sind für das angeforderte Datum keine Lesungen verfügbar, lautet der Part "No mass readings found.".

saints_of_the_day

Nachschlagen der Heiligen, die an einem bestimmten Datum aus dem Martyrologium Romanum gefeiert werden.

Eingabe: ein data-Part mit einem absoluten Datum oder ein Text-Part, der als Datumsabfrage behandelt wird:

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

Artefakt: name: "martyrology" mit einem einzigen text-Part, der den formatierten Martyrologium-Eintrag enthält. Fehlende Daten liefern "No martyrology data found.".