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-ով։ Յուրաքանչյուր artifact ունի եզակի artifactId, հմտությանը հատուկ name և մեկ կամ ավելի parts (text, data կամ file)։

catholic_qa

Բնական լեզվով հարց տվեք և ստացեք մեջբերումներով երկար ձևով պատասխան։ Սա ամենահզոր (և ամենաշատ ռեսուրս պահանջող) հմտությունն է — այն աշխատում է նույն մոդելի վրա, որն ուժեղացնում է magisterium.com-ը։

Մուտք. մեկ տեքստային part՝ հարցով։

Artifact. name: "catholic_qa_response", որը պարունակում է.

• text part՝ ամբողջ պատասխանով։
• data part՝ citations-ով (երբ օգտագործվել են որևէ աղբյուրներ)։
• data part՝ related_questions-ով (երբ մոդելը վերադարձնում է առաջարկներ)։

{
  "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-ի գիտելիքների բազայի նկատմամբ սեմանտիկ հարցումին։

Մուտք. մեկ տեքստային part՝ հարցումով։

Artifact. name: "search_results", մեկ data part-ով.

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

Արդյունքից օգտագործեք id դաշտը՝ document_fetch-ը կանչելու համար՝ ամբողջական տեքստը ստանալու նպատակով։

document_fetch

Ստացեք փաստաթղթի ամբողջական տեքստը և մետատվյալները իր ID-ով։ Այս հմտությունը տեքստային part-ի փոխարեն ընդունում է data part.

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

Եթե կանչողը ուղարկում է տեքստային part, ապա մշակիչը նահանջում է՝ այն դիտարկելով որպես փաստաթղթի ID։

Artifact. name: "document", երկու part-ով.

• text part՝ փաստաթղթի մարմինով։
• data part՝ { id, title, author, ref }-ով։

Եթե փաստաթուղթը չի գտնվում, artifact-ը պարունակում է մեկ text part՝ "Document not found." բովանդակությամբ։

liturgical_readings

Ստացեք կաթոլիկ Պատարագի ընթերցումները տվյալ ամսաթվի համար։ Ընդունում է բնական լեզվով ամսաթվի հարցում — օրինակ՝ «today», «next Sunday» կամ «Easter Sunday 2026»։

Մուտք. մեկ տեքստային part՝ ամսաթվի հարցումով։

Artifact. name: "mass_readings", մեկ text part-ով, որը պարունակում է ձևավորված ընթերցումները։ Եթե պահանջված ամսաթվի համար ընթերցումներ առկա չեն, part-ի բովանդակությունն է "No mass readings found."։

saints_of_the_day

Փնտրեք տվյալ ամսաթվին հիշատակվող սրբերին Հռոմեական Մարտիրոլոգիումից։

Մուտք. data part՝ բացարձակ ամսաթվով, կամ որպես ամսաթվի հարցում դիտարկվող տեքստային part.

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

Artifact. name: "martyrology", մեկ text part-ով, որը պարունակում է ձևավորված մարտիրոլոգիումի գրառումը։ Բացակայող ամսաթվերը վերադարձնում են "No martyrology data found."։

Ստորև բերված հինգ հմտությունները գրացուցակային որոնումներ են։ Յուրաքանչյուրն ընդունում է բնական լեզվով query (որպես տեքստային part կամ data.query դաշտ), ինչպես նաև ընտրովի կանոնական ID, և վերադարձնում է կառուցվածքավորված պրոֆիլ մեկ data part-ի ներսում։ Եթե ոչ query-ն, ոչ էլ կանոնական ID-ն չեն տրամադրված, հարցումը մերժվում է INVALID_PARAMS (-32602) սխալով։

Երբ հարցումը հնարավոր չէ լուծել, artifact-ը պրոֆիլի փոխարեն պարունակում է { "error": "not_found", "query": "...", "hint"?: "..." } տիպի data part։ Առաջադրանքն ինքնին դեռևս հաջողությամբ ավարտվում է — not_found-ը նորմալ որոնման արդյունք է, ոչ թե արձանագրության սխալ։

saint_lookup

Փնտրել սուրբ, երանելի, արժանապատիվ կամ Աստծու ծառա cd_saints գրացուցակից (~12,500 ֆիգուր)։

Մուտք. data.query (օրինակ՝ "Therese of Lisieux") կամ data.saint_id (կանոնական առաջնային բանալի, օրինակ՝ "jerome")։ Մերկ տեքստային part-ն ընդունվում է որպես query։

{
  "parts": [{ "kind": "data", "data": { "query": "Catherine of Siena" } }]
}

Artifact. name: "saint_profile", մեկ data part-ով, որը պարունակում է կանոնական պրոֆիլը՝ 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 (կանոնական առաջնային բանալի)։ Մերկ տեքստային part-ն ընդունվում է որպես query։

{
  "parts": [{ "kind": "data", "data": { "query": "Cardinal Tagle" } }]
}

Artifact. name: "person_profile", մեկ data part-ով, որը պարունակում է կանոնական պրոֆիլը՝ 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")։ Մերկ տեքստային part-ն ընդունվում է որպես query։

{
  "parts": [{ "kind": "data", "data": { "query": "John Paul II" } }]
}

Artifact. name: "pope_profile", մեկ data part-ով, որը պարունակում է կանոնական պապական պրոֆիլը՝ 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")։ Մերկ տեքստային part-ն ընդունվում է որպես query։

{
  "parts": [{ "kind": "data", "data": { "query": "Archdiocese of Manila" } }]
}

Artifact. name: "diocese_profile", մեկ data part-ով, որը պարունակում է գրացուցակային մետատվյալներ (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
    }
  }]
}

Artifact. name: "diocese_statistics_time_series", մեկ data part-ով, որը պարունակում է 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։