Magisterium AI expose les compétences suivantes via le protocole A2A. Précisez la compétence à utiliser avec metadata.skillId dans le message. Si skillId est omis, catholic_qa est utilisée par défaut.

Toutes les compétences sont invoquées via la méthode JSON-RPC 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" }
    }
  }
}

Les réponses sont toujours renvoyées sous forme de Task (kind: "task") avec status.state: "completed" et un ou plusieurs artifacts. Chaque artefact possède un artifactId unique, un name spécifique à la compétence et une ou plusieurs parts (text, data ou file).

catholic_qa

Posez une question en langage naturel et recevez une réponse détaillée avec citations. Il s'agit de la compétence la plus puissante (et la plus gourmande en ressources) — elle fonctionne avec le même modèle que celui qui alimente magisterium.com.

Entrée : une unique partie de texte contenant la question.

Artefact : name: "catholic_qa_response" contenant :

• Une partie text avec la réponse complète.
• Une partie data avec citations (lorsque des sources ont été utilisées).
• Une partie data avec related_questions (lorsque le modèle renvoie des suggestions).

{
  "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 utilise une variante de limite d'utilisation plus stricte que les autres compétences. Consultez Référence de l'API → Limites d'utilisation.

document_search

Récupérez des références de documents qui correspondent à une requête sémantique dans la base de connaissances Magisterium.

Entrée : une unique partie de texte contenant la requête.

Artefact : name: "search_results" avec une unique partie data :

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

Utilisez le champ id d'un résultat pour appeler document_fetch et obtenir le texte intégral.

document_fetch

Récupérez le texte intégral et les métadonnées d'un document par son ID. Cette compétence accepte une partie data à la place d'une partie de texte :

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

Si l'appelant envoie une partie de texte, le gestionnaire la traite comme l'ID du document.

Artefact : name: "document" avec deux parties :

• Une partie text contenant le corps du document.
• Une partie data avec { id, title, author, ref }.

Si le document est introuvable, l'artefact contient une unique partie text indiquant "Document not found.".

liturgical_readings

Obtenez les lectures de la messe catholique pour une date donnée. Accepte une requête de date en langage naturel — par exemple "today", "next Sunday" ou "Easter Sunday 2026".

Entrée : une unique partie de texte contenant la requête de date.

Artefact : name: "mass_readings" avec une unique partie text contenant les lectures formatées. Si aucune lecture n'est disponible pour la date demandée, la partie contient "No mass readings found.".

saints_of_the_day

Recherchez les saints commémorés à une date donnée selon le Martyrologe romain.

Entrée : une partie data avec une date absolue, ou une partie de texte traitée comme une requête de date :

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

Artefact : name: "martyrology" avec une unique partie text contenant l'entrée du martyrologe formatée. Les dates sans données renvoient "No martyrology data found.".