דוגמה
{
"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. ה-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 | חובה | השם שמשמש במצייני מיקום. 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> ושולח קריאות ל-sidecar לפי method ו-path. ראה 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 נותן שם לתהליך עבודה אחד; השם הוא המזהה שלו. הפורמט המלא מופיע בתהליכי עבודה, בטריגרים ובפעולות.