Пакет
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/ | тек қолданбалар үшін | Қолданбаның беті. «Қолданбалар» бөлімін қараңыз. |
Пакет жазу
Тұлғадан бастаңыз. 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."
}
]
}
}
} Бақылау өнімді емес, 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 файлын жұмсақ оқиды. Белгісіз кілттер еленбейді. Схемаға сай келмейтін жұмыс үдерісі өткізіліп жіберіледі, ал иесі оның іске қосылмайтыны туралы «Кіріс» хабарламасын алады; қызметкердің қалған бөлігі бәрібір жүктеледі. Мына мәселелер бүкіл файлды қабылдамайды:
sourcesтізімі босeventіске қосу шарты.- Бір жұмыс үдерісінде
idмәні бірдей екі әрекет. scopeмәніcompanyнемесеseatемес кіріс өрісі, немесе әдепкі мәні бар ақша сұрағы."approval"емесceilingмәні.- Дәл бір сәлемдесуі және кемінде бір атаулы ниеті жоқ телефон қоңырауы ағашы.
Кейбір тексерістер жұмыс үдерісі жүктелгенде емес, басталғанда орындалады, мысалы, әр әрекет түріне қажет параметрлер. Әрекеттер бөлімін қараңыз.
Құралдарды емес, жауапкершіліктерді жазыңыз. Қызметкер пакеті ledger немесе mail сияқты мүмкіндіктерді атайды, ешқашан нақты өнімді, компанияны немесе саланы атамайды. Әр мүмкіндікті қай жүйе толтыратынын иесі шешеді, сондықтан бір пакет оны жұмысқа алатын әр компанияға қызмет етеді.
Келесі
- agent.json анықтамасы
- Тұлға және жады
- Жариялау: қызметкерді маркетплейске шығарыңыз.