NeboAI
NeboAI
ابدأ الآن

حزم الموظفين

تصف حزمة الموظف دورًا يمكن لشركة أن توظّف من يشغله: ما الذي يتولى الموظف مسؤوليته، وكيف يعمل، وما أنواع الأنظمة التي يحتاج إليها، وما الذي يفعله من تلقاء نفسه. تكتبها كمجلد يحتوي على AGENT.md، وعلى agent.json عندما يحتاج الدور إلى أكثر من المحادثة.

الحزمة

support-coordinator/
├── AGENT.md        # required: who the employee is and how it works
├── agent.json      # optional: capabilities, inputs, workflows, memory
└── skills/         # optional: skills only this employee uses
    └── reply-drafting/
        └── SKILL.md
الملفمطلوبالغرض
AGENT.mdنعمالشخصية: من هو الموظف، وكيف يعمل، وقواعده. انظر الشخصية والذاكرة.
agent.jsonلاالقدرات التي يحتاج إليها، والأسئلة الموجّهة إلى المالك، وسير العمل، وإعدادات الذاكرة، وحدود الموافقة. انظر مرجع agent.json.
skills/لامهارات بصيغة SKILL.md القياسية. لا يراها إلا هذا الموظف.
manifest.jsonللتطبيقات فقطالهوية مع "type": "app". يكتب المتجر ملف البيان الخاص به عندما يحزّم موظفًا.
ui/للتطبيقات فقطصفحة التطبيق. انظر التطبيقات.

اكتب حزمة

ابدأ بالشخصية. تسمّي المقدمة الموظف وتقدّم وصفًا من سطر واحد، والمتن تعليمات بنثر بسيط.

---
name: Support Coordinator
description: Answers every customer message the day it arrives and escalates what it cannot settle.
---

# Support Coordinator

You answer customer email for the company. Reply within the configured window,
in the company's voice, and keep every thread moving until the customer has an answer.

## How you work
- Read the whole thread before you reply.
- Use the reply-drafting skill for every customer reply.
- When a message is about money, draft a proposal for the owner instead of promising anything.

## Rules
- Never promise a refund, a discount or a date you cannot confirm.

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

{
  "requires": { "interfaces": ["mail"] },
  "inputs": [
    {
      "key": "reply_window_hours",
      "label": "Reply within (hours)",
      "type": "number",
      "id": "support.reply_window_hours",
      "scope": "company",
      "default": 24
    }
  ],
  "workflows": {
    "new-mail": {
      "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
      "description": "Handle each customer message as it arrives.",
      "activities": [
        {
          "id": "reply",
          "intent": "Read the message in _watch_payload, draft a reply within reply_window_hours, and escalate anything about money to the owner."
        }
      ]
    }
  }
}

تسمّي المراقبة القدرة mail، لا منتجًا بعينه. وعند التشغيل تُحلّ إلى الإضافة التي ربطها المالك للبريد. انظر سير العمل لمعرفة المُشغِّلات والأنشطة.

حمّلها على بوت

ضع المجلد في <data>/user/agents/<name>/. يراقب Nebo الملفات AGENT.md وagent.json وmanifest.json ويعيد تحميل الموظف بعد ثانية تقريبًا من أي تغيير. وإزالة المجلد تعطّل الموظف لكنها تحتفظ بسجلّه.

يحمّل Nebo الموظفين من ثلاثة مصادر، والمصادر اللاحقة لها الأولوية: الموظفون المدمجون في Nebo، وحزم المتجر المختومة في <data>/nebo/agents/، والمجلدات في <data>/user/agents/. ويمكن للموظف أيضًا أن ينشئ حزمة أو يعدّلها لك عبر أداتيه create_employee وupdate_employee، اللتين تكتبان المجلد نفسه.

ما يحدث عند التوظيف

عندما يوظّف مالكٌ موظفك من المتجر أو برمز AGNT-، فإن Nebo:

  1. يقرأ احتياجات الحزمة دون سؤال أي نموذج: كل قدرة في requires.interfaces، وكل إضافة في requires.plugins، وكل قدرة أو إضافة يسمّيها مُشغِّل مراقبة.
  2. يعرض على المالك جملة موافقة واحدة لتلك الاحتياجات، وعند التوظيف يمنحها لهذا الموظف كأذونات دائمة. وتبقى العمليات التي تحتاج إلى موافقة كما هي. انظر القدرات والموافقات.
  3. يثبّت الاعتماديات: الإضافات في requires.plugins، ومهارات المتجر المذكورة في skills وفي الأنشطة، والاعتماديات المصرّح بها عند نشر الحزمة.
  4. يطرح على المالك أسئلة inputs، ويُعلمه عبر البريد الوارد بأي قدرة ليس لها اتصال بعد.

سير العمل الذي لا اتصال لقدرته يُحتفظ به ويُعلَّم بأنه متراجع، مع ذكر السبب. ويبدأ العمل بمجرد أن يربط المالك نظامًا.

ما يتحقق منه Nebo

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

  • مُشغِّل event بقائمة sources فارغة.
  • نشاطان لهما id نفسه في سير عمل واحد.
  • مدخل بقيمة scope غير company أو seat، أو سؤال مالي له قيمة افتراضية.
  • قيمة ceiling غير "approval".
  • شجرة مكالمات هاتفية لا تحتوي على تحية واحدة بالضبط وعلى نية مسمّاة واحدة على الأقل.

بعض الفحوص تعمل عند بدء سير العمل لا عند تحميله، مثل المعاملات التي يتطلبها كل نوع من الأنشطة. انظر الأنشطة.

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

التالي