Magisterium AI, A2A protokolü üzerinden aşağıdaki yetenekleri sunar. Kullanılacak yeteneği mesajdaki metadata.skillId aracılığıyla belirtin. skillId atlanırsa varsayılan olarak catholic_qa kullanılır.

Tüm yetenekler message/send JSON-RPC yöntemi aracılığıyla çağrılır.

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

Yanıtlar her zaman status.state: "completed" olan bir Task (kind: "task") olarak ve bir veya daha fazla artifacts ile geri gelir. Her artifact, benzersiz bir artifactId, yeteneğe özgü bir name ve bir ya da daha fazla parts (text, data veya file) içerir.

catholic_qa

Doğal dilde bir soru sorun ve alıntılı, uzun bir yanıt alın. Bu, en yetenekli (ve en kaynak-yoğun) yetenektir — magisterium.com'u çalıştıran aynı model üzerinde çalışır.

Girdi: soruyu içeren tek bir text part.

Artifact: name: "catholic_qa_response", şunları içerir:

• Tam yanıtı içeren bir text part.
• citations içeren bir data part (herhangi bir kaynak kullanıldığında).
• related_questions içeren bir data part (model öneri döndürdüğünde).

{
  "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, diğer yeteneklere göre daha sıkı bir hız limiti varyantı kullanır. API Referansı → Hız Limitleri bölümüne bakın.

document_search

Magisterium bilgi tabanına karşı bir anlamsal sorguya uyan belge referanslarını getirin.

Girdi: sorguyu içeren tek bir text part.

Artifact: name: "search_results", tek bir data part ile:

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

Tam metni almak için sonuçtaki id alanını kullanarak document_fetch'i çağırın.

document_fetch

Bir belgenin tam metnini ve meta verilerini ID'sine göre getirin. Bu yetenek text part yerine bir data part kabul eder:

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

Çağıran bir text part gönderirse, işleyici bunu belge ID'si olarak ele almaya geri döner.

Artifact: name: "document", iki part ile:

• Belge gövdesini içeren bir text part.
• { id, title, author, ref } içeren bir data part.

Belge bulunamazsa, artifact "Document not found." içeriğine sahip tek bir text part içerir.

liturgical_readings

Belirli bir tarih için Katolik Ayini okumalarını edinin. Doğal dil tarih sorgusunu kabul eder — ör. "today", "next Sunday" veya "Easter Sunday 2026".

Girdi: tarih sorgusunu içeren tek bir text part.

Artifact: name: "mass_readings", biçimlendirilmiş okumaları içeren tek bir text part ile. İstenen tarih için okuma yoksa, part "No mass readings found." içeriğine sahip olur.

saints_of_the_day

Roma Martirolojisi'nden belirli bir tarihte anılan azizleri arayın.

Girdi: mutlak tarihe sahip bir data part veya tarih sorgusu olarak ele alınan bir text part:

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

Artifact: name: "martyrology", biçimlendirilmiş martiroloji kaydını içeren tek bir text part ile. Eksik tarihler "No martyrology data found." döndürür.