NeboAI
NeboAI
ابدأ الآن

القدرات والموافقات

القدرة تسمّي نوعًا من الأنظمة، مثل البريد أو دفتر الحسابات، والعمليات عليه. تصرّح حزم الموظفين بالقدرات التي تحتاج إليها، وتصرّح الإضافات بالقدرات التي توفّرها، ويربط المالك بين الاثنين عند التوظيف. الموافقات مرتبطة بالعمليات، لذا تنطبق القواعد نفسها أيًّا كان النظام الذي يؤدي القدرة.

النموذج

  • القدرة واجهة محددة النوع، وليست منتجًا أبدًا. للقدرة mail العمليات mail.inbox.read وmail.inbox.search وmail.message.send.
  • تسرد حزمة الموظف القدرات التي يحتاج إليها دورها في requires.interfaces.
  • توفّر الإضافة قدرةً بربط عملياتها بأوامرها الخاصة في interfaceBindings.
  • الاتصال هو الإضافة التي ربطها المالك لتلك القدرة. ومُشغِّل المراقبة الذي يسمّي قدرة يعمل عليها.

صرّح بما يحتاج إليه الدور

{
  "requires": { "interfaces": ["mail", "ledger"] },
  "ceiling": { "ledger.bill.create": "approval" }
}

سمِّ القدرات لا الإضافات. حزمة الموظف التي تتطلب ledger تعمل لكل شركة، أيًّا كان نظام المحاسبة الذي تستخدمه. استخدم requires.plugins فقط عندما يعتمد الدور فعلًا على إضافة محددة واحدة.

وفّر قدرة

"interfaceBindings": {
  "mail.inbox.read": "messages list --folder inbox",
  "mail.inbox.search": "messages search --query {query}",
  "mail.message.send": "messages send"
}

الإضافة التي تربط أي عملية mail.* توفّر mail. ويصبح كل ربط أيضًا أداة محددة النوع للموظفين، مثل mail_message_send. صيغة القوالب موجودة في مرجع plugin.json.

عندما يراقب سير عمل قدرةً، يختار Nebo الإضافة المثبّتة التي توفّرها، مفضّلًا إضافة لهذا الموظف حساب عليها، ثم بالترتيب الأبجدي. وإن لم توجد أي إضافة، يُحتفظ بسير العمل ويُعلَّم بأنه متراجع، ويُبلَّغ المالك بما يجب ربطه.

الكتالوج

يأتي Nebo مع كتالوج للقدرات وعملياتها، منها ledger وmail وsms وtelephony وcalendar وdrive وhelpdesk وkb وdeals وesign وtimebilling وprojects وcms وsocial وads وreviews وemail-marketing وrepo وci وdeploy وmonitoring وincidents. الكتالوج مفردات مشتركة لا سياج. استخدم مصطلحاته حيثما يناسب أحدها ليلتقي الموظفون والإضافات من ناشرين مختلفين، فالمصطلح الجديد مسألة عُرف لا خطأ.

تحمل كل عملية واحدة من ثلاث علامات.

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

الموافقة عند التوظيف

عندما يوظّف مالكٌ موظفًا، يقرأ Nebo احتياجاته من الحزمة: القدرات في requires.interfaces، والإضافات في requires.plugins، وكل قدرة أو إضافة يسمّيها مُشغِّل مراقبة. يرى المالك جملة واحدة تذكر تلك الاحتياجات. والتوظيف يمنحها لذلك الموظف كأذونات دائمة. وتبقى العمليات الخاضعة للموافقة بنودًا للموافقة.

تثبيت إضافة أو خادم MCP أو تطبيق أو مهارة هو بحد ذاته منح لإذن استخدامها، ولا تُفعَّل هذه واحدًا واحدًا. أما القدرات المدمجة في Nebo نفسه فمجمّعة في chat وfile وshell وweb وcontacts وdesktop وmedia وsystem.

الحدود والقوانين

مكان التصريحالأثر
ceiling في agent.jsonالعمليات المدرجة تسأل المالك دائمًا بالنسبة لهذا الموظف. والقيمة الوحيدة هي "approval".
ceiling الخاص بقانون في طبقة الشركةالعمليات المدرجة محظورة على كل موظف.
قانون للشركة مع reserved_to: ownerالعمليات المدرجة تحتاج إلى موافقة المالك نفسه، ولا يمكن أبدًا منح تلك الموافقة لموظف.

أوضاع الأذونات

لكل موظف وضع أذونات. يحسم الاستدعاءات التي لا تحسمها أي قاعدة، ويمكن للمالك تجاوزه لتشغيل واحد.

الوضعالسلوك
automaticالوضع الافتراضي. يتصرّف الموظف ضمن وظيفته ولا يسأل إلا عن العمليات الخاضعة للموافقة وقواعد السؤال التي وضعها المالك.
askكل استدعاء يغيّر شيئًا يسأل، ما لم تشمله قاعدة سماح.
planالقراءة والتخطيط فقط. لا يعمل أي استدعاء يغيّر شيئًا.
full_accessلا شيء يسأل. وتبقى قواعد الرفض والحدود الصارمة سارية.

يتحقق Nebo من كل إجراء بالترتيب نفسه: الحدود الصارمة أولًا، ثم الحدود والقوانين، ثم قواعد المالك، ثم الوضع. ولا تُرفع الحدود الصارمة أبدًا، مثل حماية بيانات الاعتماد من التسرّب، ولا حتى في full_access.