תהליך עבודה ראשון
הוסף מיפוי 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 ושאר כלי תהליכי העבודה שמופיעים ב-עוזרים וצוותים.