Paketnya
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 | File | Wajib | Tujuan |
|---|---|---|
AGENT.md | ya | Persona: siapa karyawan itu, bagaimana ia bekerja, dan aturannya. Lihat Persona dan Memori. |
agent.json | tidak | Kapabilitas yang dibutuhkannya, pertanyaan untuk pemilik, workflow, pengaturan memori, dan batas persetujuan. Lihat Referensi agent.json. |
skills/ | tidak | Skill dalam format SKILL.md standar. Hanya karyawan ini yang dapat melihatnya. |
manifest.json | hanya aplikasi | Identitas dengan "type": "app". Marketplace menulis manifesnya sendiri saat mengemas karyawan. |
ui/ | hanya aplikasi | Halaman aplikasi. Lihat Aplikasi. |
Tulis paket
Mulailah dengan persona. Frontmatter memberi nama karyawan dan deskripsi satu baris; isinya berupa instruksi 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.
Tambahkan agent.json jika peran tersebut membutuhkan sebuah sistem, pengaturan dari pemilik, atau pekerjaan yang dilakukannya tanpa diminta. Contoh ini membutuhkan kapabilitas mail, mengajukan satu pertanyaan saat perekrutan, dan menjawab setiap pesan baru saat pesan itu masuk.
{
"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 menyebut kapabilitas mail, bukan sebuah produk. Saat runtime, kapabilitas itu diarahkan ke plugin yang dihubungkan pemilik untuk email. Lihat Workflow untuk pemicu dan aktivitas.
Muat di bot
Letakkan folder di <data>/user/agents/<name>/. Nebo memantau AGENT.md, agent.json, dan manifest.json serta memuat ulang karyawan sekitar satu detik setelah ada perubahan. Menghapus folder akan menonaktifkan karyawan tetapi tetap menyimpan catatannya.
Nebo memuat karyawan dari tiga sumber, dan sumber yang lebih akhir yang berlaku: karyawan bawaan Nebo, paket marketplace tersegel di <data>/nebo/agents/, dan folder di <data>/user/agents/. Seorang karyawan juga dapat membuat atau mengubah paket untuk Anda dengan alat create_employee dan update_employee miliknya, yang menulis ke folder yang sama.
Apa yang terjadi saat perekrutan
Saat pemilik merekrut karyawan Anda dari marketplace atau dengan kode AGNT-, Nebo:
- Membaca kebutuhan paket tanpa bertanya kepada model: setiap kapabilitas di
requires.interfaces, setiap plugin direquires.plugins, dan setiap kapabilitas atau plugin yang disebut oleh pemicu watch. - Menampilkan kepada pemilik satu kalimat persetujuan untuk kebutuhan tersebut dan, saat perekrutan, memberikannya kepada karyawan ini sebagai izin tetap. Operasi yang memerlukan persetujuan tetap seperti itu. Lihat Kapabilitas dan Persetujuan.
- Memasang dependensi: plugin di
requires.plugins, skill marketplace yang disebut diskillsdan di aktivitas, serta dependensi yang dideklarasikan saat paket dipublikasikan. - Mengajukan pertanyaan
inputskepada pemilik, dan memberi tahu pemilik melalui Kotak Masuk tentang kapabilitas apa pun yang belum memiliki koneksi.
Workflow yang kapabilitasnya belum memiliki koneksi tetap disimpan dan ditandai menurun beserta alasannya. Workflow itu mulai berjalan begitu pemilik menghubungkan sebuah sistem.
Apa yang diperiksa Nebo
Nebo membaca agent.json secara longgar. Key yang tidak dikenal diabaikan. Workflow yang tidak sesuai skema akan dilewati, dan pemilik mendapat pemberitahuan di Kotak Masuk bahwa workflow itu tidak akan berjalan; bagian lain dari karyawan tetap dimuat. Masalah-masalah berikut membuat seluruh file ditolak:
- Pemicu
eventdengan daftarsourcesyang kosong. - Dua aktivitas dengan
idyang sama dalam satu workflow. - Input dengan
scopeselaincompanyatauseat, atau pertanyaan uang yang memiliki nilai default. - Nilai
ceilingselain"approval". - Pohon panggilan telepon yang tidak memiliki tepat satu sapaan dan setidaknya satu intent bernama.
Beberapa pemeriksaan dijalankan saat workflow dimulai, bukan saat dimuat, misalnya parameter yang diwajibkan setiap tipe aktivitas. Lihat Aktivitas.
Tulis tanggung jawab, bukan alat. Paket karyawan menyebut kapabilitas, seperti ledger atau mail, dan tidak pernah menyebut produk, perusahaan, atau industri tertentu. Pemilik menentukan sistem mana yang mengisi setiap kapabilitas, sehingga satu paket dapat melayani setiap perusahaan yang merekrutnya.
Berikutnya
- Referensi agent.json
- Persona dan Memori
- Publikasi: tampilkan karyawan di marketplace.