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.
• 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", 두 개의 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."를 반환합니다.