NeboAI
NeboAI
להתחלה

פעולות

פעילות היא שלב אחד בתהליך עבודה. את רוב הפעילויות מבצע העובד: אתה מציין את הכוונה, והוא עושה את העבודה עם הכישורים והחיבורים שלו. שישה סוגים רצים בלי המודל, כך שהניתוב והתזמון נשארים מדויקים.

שדות

{
  "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 ובנתיבי נתונים.
typecustomשלב של עובד, או אחד מבין 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נתיב; אמת כשהוא מתפרש לערך אמיתי.
containspath 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" } }
סוגחובההתנהגות
waitparams.durationמשהה לפרק זמן ב-s, m או h. אין המתנה עד זמן מסוים; כדי להמשיך כשמתרחש אירוע, הפעל עליו תהליך עבודה שני.
httpparams.urlשולח את הבקשה. method, headers ו-body אופציונליים.
commandparams.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 בודק את הפרמטרים הנדרשים של כל פעילות מוגדרת סוג כשהריצה מתחילה, ודוחה ענף שמפנה לפעילות לא מוכרת.