نمونه
{
"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." }
]
}
}
} فیلدها
| فیلد | نوع | معنا |
|---|---|---|
requires.interfaces | فهرستی از رشتهها | تواناییهایی که نقش لازم دارد، مثل mail یا ledger. هنگام استخدام داده میشوند؛ هر عملیات نیازمند تأیید، مورد تأیید باقی میماند. تواناییها و تأییدها را ببینید. |
requires.plugins | فهرستی از رشتهها | افزونههایی که همراه کارمند نصب میشوند. فقط وقتی استفاده کنید که نقش واقعاً به یک افزونه وابسته است؛ توانایی را ترجیح دهید. |
requires.tools | فهرستی از رشتهها | ابزارهایی که از اولین نوبت در جلسه کارمند بارگذاری میشوند. این کار هرگز تأیید را دور نمیزند. |
skills | فهرستی از رشتهها | مهارتهای فروشگاه برای نصب و استفاده: @org/skills/name، در صورت نیاز با @version، یا یک کد SKIL-. مهارتهای پوشه skills/ خود بسته نیازی به ورودی ندارند. |
inputs | list | پرسشهایی که مالک هنگام استخدام پاسخ میدهد. ورودیها را ببینید. |
memory | object | گفتگوها و حافظه چطور نگه داشته میشوند. شخصیت و حافظه را ببینید. |
subscribes | فهرستی از رشتهها | حوزههای اطلاعات شرکت که کارمند هر وقت تغییر کنند دوباره میخواند، مثل finance.ar.*. |
ceiling | map | عملیات به "approval". آن عملیات همیشه برای این کارمند از مالک اجازه میگیرد. هیچ مقدار دیگری پذیرفته نمیشود. |
workflows | map | نام گردشکار به گردشکار. گردشکارها را ببینید. |
tools | list | ابزارهای HTTP که sidecar یک برنامه ارائه میدهد. ابزارهای Sidecar را ببینید. |
scopes | map | گروههای نامدار از tools، skills و plugins. وقتی یک scope فعال است، plugins آن برای کارمند توصیف میشوند. |
ورودیها
ورودی سؤالی است که مالک هنگام استخدام به آن پاسخ میدهد. پاسخها زیر «Configured Inputs» به کارمند نشان داده میشوند و جاینگهدارهای {{key}} را در تریگرهای پایش و پوشه پر میکنند.
{
"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"
} | فیلد | پیشفرض | معنا |
|---|---|---|
key | الزامی | نامی که در placeholderها استفاده میشود. name هم بهعنوان جایگزین پذیرفته میشود. |
label | از key | پرسشی که به مالک نشان داده میشود. |
type | text | text، textarea، number، select، checkbox یا radio. |
required | false | پرسش را بهعنوان پرسشی که مالک باید پاسخ دهد مشخص میکند. |
default | هیچ | پاسخ از پیش پرشده. برای پرسش مالی مجاز نیست. |
placeholder, description | هیچ | متن راهنما. |
options | هیچ | برای select و radio: اشیای {value, label} یا رشتههای ساده. |
id | هیچ | یک نام پایدار و نقطهدار برای این اطلاعات، مثل finance.ap.invoice_mailbox، تا کارمندان دیگر هم بتوانند از آن استفاده کنند. |
scope | company | company: یک اطلاعات مشترک شرکت. seat: فقط برای همین استخدام. |
missing | هیچ | کاری که کارمند تا وقتی پرسش بیپاسخ است انجام میدهد. |
money | false | یک مبلغ پولی را مشخص میکند. پرسش مالی نمیتواند مقدار پیشفرض داشته باشد. |
ابزارهای Sidecar
برنامهای که sidecar دارد، نقطههای پایانی HTTP را بهصورت ابزار در اختیار کارمندش میگذارد. Nebo هر مورد را با نام app__<app>__<name> ثبت میکند و فراخوانیها را با method و path به sidecar میفرستد. App Sidecar را ببینید.
"tools": [
{
"name": "list_entries",
"description": "List journal entries for a date range.",
"method": "GET",
"path": "/entries",
"input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
}
] گردشکارها
هر کلید زیر workflows نام یک گردشکار است؛ این نام شناسه آن است. قالب کامل در گردشکارها، محرکها و فعالیتها آمده است.