كتالوج القدرات
القائمة المنظَّمة بما تستطيع واجهة برمجة التطبيقات لديك القيام به — تُكتشَف مرة واحدة، وتحرّرها أنت، وتقرؤها كل الواجهات.
كتالوج القدرات هو قلب Syncanix. إنه وصف منظَّم لكل ما يستطيع منتجك القيام به، يُكتشَف من واجهة برمجة التطبيقات لديك وتصقله أنت. وتقرأ كل الواجهات — الأداة وال دردشة وخادم MCP — من هذا الكتالوج الواحد، فيبقى ما يستطيع مساعدك فعله متسقًا في كل مكان ويُحرَّر في موضع واحد.
ما هي القدرة
القدرة شيء واحد تستطيع واجهة برمجة التطبيقات لديك القيام به: نقطة نهاية أو إجراء، مثل «الاستعلام عن طلب» أو «ردّ مبلغ دفعة». وكل قدرة موصوفة بما يكفي كي يفهم المساعد ما تفعله وما تحتاجه ومتى يستخدمها.
ما الذي تحمله كل قدرة
- المعرّف
- معرّف ثابت بالصيغة domain.action (مثل orders.refund)، يُستخدَم في كل مكان يُشار فيه إلى القدرة.
- الطريقة والمسار
- طريقة HTTP والمسار اللذان تنطبق عليهما القدرة (مثل POST /orders/{id}/refund).
- المدخلات
- الوسائط التي يقبلها الإجراء، بأسمائها وأنواعها — لا قيم أمثلة من بياناتك أبدًا.
- الوصف
- ملخّص بلغة واضحة لما يفعله الإجراء. وهو ما يقرؤه المساعد ليقرّر هل يستخدمه ومتى.
- الأثر
- هل يقرأ الإجراء أم يكتب أم أنه مدمِّر — وهو ما يحدّد كيفية تأكيده قبل تنفيذه.
- الخطورة
- مستوى خطورة يتيح لك معاملة بعض الإجراءات بحذر أكبر مما قد يوحي به أثرها وحده.
- الصلاحيات المطلوبة
- الصلاحيات (scopes) التي يجب أن يملكها المستخدم كي يُعرَض عليه الإجراء أصلًا.
- علامة «داخلي»
- تحدِّد قدرة بوصفها داخلية كي تبقى بعيدة عن متناول المساعد مع بقائها في كتالوجك.
- علامات البيانات الشخصية
- تحدِّد المدخلات أو المخرجات التي تحتوي على بيانات شخصية، كي تُعالَج وتُحجَب على النحو المناسب.
يُكتشَف ثم يُحرَّر
يقترح الاكتشاف الكتالوج بقراءة شيفرتك قراءةً ثابتة. ومن هناك تتولّى أنت تحريره: إعادة تسمية القدرات، وصقل الأوصاف، وضبط الآثار والخطورة، ووسم نقاط النهاية بأنها داخلية، وتعديل الصلاحيات المطلوبة — كل ذلك في لوحة التحكم. وتُحفَظ تعديلاتك بوصفها تجاوزات، فتبقى بعد عملية الاكتشاف التالية.
مصدر واحد للحقيقة
لأن الأداة وواجهة الدردشة وخادم MCP تقرأ جميعها من الكتالوج نفسه، فإنك تحدّد ما يستطيع المساعد فعله مرة واحدة. غيّر قدرة في لوحة التحكم وتعكسها كل الواجهات.