Magisterium AI cung cấp các kỹ năng sau thông qua giao thức A2A. Chỉ định kỹ năng sẽ dùng qua metadata.skillId trong tin nhắn. Nếu skillId bị bỏ qua, catholic_qa sẽ được dùng làm mặc định.

Tất cả kỹ năng đều được gọi qua phương thức 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" }
    }
  }
}

Phản hồi luôn quay về dưới dạng Task (kind: "task") với status.state: "completed" và một hoặc nhiều artifacts. Mỗi artifact có một artifactId duy nhất, một name đặc trưng cho kỹ năng và một hoặc nhiều parts (text, data hoặc file).

catholic_qa

Đặt một câu hỏi bằng ngôn ngữ tự nhiên và nhận một câu trả lời dài, có trích dẫn. Đây là kỹ năng mạnh nhất (và tiêu tốn tài nguyên nhất) — nó chạy trên cùng một mô hình đang vận hành magisterium.com.

Đầu vào: một phần text duy nhất chứa câu hỏi.

Artifact: name: "catholic_qa_response" bao gồm:

• Một phần text với câu trả lời đầy đủ.
• Một phần data với citations (khi có bất kỳ nguồn nào được sử dụng).
• Một phần data với related_questions (khi mô hình trả về các gợi ý).

{
  "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 sử dụng biến thể giới hạn tốc độ nghiêm ngặt hơn các kỹ năng khác. Xem Tham khảo API → Giới hạn tốc độ.

document_search

Truy xuất các tham chiếu tài liệu khớp với một truy vấn ngữ nghĩa trong cơ sở tri thức Magisterium.

Đầu vào: một phần text duy nhất chứa truy vấn.

Artifact: name: "search_results" với một phần data duy nhất:

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

Dùng trường id trong kết quả để gọi document_fetch lấy toàn văn.

document_fetch

Lấy toàn văn và siêu dữ liệu của một tài liệu theo ID. Kỹ năng này chấp nhận một phần data thay vì phần text:

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

Nếu người gọi gửi một phần text, trình xử lý sẽ chuyển sang coi đó là ID tài liệu.

Artifact: name: "document" với hai phần:

• Một phần text chứa nội dung tài liệu.
• Một phần data với { id, title, author, ref }.

Nếu không tìm thấy tài liệu, artifact chứa một phần text duy nhất có nội dung "Document not found.".

liturgical_readings

Lấy bài đọc Thánh Lễ Công giáo cho một ngày nhất định. Chấp nhận truy vấn ngày theo ngôn ngữ tự nhiên — ví dụ "today", "next Sunday" hoặc "Easter Sunday 2026".

Đầu vào: một phần text duy nhất với truy vấn ngày.

Artifact: name: "mass_readings" với một phần text duy nhất chứa các bài đọc đã được định dạng. Nếu không có bài đọc cho ngày được yêu cầu, nội dung của phần sẽ là "No mass readings found.".

saints_of_the_day

Tra cứu các vị thánh được tưởng nhớ trong một ngày nhất định từ Sổ Tử đạo Rôma.

Đầu vào: một phần data với một ngày tuyệt đối, hoặc một phần text được coi là truy vấn ngày:

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

Artifact: name: "martyrology" với một phần text duy nhất chứa mục tử đạo đã được định dạng. Những ngày không có dữ liệu sẽ trả về "No martyrology data found.".