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",並附帶一個或多個 artifacts。每個 artifact 都有唯一的 artifactId、與技能相關的 name,以及一個或多個 parts（text、data 或 file）。

catholic_qa

用自然語言提出一個問題,獲得附帶引用的長篇回答。這是功能最強大（也最耗資源）的技能 —— 它執行於與 magisterium.com 相同的模型之上。

輸入： 含問題的單一文字 part。

Artifact： name: "catholic_qa_response",內容包含:

• 一個 text part,含完整答案。
• 一個 data part,內含 citations（當使用了任何來源時）。
• 一個 data part,內含 related_questions（當模型返回建議時）。

{
  "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 擷取某份文獻的完整內文與中繼資料。此技能接受一個 data part,而不是文字 part:

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

若呼叫方傳送的是文字 part,處理程式會退回將其視為文獻 ID。

Artifact： name: "document",含兩個 part:

• 一個 text part,內含文獻內文。
• 一個 data part,內含 { id, title, author, ref }。

若找不到文獻,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."。