إدارة الوكلاء المخصَّصين (Custom Agents) باستخدام واجهة برمجة تطبيقات المسؤول (Admin API)

إذا كنت مسؤولاً في الخطة المؤسسية (Enterprise Plan)، فيمكنك إدارة الوكلاء المخصَّصين في مساحة عملك باستخدام واجهة برمجة تطبيقات المسؤول (Admin API). بدلاً من النقر عبر الإعدادات لوكيل واحد في كل مرة، يمكن لفريقك سحب معلومات الوكيل والاستخدام إلى أدواتك الخاصة وتطبيق نفس القواعد عبر العديد من الوكلاء في وقت واحد. تتوفر واجهة برمجة تطبيقات المسؤول (Admin API) فقط لمسؤولي مؤسسات Enterprise الذين يستخدمون رمز مسؤول مملوك للمؤسسة.

• رؤية كل وكيل مخصَّص في مساحة عملك. احصل على قائمة بجميع الوكلاء، بما في ذلك من أنشأ كل واحد منهم، وما إذا كان نشطاً، والنموذج الذي يستخدمه، ومتى تم تشغيله آخر مرة، وما الذي يمكنه الوصول إليه.

• تتبع من لديه حق الوصول إلى وكيل مخصَّص. قم بتحديث أذونات المشاركة الخاصة بالوكيل.

• تتبع استهلاك الرصيد. تعرف على عدد الرصيد الذي استخدمه كل وكيل، وتتبع استهلاك الرصيد بشكل مجمع.

• تعيين حدود الرصيد. قم بتعيين أو تغيير حد الرصيد لوكيل واحد، أو قم بتعيين حد افتراضي لمساحة العمل لجميع الوكلاء المخصَّصين.

• اختر من يمكنه إنشاء الوكلاء. قم بتعيين سياسة إنشاء الوكلاء في مساحة عملك، وأوقف جميع الوكلاء مؤقتاً عبر مساحة العمل إذا كنت بحاجة إلى ذلك.

• إيقاف تشغيل وكيل أو تشغيله. أوقف تشغيل وكيل معين دون حذف إعداده، وقم بتشغيله مرة أخرى لاحقاً.

• حذف وكيل. أزل وكيلاً من الاستخدام. يتم الاحتفاظ بإعداده بحيث يمكن استعادته إذا لزم الأمر.

• يجب أن تكون مساحة العمل الخاصة بك على الخطة المؤسسية.

• تستخدم واجهة برمجة تطبيقات المسؤول (Admin API) صلاحيات وصول المسؤول على مستوى المؤسسة التي تقوم مؤسستك بإعدادها، وليس رموز التكامل الشخصية. للحصول على خطوات الإعداد، راجع وثائق المطورين →

كل ما تقوم به واجهة برمجة تطبيقات المسؤول (Admin API) له عنصر تحكم مطابق في Notion:

• يعرض دليل الوكلاء (الإعدادات → Notion AI → الوكلاء) الوكلاء الموجودين في مساحة عملك ويديرهم.

• تعرض لوحة معلومات رصيد Notion استهلاك الرصيد للوكيل.

• تحدد عناصر تحكم الإنشاء من يمكنه إنشاء الوكلاء.

استخدم الإعدادات لإجراء تغييرات فردية. استخدم واجهة برمجة تطبيقات المسؤول (Admin API) عندما ترغب في أتمتة هذه المهام، أو إدارة العديد من الوكلاء في وقت واحد، أو جلب بيانات الاستخدام إلى أدوات إعداد التقارير الخاصة بك.

• اسحب استهلاك الرصيد إلى التقارير الداخلية، حتى يتمكن كل فريق من معرفة تكلفة الوكلاء المخصَّصين لديه.

• طبّق نفس الحدود أو القواعد على العديد من الوكلاء في وقت واحد.

• انقل ملكية الوكلاء الذين يجب أن يستمروا في العمل. أوقف تشغيل أو أزل الوكلاء الذين لم تعد هناك حاجة إليهم.