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", അതിൽ ഡയറക്ടറി 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 മെട്രിക്കുകളും.

ഇൻപുട്ട്: 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.