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 होते हैं। प्रत्येक कलाकृति में एक अद्वितीय artifactId, एक कौशल-विशिष्ट name, और एक या अधिक parts (text, data, या file) होते हैं।

catholic_qa

एक प्राकृतिक-भाषा प्रश्न पूछें और एक उद्धृत, लंबे रूप का उत्तर प्राप्त करें। यह सबसे सक्षम (और सबसे संसाधन-गहन) कौशल है — यह उसी मॉडल पर चलता है जो magisterium.com को शक्ति प्रदान करता है।

इनपुट: प्रश्न के साथ एक ही टेक्स्ट भाग।

कलाकृति: name: "catholic_qa_response" जिसमें निम्न होता है:

• पूरे उत्तर के साथ एक text भाग।
• citations के साथ एक data भाग (जब कोई स्रोत उपयोग किए गए थे)।
• related_questions के साथ एक data भाग (जब मॉडल सुझाव लौटाता है)।

{
  "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 ज्ञानकोष के विरुद्ध एक अर्थपूर्ण क्वेरी से मेल खाने वाले दस्तावेज़ संदर्भ प्राप्त करें।

इनपुट: क्वेरी के साथ एक ही टेक्स्ट भाग।

कलाकृति: name: "search_results" एक data भाग के साथ:

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

पूर्ण पाठ के लिए document_fetch को कॉल करने के लिए परिणाम से id फ़ील्ड का उपयोग करें।

document_fetch

किसी दस्तावेज़ का पूर्ण पाठ और मेटाडेटा उसके ID द्वारा पुनः प्राप्त करें। यह कौशल टेक्स्ट भाग के बजाय एक data भाग स्वीकार करता है:

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

यदि कॉलर एक टेक्स्ट भाग भेजता है, तो हैंडलर इसे दस्तावेज़ ID के रूप में मानने के लिए वापस आता है।

कलाकृति: name: "document" दो भागों के साथ:

• दस्तावेज़ के मुख्य भाग वाला एक text भाग।
• { id, title, author, ref } के साथ एक data भाग।

यदि दस्तावेज़ नहीं मिला, तो कलाकृति में एक ही text भाग होता है जो "Document not found." पढ़ता है।

liturgical_readings

किसी दिए गए दिनांक के लिए कैथोलिक मास पाठ प्राप्त करें। एक प्राकृतिक-भाषा दिनांक क्वेरी स्वीकार करता है — जैसे "today", "next Sunday", या "Easter Sunday 2026"।

इनपुट: दिनांक क्वेरी के साथ एक ही टेक्स्ट भाग।

कलाकृति: name: "mass_readings" एक ही text भाग के साथ जिसमें स्वरूपित पाठ होते हैं। यदि अनुरोधित दिनांक के लिए कोई पाठ उपलब्ध नहीं है, तो भाग "No mass readings found." पढ़ता है।

saints_of_the_day

रोमन मार्टिरोलॉजी से किसी दिए गए दिनांक पर स्मरण किए गए संतों को देखें।

इनपुट: एक data भाग एक पूर्ण दिनांक के साथ, या एक टेक्स्ट भाग जिसे दिनांक क्वेरी के रूप में माना जाता है:

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

कलाकृति: name: "martyrology" एक ही text भाग के साथ जिसमें स्वरूपित मार्टिरोलॉजी प्रविष्टि होती है। गायब दिनांक "No martyrology data found." लौटाते हैं।

नीचे दिए गए पाँच कौशल निर्देशिका खोज हैं। प्रत्येक एक प्राकृतिक-भाषा query (एक टेक्स्ट भाग के रूप में या data.query फ़ील्ड के रूप में) तथा एक वैकल्पिक कैनोनिकल ID स्वीकार करता है, और एक ही data भाग के अंदर एक संरचित प्रोफ़ाइल लौटाता है। यदि न तो query और न ही कोई कैनोनिकल ID प्रदान किया गया है, तो अनुरोध INVALID_PARAMS (-32602) के साथ अस्वीकार कर दिया जाता है।

जब क्वेरी का समाधान नहीं हो पाता, तो कलाकृति में प्रोफ़ाइल के बजाय { "error": "not_found", "query": "...", "hint"?: "..." } प्रारूप का एक data भाग होता है। कार्य स्वयं फिर भी सफलतापूर्वक पूर्ण हो जाता है — not_found एक सामान्य खोज परिणाम है, न कि कोई प्रोटोकॉल त्रुटि।

saint_lookup

cd_saints निर्देशिका (~12,500 हस्तियाँ) से किसी संत, धन्य, परम पूज्य, या ईश्वर के सेवक को खोजें।

इनपुट: data.query (जैसे "Therese of Lisieux") या data.saint_id (कैनोनिकल प्राथमिक कुंजी, जैसे "jerome")। एक खुला टेक्स्ट भाग query के रूप में स्वीकार किया जाता है।

{
  "parts": [{ "kind": "data", "data": { "query": "Catherine of Siena" } }]
}

कलाकृति: एक ही data भाग के साथ name: "saint_profile" जिसमें कैनोनिकल प्रोफ़ाइल होती है — saint_id, primary_name, canonical_status, vocation, image_url, learn_more_url, जीवन एवं मृत्यु, पर्व दिवस, संतीकरण कारण, संरक्षण, मूर्तिकला, जीवनी, और (यदि कई उम्मीदवार पाए गए) एक alternates सरणी।

person_lookup

cd_persons (जीवित, ~3,500) और cd_persons_historical (~2,200) निर्देशिकाओं से किसी कैथोलिक पादरी (बिशप, कार्डिनल, आर्चबिशप, आदि) को खोजें। पोप अलग pope_lookup कौशल के माध्यम से उजागर किए जाते हैं।

इनपुट: data.query (जैसे "Cardinal Tagle") या data.person_id (कैनोनिकल प्राथमिक कुंजी)। एक खुला टेक्स्ट भाग query के रूप में स्वीकार किया जाता है।

{
  "parts": [{ "kind": "data", "data": { "query": "Cardinal Tagle" } }]
}

कलाकृति: एक ही data भाग के साथ name: "person_profile" जिसमें कैनोनिकल प्रोफ़ाइल होती है — person_id, source_table, primary_name, current_position, image_url, coat_of_arms_url, अभिषेक एवं प्रतिष्ठान दिनांक, कार्डिनल पदोन्नति, धर्माध्यक्षीय वंशावली, शिक्षा, आदर्श वाक्य, और कोई alternates।

यदि क्वेरी केवल किसी पोप का समाधान करती है, तो प्रतिक्रिया { "error": "not_found", "hint": "Top match looks like a pope; try get_pope." } होती है।

pope_lookup

cd_popes निर्देशिका (267 हस्तियाँ) से किसी पोप को खोजें।

इनपुट: data.query (जैसे "Pope Francis", "John Paul II") या data.pope_id (कैनोनिकल प्राथमिक कुंजी, जैसे "benedict-xvi")। एक खुला टेक्स्ट भाग query के रूप में स्वीकार किया जाता है।

{
  "parts": [{ "kind": "data", "data": { "query": "John Paul II" } }]
}

कलाकृति: एक ही data भाग के साथ name: "pope_profile" जिसमें कैनोनिकल पोप प्रोफ़ाइल होती है — pope_id, primary_name, papal_name, ordinal, pope_title, image_url, coat_of_arms_url, birth_name, origin, pontificate, धन्यीकरण एवं संतीकरण स्थिति, और कोई alternates।

यदि क्वेरी केवल किसी गैर-पोप पादरी सदस्य का समाधान करती है, तो प्रतिक्रिया { "error": "not_found", "hint": "Top match looks like a non-pope clergy member; try get_person." } होती है।

diocese_lookup

धर्मप्रांत निर्देशिका (~3,200 क्षेत्राधिकार विश्व भर में) से किसी कलीसियाई क्षेत्राधिकार (धर्मप्रांत, आर्चडायोसिस, एपार्की, आदि) को खोजें।

इनपुट: data.query (जैसे "Archdiocese of Manila") या data.source_code (कैनोनिकल प्राथमिक कुंजी, जैसे "dmaml")। एक खुला टेक्स्ट भाग query के रूप में स्वीकार किया जाता है।

{
  "parts": [{ "kind": "data", "data": { "query": "Archdiocese of Manila" } }]
}

कलाकृति: एक ही data भाग के साथ name: "diocese_profile" जिसमें निर्देशिका मेटाडेटा (source_code, primary_name, jurisdiction_type, rite, country, region_primary, state, city, metropolitan, depends_on, province, cathedral, patron_saint, area, erected, elevated, official_website, image_url, current_bishop) के साथ-साथ:

• recent_statistics — मुख्य आँकड़ों के 5 वर्षों तक (कैथोलिक, कुल जनसंख्या, कैथोलिक प्रतिशत, कुल पुरोहित, परगने, बपतिस्मा, सेमिनेरियन)।
• latest_financials — उपलब्ध होने पर सबसे हाल के वित्तीय वर्ष के मुख्य मेट्रिक्स (कुल राजस्व, कुल व्यय, शुद्ध संपत्ति, कुल संपत्ति, अधिशेष/घाटा), मुद्रा के साथ।
• alternates — जब कई उम्मीदवार मिले।

बहु-वर्षीय रुझान विश्लेषण के लिए, इसके बजाय diocese_statistics_lookup का उपयोग करें।

diocese_statistics_lookup

किसी धर्मप्रांत के लिए पूर्ण वार्षिक आँकड़े समय-श्रृंखला लौटाएँ — diocese_statistics में ट्रैक किए गए सभी 19 मेट्रिक्स।

इनपुट: data.query या data.source_code (एक आवश्यक है), साथ ही वैकल्पिक समावेशी सीमाएँ:

{
  "parts": [{
    "kind": "data",
    "data": {
      "source_code": "dmaml",
      "start_year": 2010,
      "end_year": 2024
    }
  }]
}

कलाकृति: एक ही data भाग के साथ name: "diocese_statistics_time_series" जिसमें source_code, diocese_name, year_range: { start, end }, और एक rows सरणी होती है। प्रत्येक पंक्ति एक वर्ष के लिए 19 मेट्रिक्स रखती है: catholics, total_population, percent_catholic, diocesan_priests, religious_priests, total_priests, catholics_per_priest, permanent_deacons, male_religious, female_religious, parishes, area_km2, churches_or_stations, diocesan_priests_ordained, religious_priests_ordained, seminarians, educational_institutes, charitable_institutes, baptisms।