| סוג | רץ כאשר |
|---|---|
schedule | ביטוי cron מתאים. |
heartbeat | עובר פרק זמן קבוע, ואפשר גם בתוך חלון יומי. |
event | נפלט אירוע עם מקור תואם. |
watch | משגיח של תוסף כותב שורת פלט. |
folder | קבצים משתנים בתיקייה. |
manual | הבעלים או עובד מריצים אותו. |
call | קו טלפון מצלצל. רק בעצי שיחות טלפון. |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron הוא ביטוי cron בן חמישה שדות: דקה, שעה, יום בחודש, חודש, יום בשבוע. schedule הוא תיאור אופציונלי לאנשים. תזמונים רצים לפי אזור הזמן המקומי של הבוט. Nebo בודק תזמונים כל חמש שניות. הפעלה שהוחמצה בזמן שהבוט היה כבוי מושלמת פעם אחת אם האיחור קטן משעה. הפעלה מדולגת כל עוד הריצה הקודמת עדיין פועלת.
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval הוא פרק זמן כמו 30m, 1h או 2h30m. window, HH:MM-HH:MM, שומר את ההפעלות בתוך שעות העבודה. ההפעלה הבאה היא ההפעלה האחרונה ועוד פרק הזמן, מוזזת לתוך החלון; הראשונה מתרחשת פרק זמן אחד אחרי שתהליך העבודה נטען. הטיימרים שורדים הפעלות מחדש. הפעלה מדולגת כל עוד הריצה הקודמת עדיין פועלת, ופרק זמן לא תקין אף פעם לא מופעל.
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources מפרט שמות אירועים להתאמה מדויקת, או עם תו כללי .* בסוף. רשימה ריקה היא שגיאה שגורמת לדחיית כל קובץ ה-agent.json. הריצה מקבלת _event_source, _event_payload ו-_event_origin. ראה אירועים כדי להבין איך נוצרים שמות.
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } watch משאיר תהליך של תוסף פועל ומתחיל ריצה לכל שורה שהוא כותב. כל שורה מגיעה כ-_watch_payload. שורות זהות בתוך עשר דקות מושמטות.
| שדה | ברירת מחדל | משמעות |
|---|---|---|
plugin | חובה | יכולת, כמו mail, או slug של תוסף. ציין יכולת בכל פעם שיש אחת מתאימה. |
event | אין | אירוע מרשימת ה-events של התוסף. Nebo משתמש בפקודה של האירוע הזה ופולט גם כל שורה כ-<plugin>.<event>. |
command | אין | ארגומנטים שמפעילים את המשגיח. משמשים כשהם מוגדרים; אחרת נלקחים מ-event. |
restart_delay_secs | 5 | זמן המתנה לפני הפעלה מחדש של משגיח שיצא. |
יכולת מתפרשת לתוסף המותקן שמספק אותה, ועדיף כזה שלעובד הזה יש בו חשבון. כשאין תוסף כזה, תהליך העבודה מסומן כפגום והבעלים מקבל הודעה מה לחבר. משגיח שממשיך לקרוס מופעל מחדש עם השהיה שמוכפלת עד 300 שניות ומתאפסת אחרי 30 שניות של פעילות רצופה.
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } {{key}} ב-command מתמלא מהתשובות של הבעלים לקלטים של העובד. אם לציין מיקום אין תשובה, המעקב לא מתחיל.
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | שדה | ברירת מחדל | משמעות |
|---|---|---|
path | חובה | נתיב מוחלט של התיקייה. {{key}} ממולא מהקלטים. |
extensions | כל הקבצים | סיומות קבצים להתאמה, בלי הנקודה. |
recursive | true | כולל תיקיות משנה. |
debounce_secs | 2 | שינויים בתוך החלון הזה הופכים לריצה אחת. |
הריצה מקבלת את הנתיבים ששונו ב-_watch_payload.files.
manual
{ "type": "manual" } תהליך עבודה ידני רץ רק כשהבעלים מריץ אותו או כשעובד קורא ל-run_workflow. כל תהליך עבודה, יהיה הטריגר שלו אשר יהיה, יכול לרוץ גם בדרך הזו.
call
{"type": "call", "line": "..."} תקף רק בתהליך עבודה מסוג "type": "call_tree", שמגדיר איך עובד עונה לקו טלפון. line ריק חל על כל קו שהעובד עונה לו ושאין לו עץ ספציפי יותר. לעץ שיחה חייבת להיות בדיוק ברכה אחת ולפחות כוונה אחת עם שם.
Webhooks
הבעלים יכול גם ליצור webhook לעובד. webhook שמקושר לתהליך עבודה מריץ את תהליך העבודה הזה; webhook בלי תהליך עבודה מעביר את המטען שלו לצ׳אט של העובד.