שדות
{
"id": "draft-reply",
"label": "Draft the reply",
"intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
"skills": ["reply-drafting"],
"requires_tools": ["mail_message_send"],
"on_error": { "retry": 1, "fallback": "notify_owner" }
} | שדה | ברירת מחדל | משמעות |
|---|---|---|
id | חובה | ייחודי בתוך תהליך העבודה. משמש ב-connections ובנתיבי נתונים. |
type | custom | שלב של עובד, או אחד מבין condition, loop, wait, http, command, decide. |
intent | אין | מה העובד צריך להשיג. שלב של עובד צריך intent או steps. |
steps | [] | הוראות מסודרות, כשמשפט אחד לא מספיק. |
label | אין | השם שמוצג לבעלים. |
skills | [] | כישורים לשימוש. כישורים מהחנות שמופיעים כאן מותקנים יחד עם העובד. |
tools | [] | כשמוגדר, אלה הכלים היחידים שהשלב רשאי להשתמש בהם. |
requires_tools | [] | כלים שחייבים להצליח כדי שהשלב ייחשב כגמור. |
cmds | [] | פקודות תוסף שמוזכרות לשלב. |
mcps | [] | שרתי MCP שמוזכרים לשלב. |
model | אין | מזהה מודל לשלב הזה. |
params | אין | פרמטרים לפעילויות המוגדרות לפי סוג, ו-maxIterations לשלבים של העובד. |
min_iterations | אין | מספר מינימלי של תורות מודל לפני שהשלב יכול להסתיים. |
token_budget | אין | {max}. הערכה. |
on_error | {retry: 1, fallback: notify_owner} | ניסיונות חוזרים, ואז החלופה. כל כישלון אחרי הניסיונות החוזרים מסיים את הריצה. |
שלבים של עובד
שלב של עובד רץ כתור של העובד: הפרסונה, הזיכרון והחיבורים שלו חלים, והוא יכול להשתמש בעד 50 תורות של המודל, או ב-params.maxIterations. התוצאות של שלבים קודמים מועברות כבלוקים של [Activity 'id' result]. השלב שמסיים תהליך עבודה עם רשימת emit מקבל הנחיה לקרוא ל-emit_event עם האירועים האלה. הכלי exit זמין תמיד כדי לסיים את הריצה.
הקשר הנתונים
פעילויות מוגדרות לפי סוג קוראות ערכים לפי נתיב עם נקודות מתוך אובייקט אחד: inputs מכיל את הקלטים של הריצה, nodes.<id> מכיל את הפלט של כל פעילות שהסתיימה (מנותח כ-JSON כשהוא JSON), ו-item מכיל את הפריט הנוכחי בתוך לולאה. נתיב בלי קידומת מחפש ב-inputs, ואז ב-nodes.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression הוא חובה. החיבורים היוצאים ממנו מסומנים True ו-False. params.mode בוחר איך לקרוא אותו:
| מצב | ביטוי |
|---|---|
expression | ברירת המחדל. path op value עם ==, !=, >=, <=, > או <, בהשוואה מספרית כששני הצדדים מספרים; או נתיב בלבד, אמת כשהערך שלו אמיתי. |
exists | נתיב; אמת כשהוא מתפרש לערך אמיתי. |
contains | path contains text, או טקסט פשוט שמותאם מול הפלט הקודם. |
regex | תבנית שמותאמת מול הפלט הקודם. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source הוא הנתיב של רשימה. החיבור שמסומן Each item מוביל לגוף, שרץ פעם אחת לכל פריט כש-item מוגדר; החיבור שמסומן Done רץ אחרי כל הפריטים. האיטרציות מתחילות יחד, אלא אם אתה מגדיר concurrency. גם maxIterations ו-batchSize מתקבלים.
"connections": [
{ "from": "__trigger__", "to": "fetch" },
{ "from": "fetch", "to": "each-invoice" },
{ "from": "each-invoice", "to": "check", "label": "Each item" },
{ "from": "each-invoice", "to": "report", "label": "Done" }
] wait, http ו-command
{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } } | סוג | חובה | התנהגות |
|---|---|---|
wait | params.duration | משהה לפרק זמן ב-s, m או h. אין המתנה עד זמן מסוים; כדי להמשיך כשמתרחש אירוע, הפעל עליו תהליך עבודה שני. |
http | params.url | שולח את הבקשה. method, headers ו-body אופציונליים. |
command | params.command | מריץ פקודת מעטפת. ה-stdout שלה הוא הפלט של הפעילות. |
decide
פעילות decide שואלת שאלות מוגדרות סוג על העבודה עד עכשיו ורושמת תשובות מובנות שתנאי יכול לנתב לפיהן.
{
"id": "triage",
"type": "decide",
"params": {
"questions": {
"urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
"refund": { "type": "noul", "instructions": "The customer is asking for money back." }
},
"default": { "urgency": "normal", "refund": false }
}
} | סוג השאלה | criteria | תשובה |
|---|---|---|
choice | אובייקט של אפשרות לתיאור, 2 עד 255 אפשרויות. | choice, confidence ו-probabilities. |
score | רשימה של 2 עד 10 רמות מסודרות. | score מ-0 (הרמה הראשונה) ומעלה, ו-confidence. |
noul | אין. | noul, ההסתברות שהטענה נכונה. |
נתב לפי תשובה באמצעות תנאי, כמו nodes.triage.urgency.score >= 1.5. params.default נותן את התשובה הבטוחה לכל שאלה כשאי אפשר לקבל החלטה; לתשובת ברירת מחדל יש ביטחון 0. שאלה בלי ברירת מחדל לא מקבלת תשובה, ולכן תנאים עליה הולכים בקשת ה-False שלהם.
שגיאות
on_error.retry קובע כמה פעמים לנסות שוב פעילות שנכשלה; ברירת המחדל היא 1. אחרי הניסיון האחרון הריצה מסתיימת, ועם ה-fallback שבברירת המחדל, notify_owner, הבעלים מקבל הודעה. Nebo בודק את הפרמטרים הנדרשים של כל פעילות מוגדרת סוג כשהריצה מתחילה, ודוחה ענף שמפנה לפעילות לא מוכרת.