NeboAI
NeboAI
להתחלה

תהליכי עבודה

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

תהליך עבודה ראשון

הוסף מיפוי workflows ל-agent.json. כל מפתח הוא שם של תהליך עבודה; לכל ערך יש טריגר ופעילויות.

{
  "workflows": {
    "morning-summary": {
      "trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
      "description": "Summarize yesterday's open conversations every weekday morning.",
      "activities": [
        { "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
      ]
    }
  }
}

תהליך העבודה הזה רץ ב-08:00 בימי חול, לפי השעה המקומית של הבוט. העובד מבצע את הפעילות עם הפרסונה, הכישורים והחיבורים שלו.

שדות של תהליך עבודה

שדהמשמעות
triggerחובה. מתי תהליך העבודה רץ. ראה טריגרים.
descriptionלמה משמש תהליך העבודה.
activitiesהשלבים. ראה פעילויות.
connectionsקשתות {from, to, label} שהופכות את הפעילויות לגרף. __trigger__ היא ההתחלה ו-__emit__ הסוף.
emitאירועים שתהליך העבודה הזה מכריז עליהם כשהוא מסתיים: רשימה, או מחרוזת אחת מופרדת בפסיקים. ראה אירועים.
inputsערכים שמועברים לכל ריצה.
budget{total_per_run, cost_estimate}. בריצת גרף, total_per_run מגביל את טוקני הפלט; אחרת שניהם הערכות.
caseהופך את תהליך העבודה לתיק אחד ארוך טווח לכל אדם או דבר. ראה תיקים.

תהליך עבודה עם טריגר ובלי פעילויות הוא תקין. משגיח בלי פעילויות רק מעביר את האירועים שלו לתהליכי עבודה אחרים.

איך ריצה מתבצעת

בלי connections, הפעילויות רצות לפי הסדר והעובד מבצע כל אחת מהן. התוצאה של כל פעילות מועברת לבאה אחריה. פעילות בלי פלט מסיימת את הריצה.

עם connections, הפעילויות יוצרות גרף. ענפים רצים במקביל, ושישה סוגי פעילויות רצים בלי המודל: condition, loop, wait, http, command ו-decide. השתמש בגרף כשהניתוב חייב להיות מדויק.

{
  "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
  "activities": [
    { "id": "classify", "type": "decide",
      "params": {
        "questions": {
          "kind": {
            "type": "choice",
            "instructions": "What kind of message is this?",
            "criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
          }
        },
        "default": { "kind": "other" }
      } },
    { "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
    { "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
  ],
  "connections": [
    { "from": "__trigger__", "to": "classify" },
    { "from": "classify", "to": "is-invoice" },
    { "from": "is-invoice", "to": "record", "label": "True" },
    { "from": "record", "to": "__emit__" }
  ],
  "emit": ["invoice.recorded"]
}

מה ריצה מקבלת

לעובד יש תמיד את הפרסונה שלו ואת התשובות של הבעלים לשאלות ה-inputs שלו. ריצה מקבלת גם את הערכים האלה, בהתאם לטריגר שלה.

קלטקיים כאשר
_event_source, _event_payload, _event_originטריגר event הופעל. מטענים של 8 KB ומעלה מקוצרים לשדות הסקלריים שלהם, תוך שמירה על כותרות הדוא״ל ועל ההפניות לקבצים המצורפים.
_watch_payloadטריגר watch או folder הופעל. שורה אחת מהפלט של המשגיח, או {files} עבור תיקייה.
inputsתמיד. ערכי ה-inputs של תהליך העבודה עצמו.

תיקים

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

שדהמשמעות
keyחובה. נתיבים עם נקודות, מופרדים בפסיקים, לתוך נתוני הטריגר, שמזהים את הנושא, כמו contactEmail,email,phone.
typeסוג התיק, כמו lead. תהליכי עבודה עם אותו סוג חולקים תיקים. ברירת המחדל היא שם תהליך העבודה.
default_waitכמה זמן להמתין כשתור לא מציין המתנה: 3d, 12h, 45m. ברירת המחדל היא שלושה ימים.

כל תור של תיק חייב להסתיים באובייקט JSON אחד, בלי שום דבר אחריו. result הוא המצב העסקי; next אומר למנוע wait או close. מועד יעד נכתב בפורמט RFC 3339 או כפרק זמן יחסי. כל דבר אחר הוא תור לא תקין.

{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
 "next":   {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}}

מגבלות והתאוששות

  • כל פעילות יכולה להשתמש בעד 50 תורות של המודל, אלא אם params.maxIterations קובע אחרת.
  • בגרף, פעילות אחת יכולה לרוץ לכל היותר 10,000 פעמים בריצה.
  • תקרת ההוצאות שהבעלים קבע לעובד עוצרת ריצה כשמגיעים אליה. ה-token_budget של פעילות הוא הערכה.
  • ריצה שנקטעה בגלל הפעלה מחדש מסומנת כקטועה וממשיכה פעם אחת.
  • העובד יכול לסיים ריצה מוקדם עם הכלי exit.

הרצה וניהול של תהליכי עבודה

הבעלים יכול להריץ כל תהליך עבודה באופן ידני. עובדים מנהלים תהליכי עבודה עם run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled ושאר כלי תהליכי העבודה שמופיעים ב-עוזרים וצוותים.