אוטומציות

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

ארבע דרכים להתחיל הרצה

מה רץ בהרצה שמתחילה מטריגר

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

״מחובר״ כולל חיבור שמצויר על הקנבס, חברות ברכיב קבוצה ושדה שקורא את הערך של רכיב אחר.

דוגמה: סרטון חדשות יומי

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

כמה עולה כל הרצה. רוב המחיר הולך על הסרטון: 165 קרדיטים לקליפ של 8 שניות ב-VEO 3.1 Fast. קריאת הפיד מוסיפה 11 קרדיטים, הפרסום מוסיף 11 קרדיטים, ושני רכיבי יצירת טקסט - כל LLM מוסיפים כמה קרדיטים. בדקו את הסכום הכולל בכפתור הרצת התהליך לפני שאתם מפעילים את התזמון.

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

טריגר מתוזמן

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

הגדרת תזמון

1. הוסיפו אוטומציה › טריגרים › טריגר מתוזמן.
2. לחצו על אחת הערכות (כל 5 דקות, כל שעה, כל יום ב-9:00 או ימי חול ב-9:00), או בנו כללים משלכם.
3. בחרו אזור זמן. אם לא בוחרים אזור זמן, הכללים מחושבים לפי UTC.
4. שמרו את התהליך, ואז הפעילו את התזמון.

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

כללים

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

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

איך תזמון רץ

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

טריגר Webhook

Webhook מאפשר למערכת אחרת להתחיל את התהליך בשליחת בקשת HTTP לכתובת פרטית. למשל, טופס או חנות יכולים לקרוא לו כשנכנס משהו חדש.

1. הוסיפו אוטומציה › טריגרים › טריגר Webhook.
2. תחת פרמטרי פלט, הוסיפו את הערכים שהתהליך מצפה להם. לכל ערך יש שם, שהוא המפתח בגוף ה-JSON של הבקשה, וסוג: טקסט, כתובת תמונה, כתובת וידאו או כתובת אודיו. הסוג מאפשר לרכיבים שבהמשך להשתמש בערך בצורה נכונה.
3. שמרו את התהליך. השמירה יוצרת את ה-Webhook. סמנו את הרכיב והעתיקו את הכתובת המלאה תחת כתובת Webhook בחלונית ההגדרות שלו. הרכיב שעל הקנבס מציג את הכתובת עם האסימון מקוצר.
4. שלחו בקשת POST עם גוף JSON לכתובת הזאת.

curl -X POST "<your Webhook URL>" \
  -H "Content-Type: application/json" \
  -d '{"topic": "our new running shoe", "imageUrl": "https://example.com/shoe.jpg"}'

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

כלי אוטומציה קוראים לאותה כתובת, ורכיב פלט Webhook שולח אליהם את התוצאה בחזרה. מדריכים מפורטים: n8n, Make ו-Zapier.

טריגר טלגרם

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

1. חברו את הבוט שלכם תחת אינטגרציות: הדביקו את האסימון שלו.
2. הוסיפו אוטומציה › טריגרים › טריגר טלגרם ובחרו את הבוט תחת בוט Telegram.
3. אפשר גם להגביל אותו לצ׳אט אחד עם סינון לפי מזהה צ׳אט, ולסוגי הודעות מסוימים תחת סוגי הודעות: טקסט, תמונה, וידאו, אודיו או מסמך.
4. לחצו על הפעלת הטריגר, ואז שמרו את התהליך. הרכיב מציג פעיל — מאזין להודעות כשהוא מוכן.

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

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

התחלת הרצות מה-API

הקוד שלכם יכול להריץ תהליך עם אסימון API מהגדרות › מפתחות API. שלחו את מזהה התהליך ואת ערכי הקלט אל הנתיב POST /v1/api/run. המפתח של כל קלט הוא מזהה הרכיב או התווית הייחודית שלו.

curl -X POST "https://app.nodaro.ai/v1/api/run" \
  -H "Authorization: Bearer $NODARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"workflowId": "<workflow id>", "inputs": {"Text": {"text": "a cat at sunset"}}}'

ההרצה מתחילה מיד ומחזירה מזהה הרצה. בדקו את הסטטוס שלה מדי כמה שניות עד שהיא מסתיימת, ואז קבלו את התוצאות. לתהליכים קצרים, הוסיפו ?wait=true&timeout=120 כדי לחכות לתוצאה באותה בקשה. פסק הזמן יכול להיות עד 600 שניות. ראו את דף ה-API תהליכים. גם עוזרי AI שמחוברים דרך MCP יכולים להריץ את התהליכים שלכם.

שמירה ובדיקה של הרצות ללא השגחה

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

טיפים

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