NeboAI
NeboAI
להתחלה

טריגרים

טריגר קובע מתי תהליך עבודה רץ. ל-Nebo יש שבעה סוגי טריגרים. כל אחד הוא אובייקט עם שדה type ועם השדות של אותו סוג.

סוגרץ כאשר
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_secs5זמן המתנה לפני הפעלה מחדש של משגיח שיצא.

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

הריצה מקבלת את הנתיבים ששונו ב-_watch_payload.files.

manual

{ "type": "manual" }

תהליך עבודה ידני רץ רק כשהבעלים מריץ אותו או כשעובד קורא ל-run_workflow. כל תהליך עבודה, יהיה הטריגר שלו אשר יהיה, יכול לרוץ גם בדרך הזו.

call

{"type": "call", "line": "..."} תקף רק בתהליך עבודה מסוג "type": "call_tree", שמגדיר איך עובד עונה לקו טלפון. line ריק חל על כל קו שהעובד עונה לו ושאין לו עץ ספציפי יותר. לעץ שיחה חייבת להיות בדיוק ברכה אחת ולפחות כוונה אחת עם שם.

Webhooks

הבעלים יכול גם ליצור webhook לעובד. webhook שמקושר לתהליך עבודה מריץ את תהליך העבודה הזה; webhook בלי תהליך עבודה מעביר את המטען שלו לצ׳אט של העובד.