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-क शक्ती दिवपी त्याच मॉडेलाच्या आदारान चलता.

Input: प्रस्नासयत एक फकत text भाग.

Artifact: 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 हेरांपरस कडक rate-limit variant वापरता. API संदर्भ → रेट सीमा पळयात.

document_search

Magisterium ज्ञानभांडारा आड अर्थपूर्ण query-शीं जुळणारे दस्तऐवज संदर्भ मेळयात.

Input: query सयत एक फकत text भाग.

Artifact: एका data भागासयत name: "search_results":

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

पुराय मजकुराखातीर document_fetch कॉल करूंक निकालांतलो id field वापरात.

document_fetch

एका दस्तऐवजाचो पुराय मजकूर आनी metadata त्याच्या ID वरवीं मेळयात. हें कौशल्य text भागा वांगडा एक data भाग स्वीकारता:

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

जर कॉलर एक text भाग धाडता, तर handler तो दस्तऐवज ID म्हणून मानून fallback करता.

Artifact: दोन भागांसयत name: "document":

• दस्तऐवजाच्या शरीरासयत एक text भाग.
• { id, title, author, ref } सयत एक data भाग.

जर दस्तऐवज सापडनासो, artifact-त एक फकत text भाग आसता जो "Document not found." वाचता.

liturgical_readings

दिल्ल्या तारखेखातीर कॅथलिक मास वाचन मेळयात. एका नैसर्गिक-भाशेच्या तारीख query-क स्वीकारता — जशें "today", "next Sunday", वा "Easter Sunday 2026".

Input: तारीख query सयत एक फकत text भाग.

Artifact: formatted वाचनांसयत एका text भागासयत name: "mass_readings". जर विचारिल्ल्या तारखेखातीर वाचनां उपलब्ध नात, भाग "No mass readings found." वाचता.

saints_of_the_day

रोमन मार्टिरोलॉजी थावन दिल्ल्या तारखेर स्मरण कोरपाचे संत सोदात.

Input: एक निरपेक्ष तारखेसयत एक data भाग, वा तारीख query म्हणून मानिल्लो एक text भाग:

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

Artifact: formatted martyrology नोंदीसयत एका text भागासयत name: "martyrology". नासिल्ल्या तारखांनी "No martyrology data found." परत येता.

सकयलीं पांच कौशल्यां निर्देशिका सोद आसात. दरेक एक नैसर्गिक-भाशेची query (एक text भागा रुपान वा data.query field रुपान) सयत एक वैकल्पिक कॅनोनिकल ID स्वीकारता, आनी एका फकत data भागाच्या भितर एक रचनात्मक प्रोफायल परत दिता. जर query वा कॅनोनिकल ID कोणयूच दिल्लो ना, तर विनंती INVALID_PARAMS (-32602) सयत न्हयकारतात.

जेन्ना query-चें निराकरण जावंक शकना, तेन्ना artifact-त एका प्रोफायलाच्या बदलाक { "error": "not_found", "query": "...", "hint"?: "..." } रुपाचो एक data भाग आसता. कार्य स्वतः अजूनय यशस्वी रित्यान पूर्ण जाता — not_found एक सामान्य सोदा निकाल, प्रोटोकॉल चूक न्हय.

saint_lookup

cd_saints निर्देशिका थावन (~12,500 व्यक्तिमत्त्वां) एका संताक, धन्य, परमपूज्य, वा देवाच्या सेवकाक सोदात.

Input: data.query (जशें "Therese of Lisieux") वा data.saint_id (कॅनोनिकल मुखेल चावी, जशें "jerome"). एक सादो text भाग query म्हणून स्वीकारतात.

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

Artifact: एका फकत 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 कौशल्याच्या मार्गान उदक करतात.

Input: data.query (जशें "Cardinal Tagle") वा data.person_id (कॅनोनिकल मुखेल चावी). एक सादो text भाग query म्हणून स्वीकारतात.

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

Artifact: एका फकत data भागासयत name: "person_profile", जातूंत कॅनोनिकल प्रोफायल आसा — person_id, source_table, primary_name, current_position, image_url, coat_of_arms_url, अभिषेक आनी प्रतिष्ठापन तारखो, कार्डिनल पदोन्नती, धर्माध्यक्ष वंशावळ, शिक्षण, ब्रीदवाक्य, आनी कांय alternates.

जर query फकत एका पोपाचें निराकरण करता, तर प्रतिसाद { "error": "not_found", "hint": "Top match looks like a pope; try get_pope." } आसता.

pope_lookup

cd_popes निर्देशिका थावन (267 व्यक्तिमत्त्वां) एका पोपाक सोदात.

Input: data.query (जशें "Pope Francis", "John Paul II") वा data.pope_id (कॅनोनिकल मुखेल चावी, जशें "benedict-xvi"). एक सादो text भाग query म्हणून स्वीकारतात.

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

Artifact: एका फकत data भागासयत name: "pope_profile", जातूंत कॅनोनिकल पोप प्रोफायल आसा — pope_id, primary_name, papal_name, ordinal, pope_title, image_url, coat_of_arms_url, birth_name, origin, pontificate, धन्यीकरण आनी संतपण स्थिती, आनी कांय alternates.

जर query फकत एका पोप-न्हय धर्मगुरू सदस्याचें निराकरण करता, तर प्रतिसाद { "error": "not_found", "hint": "Top match looks like a non-pope clergy member; try get_person." } आसता.

diocese_lookup

धर्मप्रांत निर्देशिका थावन (~3,200 जागतीक अधिकारक्षेत्रां) एक धर्मसभीय अधिकारक्षेत्र (धर्मप्रांत, आर्चडायोसिस, एपार्की, हेर) सोदात.

Input: data.query (जशें "Archdiocese of Manila") वा data.source_code (कॅनोनिकल मुखेल चावी, जशें "dmaml"). एक सादो text भाग query म्हणून स्वीकारतात.

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

Artifact: एका फकत data भागासयत name: "diocese_profile", जातूंत निर्देशिका metadata (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 मेट्रिक्स.

Input: data.query वा data.source_code (एक गरजेचो), सयत वैकल्पिक समावेशक सीमा:

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

Artifact: एका फकत 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.