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 থাকে। প্রতিটি আর্টিফ্যাক্টের একটি অনন্য 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

একটি নথির সম্পূর্ণ পাঠ্য এবং মেটাডেটা তার 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.