Pakej
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 | Fail | Wajib | Tujuan |
|---|---|---|
AGENT.md | ya | Persona: siapa pekerja itu, cara ia bekerja dan peraturannya. Lihat Persona dan Memori. |
agent.json | tidak | Keupayaan yang diperlukannya, soalan untuk pemilik, aliran kerja, tetapan memori dan had kelulusan. Lihat Rujukan agent.json. |
skills/ | tidak | Kemahiran dalam format SKILL.md standard. Hanya pekerja ini yang melihatnya. |
manifest.json | aplikasi sahaja | Identiti dengan "type": "app". Pasaran menulis manifesnya sendiri apabila ia membungkus pekerja. |
ui/ | aplikasi sahaja | Halaman aplikasi. Lihat Aplikasi. |
Tulis pakej
Mulakan dengan persona. Frontmatter menamakan pekerja dan memberikan penerangan satu baris; badannya ialah arahan dalam prosa biasa.
--- 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.
Tambah agent.json apabila peranan itu memerlukan sistem, tetapan daripada pemilik, atau kerja yang dilakukannya tanpa diminta. Yang ini memerlukan keupayaan mail, bertanya satu soalan semasa pengambilan, dan menjawab setiap mesej baharu sebaik sahaja ia tiba.
{
"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."
}
]
}
}
} Pemantauan itu menamakan keupayaan mail, bukan produk. Semasa masa jalan, ia diselesaikan kepada plugin yang disambungkan oleh pemilik untuk mel. Lihat Aliran Kerja untuk pencetus dan aktiviti.
Muatkannya pada bot
Letakkan folder dalam <data>/user/agents/<name>/. Nebo memantau AGENT.md, agent.json dan manifest.json dan memuat semula pekerja kira-kira sesaat selepas perubahan. Membuang folder itu menyahaktifkan pekerja tetapi mengekalkan rekodnya.
Nebo memuatkan pekerja daripada tiga sumber, dan sumber terkemudian diutamakan: pekerja yang terbina dalam Nebo, pakej pasaran termeterai dalam <data>/nebo/agents/, dan folder dalam <data>/user/agents/. Pekerja juga boleh mencipta atau mengubah pakej untuk anda dengan alat create_employee dan update_employeenya, yang menulis folder yang sama.
Apa yang berlaku semasa pengambilan
Apabila pemilik mengambil pekerja anda dari pasaran atau dengan kod AGNT-, Nebo:
- Membaca keperluan pakej tanpa bertanya kepada model: setiap keupayaan dalam
requires.interfaces, setiap plugin dalamrequires.plugins, dan setiap keupayaan atau plugin yang dinamakan oleh pencetus pemantauan. - Menunjukkan kepada pemilik satu ayat persetujuan untuk keperluan tersebut dan, semasa pengambilan, memberikannya kepada pekerja ini sebagai kebenaran tetap. Operasi yang memerlukan kelulusan kekal begitu. Lihat Keupayaan dan Kelulusan.
- Memasang kebergantungan: plugin dalam
requires.plugins, kemahiran pasaran yang dinamakan dalamskillsdan dalam aktiviti, serta kebergantungan yang diisytiharkan semasa pakej diterbitkan. - Bertanya kepada pemilik soalan
inputs, dan memberitahu pemilik melalui Peti Masuk tentang sebarang keupayaan yang belum mempunyai sambungan.
Aliran kerja yang keupayaannya tiada sambungan disimpan dan ditanda sebagai terjejas, bersama sebabnya. Ia mula berfungsi sebaik sahaja pemilik menyambungkan sistem.
Apa yang disemak oleh Nebo
Nebo membaca agent.json secara longgar. Kunci yang tidak dikenali diabaikan. Aliran kerja yang tidak sepadan dengan skema dilangkau, dan pemilik mendapat notis Peti Masuk bahawa ia tidak akan berjalan; selebihnya pekerja itu tetap dimuatkan. Masalah berikut menolak keseluruhan fail:
- Pencetus
eventdengan senaraisourcesyang kosong. - Dua aktiviti dengan
idyang sama dalam satu aliran kerja. - Input dengan
scopeselaincompanyatauseat, atau soalan wang dengan nilai lalai. - Nilai
ceilingselain"approval". - Pepohon panggilan telefon tanpa tepat satu ucapan alu-aluan dan sekurang-kurangnya satu niat bernama.
Sesetengah semakan dijalankan apabila aliran kerja bermula dan bukannya apabila ia dimuatkan, seperti parameter yang diperlukan oleh setiap jenis aktiviti. Lihat Aktiviti.
Tulis tanggungjawab, bukan alat. Pakej pekerja menamakan keupayaan, seperti ledger atau mail, dan tidak sekali-kali produk, syarikat atau industri tertentu. Pemilik menentukan sistem mana yang mengisi setiap keupayaan, jadi satu pakej melayani setiap syarikat yang mengambilnya.
Seterusnya
- Rujukan agent.json
- Persona dan Memori
- Penerbitan: letakkan pekerja di pasaran.