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." തിരികെ നൽകുന്നു.