الحزمة
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:
- يقرأ احتياجات الحزمة دون سؤال أي نموذج: كل قدرة في
requires.interfaces، وكل إضافة فيrequires.plugins، وكل قدرة أو إضافة يسمّيها مُشغِّل مراقبة. - يعرض على المالك جملة موافقة واحدة لتلك الاحتياجات، وعند التوظيف يمنحها لهذا الموظف كأذونات دائمة. وتبقى العمليات التي تحتاج إلى موافقة كما هي. انظر القدرات والموافقات.
- يثبّت الاعتماديات: الإضافات في
requires.plugins، ومهارات المتجر المذكورة فيskillsوفي الأنشطة، والاعتماديات المصرّح بها عند نشر الحزمة. - يطرح على المالك أسئلة
inputs، ويُعلمه عبر البريد الوارد بأي قدرة ليس لها اتصال بعد.
سير العمل الذي لا اتصال لقدرته يُحتفظ به ويُعلَّم بأنه متراجع، مع ذكر السبب. ويبدأ العمل بمجرد أن يربط المالك نظامًا.
ما يتحقق منه Nebo
يقرأ Nebo الملف agent.json بتساهل. تُتجاهل المفاتيح غير المعروفة. ويُتخطّى سير العمل الذي لا يطابق المخطط، ويتلقى المالك إشعارًا في البريد الوارد بأنه لن يعمل، بينما يُحمَّل باقي الموظف. أما المشكلات التالية فترفض الملف كله:
- مُشغِّل
eventبقائمةsourcesفارغة. - نشاطان لهما
idنفسه في سير عمل واحد. - مدخل بقيمة
scopeغيرcompanyأوseat، أو سؤال مالي له قيمة افتراضية. - قيمة
ceilingغير"approval". - شجرة مكالمات هاتفية لا تحتوي على تحية واحدة بالضبط وعلى نية مسمّاة واحدة على الأقل.
بعض الفحوص تعمل عند بدء سير العمل لا عند تحميله، مثل المعاملات التي يتطلبها كل نوع من الأنشطة. انظر الأنشطة.
اكتب المسؤوليات، لا الأدوات. تسمّي حزمة الموظف قدرات، مثل ledger أو mail، ولا تسمّي أبدًا منتجًا أو شركة أو قطاعًا بعينه. يقرّر المالك أي نظام يؤدي كل قدرة، فتخدم الحزمة الواحدة كل شركة توظّف صاحبها.
التالي
- مرجع agent.json
- الشخصية والذاكرة
- النشر: ضع الموظف في المتجر.