بسته
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". فروشگاه هنگام بستهبندی یک کارمند، manifest خودش را مینویسد. |
ui/ | فقط برنامهها | صفحه برنامه. برنامهها را ببینید. |
نوشتن بسته
با شخصیت شروع کنید. frontmatter نام کارمند را میآورد و یک توضیح یکخطی میدهد؛ بدنه دستورالعملهایی به نثر ساده است.
--- 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."
}
]
}
}
} watch نام توانایی 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و هر توانایی یا افزونهای که یک محرک watch نام میبرد. - برای این نیازها یک جمله رضایت به مالک نشان میدهد و هنگام استخدام، آنها را بهصورت مجوزهای دائمی به این کارمند میدهد. عملیاتی که به تأیید نیاز دارند همانطور باقی میمانند. تواناییها و تأییدها را ببینید.
- وابستگیها را نصب میکند: افزونههای
requires.plugins، مهارتهای فروشگاهی که درskillsو فعالیتها نام برده شدهاند، و وابستگیهایی که هنگام انتشار بسته اعلام شدهاند. - پرسشهای
inputsرا از مالک میپرسد و از طریق صندوق ورودی درباره هر تواناییای که هنوز اتصالی ندارد به او اطلاع میدهد.
گردشکاری که تواناییاش اتصالی ندارد نگه داشته میشود و همراه با دلیل، بهعنوان افتکرده علامت میخورد. بهمحض اینکه مالک سیستمی را وصل کند، شروع به کار میکند.
Nebo چه چیزهایی را بررسی میکند
Nebo فایل agent.json را با سهلگیری میخواند. کلیدهای ناشناخته نادیده گرفته میشوند. گردشکاری که با طرحواره جور نباشد کنار گذاشته میشود و مالک در صندوق ورودی اطلاعیهای میگیرد که اجرا نخواهد شد؛ بقیه کارمند همچنان بارگذاری میشود. این مشکلات کل فایل را رد میکنند:
- یک محرک
eventبا فهرستsourcesخالی. - دو فعالیت با
idیکسان در یک گردشکار. - ورودیای با
scopeغیر ازcompanyیاseat، یا یک پرسش مالی با مقدار پیشفرض. - مقدار
ceilingغیر از"approval". - درخت تماس تلفنیای که دقیقاً یک خوشامدگویی و دستکم یک قصد نامدار نداشته باشد.
برخی بررسیها هنگام شروع گردشکار انجام میشوند نه هنگام بارگذاری، مثل پارامترهایی که هر نوع فعالیت لازم دارد. فعالیتها را ببینید.
مسئولیتها را بنویسید، نه ابزارها را. بسته کارمند تواناییهایی مثل ledger یا mail را نام میبرد و هرگز یک محصول، شرکت یا صنعت مشخص را نه. مالک تعیین میکند کدام سیستم هر توانایی را پر کند، پس یک بسته به کار همه شرکتهایی میآید که استخدامش میکنند.
بعدی
- مرجع agent.json
- شخصیت و حافظه
- انتشار: کارمند را در فروشگاه بگذارید.