Contoh
{
"requires": {
"interfaces": ["ledger", "mail"],
"plugins": [],
"tools": []
},
"skills": ["@example/skills/receipt-capture"],
"inputs": [
{
"key": "invoice_mailbox",
"label": "Mailbox that receives vendor invoices",
"type": "text",
"id": "finance.ap.invoice_mailbox",
"scope": "company",
"required": true,
"missing": "Ask the owner which mailbox to watch before processing invoices."
}
],
"memory": {
"mode": "separate",
"topics": [
{ "slug": "vendor", "description": "A supplier: terms, usual amounts, contacts, open disputes" }
]
},
"subscribes": ["finance.ap.*"],
"ceiling": { "ledger.bill.create": "approval" },
"workflows": {
"invoice-intake": {
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"activities": [
{ "id": "record", "intent": "If the message in _watch_payload is a vendor invoice, record it as a bill." }
]
}
}
} Field
| Field | Tipe | Arti |
|---|---|---|
requires.interfaces | daftar string | Kapabilitas yang dibutuhkan peran, seperti mail atau ledger. Diberikan saat perekrutan; setiap operasi yang memerlukan persetujuan tetap menjadi item persetujuan. Lihat Kapabilitas dan Persetujuan. |
requires.plugins | daftar string | Plugin yang dipasang bersama karyawan. Gunakan hanya jika peran tersebut benar-benar bergantung pada satu plugin; lebih baik gunakan kapabilitas. |
requires.tools | daftar string | Alat yang dimuat ke sesi karyawan sejak giliran pertamanya. Ini tidak pernah melewati persetujuan. |
skills | daftar string | Skill marketplace yang dipasang dan digunakan: @org/skills/name, opsional dengan @version, atau kode SKIL-. Skill di folder skills/ milik paket itu sendiri tidak perlu dicantumkan. |
inputs | list | Pertanyaan yang dijawab pemilik saat perekrutan. Lihat Input. |
memory | object | Cara percakapan dan memori disimpan. Lihat Persona dan Memori. |
subscribes | daftar string | Area fakta perusahaan yang dibaca ulang karyawan saat berubah, seperti finance.ar.*. |
ceiling | map | Operasi ke "approval". Operasi itu selalu meminta persetujuan pemilik untuk karyawan ini. Tidak ada nilai lain yang diterima. |
workflows | map | Nama workflow ke workflow. Lihat Workflow. |
tools | list | Alat HTTP yang disajikan oleh sidecar aplikasi. Lihat Alat sidecar. |
scopes | map | Kelompok bernama berisi tools, skills, dan plugins. plugins dalam sebuah scope dijelaskan kepada karyawan saat scope itu aktif. |
Input
Input adalah pertanyaan yang dijawab pemilik saat merekrut. Jawabannya muncul bagi karyawan di bawah "Configured Inputs" dan mengisi placeholder {{key}} di pemicu watch dan folder.
{
"key": "close_day",
"label": "Business day to finish the close",
"type": "select",
"options": [
{ "value": "3", "label": "Third business day" },
{ "value": "5", "label": "Fifth business day" }
],
"default": "5",
"scope": "company",
"id": "finance.close.day"
} | Field | Default | Arti |
|---|---|---|
key | wajib | Nama yang digunakan di placeholder. name diterima sebagai cadangan. |
label | dari key | Pertanyaan yang ditampilkan kepada pemilik. |
type | text | text, textarea, number, select, checkbox, atau radio. |
required | false | Menandai pertanyaan sebagai pertanyaan yang wajib dijawab pemilik. |
default | tidak ada | Jawaban yang sudah diisi sebelumnya. Tidak diizinkan pada pertanyaan uang. |
placeholder, description | tidak ada | Teks bantuan. |
options | tidak ada | Untuk select dan radio: objek {value, label} atau string biasa. |
id | tidak ada | Nama bertitik yang stabil untuk fakta tersebut, seperti finance.ap.invoice_mailbox, agar karyawan lain dapat membagikannya. |
scope | company | company: fakta perusahaan bersama. seat: hanya untuk rekrutan ini. |
missing | tidak ada | Apa yang dilakukan karyawan selama pertanyaan belum dijawab. |
money | false | Menandai jumlah uang. Pertanyaan uang tidak boleh memiliki nilai default. |
Alat sidecar
Aplikasi dengan sidecar mengekspos endpoint HTTP kepada karyawannya sebagai alat. Nebo mendaftarkan setiap entri sebagai app__<app>__<name> dan mengirim panggilan ke sidecar pada method dan path. Lihat Sidecar Aplikasi.
"tools": [
{
"name": "list_entries",
"description": "List journal entries for a date range.",
"method": "GET",
"path": "/entries",
"input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
}
] Workflow
Setiap key di bawah workflows menamai satu workflow; nama itu adalah pengenalnya. Format lengkapnya ada di Workflow, Pemicu, dan Aktivitas.