טריגר מתוזמן

רכיב טריגר מתוזמן מריץ תהליך אוטומטית לפי תזמון, למשל כל 20 דקות, כל יום ב-9:00 או בימי חול ב-18:30. תזמון הוא רשימה של כללים שמחושבים לפי אזור הזמן שבחרתם, והתהליך רץ בכל פעם שכלל כלשהו מתאים. הטריגר לא עולה כלום, והוא מתחיל הרצות רק כל עוד המתג שלו מופעל.

מתי להשתמש

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

התחלה מהירה

הפעלת התזמון

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

• בחלונית ההגדרות, השתמשו במתג שבראש החלונית. כתוב לידו התזמון פעיל או התזמון מושהה.
• בסרגל העליון של העורך, כפתור התזמון מופיע כשיש בתהליך רכיב טריגר מתוזמן. כתוב עליו תזמון פעיל, תזמון כבוי או, למשל, 1/2 תזמונים פעילים. לחיצה עליו מפעילה את כל התזמונים של התהליך, או משהה את כולם כשכולם כבר מופעלים, ושומרת את התהליך.

כיבוי המתג משהה את התזמון באותו אופן. תהליך מיובא או תבנית תמיד מתחילים עם התזמונים שלהם מושהים. תזמון שנכתב דרך ה-API, ה-SDK או MCP מופעל רק כשהשדה active של הרכיב הוא true.

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

הגדרות

כללים

לכל כלל יש ההגדרה תדירות והשדות שמתאימים לה.

• נקודת התחלה קבועה. ״כל N ימים, שבועות או חודשים״ נספר מנקודה קבועה בלוח השנה. שמירה חוזרת של התהליך אף פעם לא מזיזה את הימים שבהם הוא רץ.
• פורמט cron. השדות הם דקה, שעה, יום בחודש, חודש ויום בשבוע. כל השדות חייבים להתאים, כולל היום בחודש והיום בשבוע יחד, אף שבכלי cron מסוימים מספיק שאחד מהם יתאים. גם 0 וגם 7 הם יום ראשון.

מתי זה רץ

עוד לפני השמירה, החלק מתי זה רץ בחלונית ההגדרות מציג מה המשמעות של הכללים:

• התזמון במילים ומספר ההרצות ביום.
• ההרצות של היום על פס של 24 שעות.
• שלוש ההרצות הבאות, וכמה זמן נשאר עד כל אחת מהן.

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

איך הרצה מתוזמנת עובדת

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

ניסיון חוזר לאחר כישלון

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

• אותה הרצה שוב. ניסיון חוזר מריץ את אותו ענף שהתזמון מריץ, עם אותו זמן של ההרצה הקודמת, ולכן המשתנה {{trigger.last_triggered_at}} מקבל את אותו ערך שההרצה שנכשלה קיבלה. היסטוריית ההרצות מציגה אותו עם התג ניסיון חוזר 1 מתוך 3 לצד התג מתוזמן.
• עד להצלחה. ניסיון חוזר שנכשל מקבל ניסיון חוזר נוסף, עד למספר שבהגדרה מספר ניסיונות (לכל היותר). ניסיון חוזר שמצליח מסיים את השרשרת.
• רק ההרצה האחרונה. אחרי שהתזמון רץ שוב, אין ניסיון חוזר לכשל ישן יותר. גם לכשל שקרה לפני יותר מיומיים אין ניסיון חוזר.
• הרצה אחת בכל פעם. ניסיון חוזר ממתין כל עוד הרצה אחרת שלכם של אותו תהליך עדיין רצה.
• מקסימום הרצות. ניסיונות חוזרים לא נספרים במגבלה מקסימום הרצות.
• אפשר לכבות בכל רגע. הגדרות הניסיון החוזר נקראות מהרכיב במצבו הנוכחי. כבו את המתג ניסיון חוזר לאחר כישלון ושמרו כדי לעצור שרשרת מיד.
• על כל ניסיון חוזר משלמים. הקרדיטים של ההרצה שנכשלה הוחזרו כשהיא נכשלה. בכל ניסיון חוזר משוריינים שוב קרדיטים לענף והם נגבים, כמו בכל הרצה. על הרצה שנכשלת שלוש פעמים ואז מצליחה משלמים על הרכיבים שהושלמו בכל ניסיון, ובנוסף על ההרצה המוצלחת.

ההגדרה מסלולים זולים בלבד חלה על קריאות המודל של הרכיבים יצירת טקסט - כל LLM, תיאור תמונה, יצירת תסריט וגרפיקת תנועה עם מנוע Lottie. היא לא משנה את הסכום שאתם משלמים. קריאה שחייבת לרוץ ישירות אצל יצרן המודל בגלל ההגדרות שלה עצמה, כגון מצב מתקדם או מודל Claude שנבחר לו מאמץ חשיבה, עדיין רצה כך. קריאות מודל של סוגי רכיבים אחרים ממשיכות להשתמש בגיבוי הרגיל שלהן.

מה הרצה מתוזמנת מריצה

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

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

פתרון בעיות

• הרכיב מציג את הסטטוס מושהה. המתג כבוי. הפעילו אותו בחלונית ההגדרות או בכפתור התזמון שבסרגל העליון.
• הרכיב מציג את הסטטוס לא ירוץ. יש כלל שלא יכול לרוץ, כגון כלל cron בלי ביטוי או כלל שבועי בלי יום בשבוע. או שהשרת לא מכיר את אזור הזמן. תקנו את הבעיה ושמרו שוב.
• ההרצות מתחילות בשעה הלא נכונה. בדקו את ההגדרה אזור זמן. כשהיא ריקה, הכללים מחושבים לפי UTC.
• Nodaro דילג על הרצה. ההרצה הקודמת של התהליך עדיין רצה באותה דקה.
• תזמון ישן הפסיק לרוץ. תזמון שנשמר לפני שהיו כללים נפתח כשהוא כבר כתוב ככללים, והוא מתחיל מושהה. הפעילו אותו. ההרצות שלו מתיישרות עכשיו לפי השעון, ולכן ״כל 5 דקות״ פירושו :00, :05, :10 וכן הלאה.

דרך ה-API

הנתיב GET /v1/workflows/<id>/triggers מחזיר את רשימת הטריגרים של תהליך. התצורה של תזמון משתמשת באותם כללים כמו הרכיב, עם kind, every, hour, minute, weekdays (0 הוא יום ראשון, 6 הוא שבת), dayOfMonth ו-cron; בנוסף אפשר לשלוח timezone, maxExecutions ומדיניות retry מהצורה { afterMinutes, maxAttempts, cheapLanesOnly }, שבה כל שדה אופציונלי, עם ברירות המחדל שלמעלה. בבקשת PATCH, הערך "retry": null מכבה את הניסיונות החוזרים. הנתיב GET /v1/workflows/<id>/executions מציג ניסיון חוזר עם retry: { attempt, maxAttempts, retryOf }. כדי להשהות תזמון, השתמשו במתג של הרכיב: השהיה שנשלחת עם PATCH /v1/workflow-triggers/<id> נמשכת רק עד השמירה הבאה של התהליך. תזמון שנוצר ישירות דרך ה-API לא שייך לשום רכיב, וכשיש בתהליך שני רכיבי טריגר מתוזמן, תזמון כזה מריץ את התהליך כולו. ראו את דף ה-API Webhooks.