الحوكمة
تحكَّم بدقة فيما يستطيع وكيلك فعله ومَن يمكنه استخدام كل أداة: تفعيل القدرات واعتمادها، والإتاحة لكل مستخدم، والإجراءات التي تسجّلها أداتك على الصفحة.
الحوكمة هي حيث تقرر ما يُسمح للوكيل بفعله. تعمل ثلاثة أسطح معًا: حوكمة القدرات لقدرات واجهتك البرمجية، وإتاحة الأدوات لتحديد مَن يستطيع استخدام كل أداة، والإمكانات للإجراءات التي تسجّلها أداتك المضمَّنة على صفحتك.
حوكمة القدرات
تسرد حوكمة القدرات (/governance) كل قدرة اكتشفتها أداة سطر الأوامر. يحمل كل صف شارة أثر جانبي ومفتاحَي تبديل مستقلَّين.
- مفعَّلة — هل تُعلَن القدرة للوكيل ويمكنه استدعاؤها. إيقافها يعني أنها غير مرئية.
- تتطلب اعتمادًا — تفرض خطوة تأكيد قبل تشغيل القدرة. وتفعيل الاعتماد لا يفعّل قدرةً معطَّلة أبدًا؛ فالمفتا حان مستقلان.
- شارة الأثر الجانبي — قراءة أو كتابة أو تدميري، لترى بلمحة أي القدرات يغيّر البيانات.
إتاحة الأدوات
تقرر إتاحة الأدوات (/tool-availability) أي الأدوات يعرضها سطحا الدردشة وMCP لكل مستخدم نهائي. كل أداة متاحة افتراضيًا وواجهتك البرمجية هي التي تفرض الأذونات؛ أضف قاعدة لتوجيه أداة إلى مستخدمين محدّدين. وتُطابق القواعد على الهوية لا على الوقت — لا جدولة هنا.
- اشتراط تسجيل الدخول — اعرض الأداة للمستخدمين الموثَّقين فقط.
- النطاقات المطلوبة — قيّد الأداة بنطاقات OAuth، بمطابقة الكل أو أيٍّ منها.
- مُطابِقات السمات — استهدف ادعاء هوية أو سمة من سياق المضيف بعامل مقارنة وقيمة.
- قواعد متقدمة — لمنطق لا يستطيع النموذج البسيط التعبير عنه، حرِّر القاعدة بصيغة JSON بتعبيرات and/or/not.
الإمكانات
تحكم الإمكانات (/abilities) الإجراءات التي تسجّلها أداتك المضمَّنة على صفحتك عبر syncanix.registerAction — إجراءات من جانب العميل مثل تحديث قائمة. وهي متمايزة عن قدرات الكتالوج، التي هي نقاط نهاية واجهتك البرمجية.
- مفتاح الإيقاف الشامل — مفتاح رئيسي يمنع الوكيل من تنفيذ أي إجراء مسجَّل، بصرف النظر عن مفاتيح كل إمكانية.
- مفتاح «نشطة» لكل إمكانية — الإمكانية غير النشطة لا يُعلَن عنها للوكيل أبدًا ولا يمكن استدعاؤها.
- التأكيد — يمكن أن تشترط الإمكانية تأكيد المستخدم النهائي قبل تشغيلها. ويمكنك أيضًا إعلان إمكانية قبل أن تسجّلها الأداة.