يعرض الماجستير المهارات التالية عبر بروتوكول 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 مع الإجابة الكاملة.
• جزء data مع citations (عند استخدام أي مصادر).
• جزء data مع 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

استرداد مراجع الوثائق التي تطابق استعلاماً دلالياً مقابل قاعدة معرفة الماجستير.

الإدخال: جزء نصي واحد يحتوي على الاستعلام.

الأثر: name: "search_results" مع جزء data واحد:

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

استخدم الحقل id من النتيجة لاستدعاء document_fetch للحصول على النص الكامل.

document_fetch

استرجع النص الكامل وبيانات التعريف لوثيقة بواسطة معرفها. تقبل هذه المهارة جزء data بدلاً من جزء نصي:

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

إذا أرسل المستدعي جزءاً نصياً، فإن المعالج يعود إلى التعامل معه كمعرف وثيقة.

الأثر: name: "document" مع جزأين:

• جزء text يحتوي على نص الوثيقة.
• جزء data مع { id, title, author, ref }.

إذا لم يتم العثور على الوثيقة، يحتوي الأثر على جزء text واحد يقرأ "Document not found.".

liturgical_readings

احصل على قراءات القداس الكاثوليكي لتاريخ معين. يقبل استعلام تاريخ بلغة طبيعية — مثل "today" أو "next Sunday" أو "Easter Sunday 2026".

الإدخال: جزء نصي واحد مع استعلام التاريخ.

الأثر: name: "mass_readings" مع جزء text واحد يحتوي على القراءات المنسقة. إذا لم تكن هناك قراءات متاحة للتاريخ المطلوب، يقرأ الجزء "No mass readings found.".

saints_of_the_day

ابحث عن القديسين الذين يتم إحياء ذكراهم في تاريخ معين من الشهادات الرومانية.

الإدخال: جزء data مع تاريخ مطلق، أو جزء نصي يُعامل كاستعلام تاريخ:

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

الأثر: name: "martyrology" مع جزء text واحد يحتوي على إدخال الشهادات المنسق. تُرجع التواريخ المفقودة "No martyrology data found.".