Magisterium AI は以下のスキルを A2A プロトコルを通じて公開しています。メッセージ上の metadata.skillId で使用するスキルを指定してください。skillId を省略した場合は、既定で catholic_qa が使用されます。

すべてのスキルは message/send JSON-RPC メソッドを介して呼び出されます。

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

レスポンスは常に Task（kind: "task"）として返ってきます。status.state は "completed" で、1 つ以上の artifacts を含みます。各 artifact は一意の artifactId、スキル固有の name、および 1 つ以上の parts（text、data、または file）を持ちます。

catholic_qa

自然言語で質問し、引用つきの長文の回答を受け取ります。これは最も高性能（で最もリソースを消費する）スキルです — magisterium.com を動かしているのと同じモデルで実行されます。

入力: 質問を含む単一のテキスト part。

Artifact: name: "catholic_qa_response" で、以下を含みます：

• 完全な回答を含む text part。
• citations を含む data part（何らかの出典が使用された場合）。
• related_questions を含む data part（モデルが提案を返した場合）。

{
  "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 は他のスキルよりも厳しいレートリミットの変種を使用します。API リファレンス → レートリミット を参照してください。

document_search

Magisterium のナレッジベースに対する意味クエリに一致する文書の参照を取得します。

入力: クエリを含む単一のテキスト part。

Artifact: name: "search_results"、単一の data part を含みます：

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

結果の id フィールドを使って document_fetch を呼び出し、全文を取得してください。

document_fetch

ID で文書の全文とメタデータを取得します。このスキルはテキスト part ではなく data part を受け取ります：

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

呼び出し元がテキスト part を送信した場合、ハンドラーはフォールバックとしてそれを文書 ID として扱います。

Artifact: name: "document"、2 つの part を含みます：

• 文書本文を含む text part。
• { id, title, author, ref } を含む data part。

文書が見つからない場合、artifact は "Document not found." と表示される単一の text part を含みます。

liturgical_readings

指定された日付のカトリックミサの朗読を取得します。自然言語 の日付クエリを受け付けます — 例: "today"、"next Sunday"、"Easter Sunday 2026"。

入力: 日付クエリを含む単一のテキスト part。

Artifact: name: "mass_readings"、整形された朗読を含む単一の text part を含みます。要求された日付の朗読が利用できない場合、その part の内容は "No mass readings found." となります。

saints_of_the_day

ローマ殉教録から、指定された日に記念される聖人を検索します。

入力: 絶対日付を持つ data part、または日付クエリとして扱われるテキスト part：

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

Artifact: name: "martyrology"、整形された殉教録のエントリを含む単一の text part を含みます。日付が欠落している場合は "No martyrology data found." が返されます。