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." }
]
}
}
} Medan
| Medan | Jenis | Maksud |
|---|---|---|
requires.interfaces | senarai rentetan | Keupayaan yang diperlukan oleh peranan, seperti mail atau ledger. Diberikan semasa pengambilan; setiap operasi yang memerlukan kelulusan kekal sebagai item kelulusan. Lihat Keupayaan dan Kelulusan. |
requires.plugins | senarai rentetan | Plugin yang dipasang bersama pekerja. Gunakan hanya apabila peranan itu benar-benar bergantung pada satu plugin; utamakan keupayaan. |
requires.tools | senarai rentetan | Alat yang dimuatkan ke dalam sesi pekerja dari giliran pertamanya. Ini tidak sekali-kali memintas kelulusan. |
skills | senarai rentetan | Kemahiran pasaran untuk dipasang dan digunakan: @org/skills/name, secara pilihan @version, atau kod SKIL-. Kemahiran dalam folder skills/ pakej itu sendiri tidak memerlukan entri. |
inputs | list | Soalan yang dijawab oleh pemilik semasa pengambilan. Lihat Input. |
memory | object | Cara perbualan dan memori disimpan. Lihat Persona dan Memori. |
subscribes | senarai rentetan | Bidang fakta syarikat yang dibaca semula oleh pekerja apabila ia berubah, seperti finance.ar.*. |
ceiling | map | Operasi kepada "approval". Operasi itu sentiasa meminta kebenaran pemilik untuk pekerja ini. Tiada nilai lain diterima. |
workflows | map | Nama aliran kerja kepada aliran kerja. Lihat Aliran Kerja. |
tools | list | Alat HTTP yang disajikan oleh sidecar aplikasi. Lihat Alat sidecar. |
scopes | map | Kumpulan bernama tools, skills dan plugins. plugins sesuatu skop diterangkan kepada pekerja apabila skop itu aktif. |
Input
Input ialah soalan yang dijawab oleh pemilik semasa mengambil pekerja. Jawapan dipaparkan kepada pekerja di bawah "Configured Inputs" dan mengisi pemegang tempat {{key}} dalam pencetus pantauan 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"
} | Medan | Lalai | Maksud |
|---|---|---|
key | wajib | Nama yang digunakan dalam pemegang tempat. name diterima sebagai sandaran. |
label | daripada key | Soalan yang dipaparkan kepada pemilik. |
type | text | text, textarea, number, select, checkbox atau radio. |
required | false | Menandakan soalan sebagai soalan yang mesti dijawab oleh pemilik. |
default | tiada | Jawapan yang telah diisi. Tidak dibenarkan pada soalan wang. |
placeholder, description | tiada | Teks bantuan. |
options | tiada | Untuk select dan radio: objek {value, label} atau rentetan biasa. |
id | tiada | Nama bertitik yang stabil untuk fakta itu, seperti finance.ap.invoice_mailbox, supaya pekerja lain boleh berkongsinya. |
scope | company | company: fakta syarikat yang dikongsi. seat: pengambilan ini sahaja. |
missing | tiada | Apa yang dilakukan pekerja semasa soalan belum dijawab. |
money | false | Menandakan jumlah wang. Soalan wang tidak boleh mempunyai nilai lalai. |
Alat sidecar
Aplikasi dengan sidecar mendedahkan titik akhir HTTP kepada pekerjanya sebagai alat. Nebo mendaftarkan setiap entri sebagai app__<app>__<name> dan menghantar panggilan kepada sidecar di 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" } } }
}
] Aliran Kerja
Setiap kunci di bawah workflows menamakan satu aliran kerja; nama itu ialah pengecamnya. Format penuh terdapat di Aliran Kerja, Pencetus dan Aktiviti.