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." என திருப்பித் தருகின்றன.