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