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

பதில்கள் எப்போதும் status.state: "completed" மற்றும் ஒன்று அல்லது அதற்கு மேற்பட்ட artifacts-உடன் Task (kind: "task") ஆக திரும்புகின்றன. ஒவ்வொரு ஆர்டிஃபேக்ட்டிற்கும் தனித்துவமான 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 அறிவுத்தளத்திற்கு எதிராக ஒரு சொற்பொருள் வினவலுடன் பொருந்தும் ஆவண குறிப்புகளைப் பெறவும்.

உள்ளீடு: வினவலுடன் ஒற்றை உரை பகுதி.

ஆர்டிஃபேக்ட்: ஒற்றை data பகுதியுடன் name: "search_results":

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

முழு உரைக்காக document_fetch-ஐ அழைக்க முடிவிலிருந்து id புலத்தைப் பயன்படுத்தவும்.

document_fetch

ஒரு ஆவணத்தின் முழு உரை மற்றும் metadata-வை அதன் ID மூலம் மீட்டெடுக்கவும். இந்த திறன் உரை பகுதிக்கு பதிலாக data பகுதியை ஏற்கிறது:

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

அழைப்பாளர் ஒரு உரை பகுதியை அனுப்பினால், ஹேண்ட்லர் அதை ஆவண ID ஆக கருதி திரும்புகிறது.

ஆர்டிஃபேக்ட்: இரண்டு பகுதிகளுடன் name: "document":

• ஆவண உடலை உள்ளடக்கிய ஒரு text பகுதி.
• { id, title, author, ref } உடன் ஒரு data பகுதி.

ஆவணம் கண்டுபிடிக்கப்படவில்லை என்றால், ஆர்டிஃபேக்ட் "Document not found." என வாசிக்கும் ஒற்றை text பகுதியைக் கொண்டிருக்கிறது.

liturgical_readings

கொடுக்கப்பட்ட தேதிக்கு கத்தோலிக்க திருப்பலி வாசிப்புகளைப் பெறுங்கள். ஒரு இயற்கை-மொழி தேதி வினவலை ஏற்கிறது — எ.கா., "today", "next Sunday", அல்லது "Easter Sunday 2026".

உள்ளீடு: தேதி வினவலுடன் ஒற்றை உரை பகுதி.

ஆர்டிஃபேக்ட்: வடிவமைக்கப்பட்ட வாசிப்புகளைக் கொண்ட ஒற்றை text பகுதியுடன் name: "mass_readings". கோரப்பட்ட தேதிக்கு வாசிப்புகள் கிடைக்கவில்லை என்றால், பகுதி "No mass readings found." என வாசிக்கிறது.

saints_of_the_day

ரோமன் மார்டிரோலஜியிலிருந்து கொடுக்கப்பட்ட தேதியில் நினைவுகூரப்படும் புனிதர்களைத் தேடுங்கள்.

உள்ளீடு: ஒரு முழுமையான தேதியுடன் data பகுதி, அல்லது தேதி வினவலாகக் கருதப்படும் ஒரு உரை பகுதி:

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

ஆர்டிஃபேக்ட்: வடிவமைக்கப்பட்ட மார்டிரோலஜி பதிவைக் கொண்ட ஒற்றை text பகுதியுடன் name: "martyrology". காணாமல் போன தேதிகள் "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.