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

אוטומציות Rex

אוטומציות Rex הופכות משהו שביקשתם מ-Rex, הסוכן של Zaprex, למשהו שרץ לבד. כל אוטומציה נבנית על קנבס חזותי: טריגר (תזמון, pull request, CI שנכשל, הודעת Slack, webhook או Run now) וצעדים (משימות Rex, בדיקות יעד, הסתעפויות If, בקשות HTTP, התראות, המתנות ו-workflows של n8n), מחוברים משמאל לימין. כל צעד מציג סטטוס ולוגים משלו בזמן שהוא רץ. האוטומציות רצות בענן, כך שהן ממשיכות לעבוד גם כשהאפליקציות סגורות.

קנבס האוטומציות של Rex אחרי הרצה: ‏Run now,‏ Rex task,‏ Goal check ו-Notify me מחוברים, כולם Succeeded, בדיקת היעד בניסיון 2 והלוגים שלה בחלונית הצדקנבס האוטומציות של Rex אחרי הרצה: ‏Run now,‏ Rex task,‏ Goal check ו-Notify me מחוברים, כולם Succeeded, בדיקת היעד בניסיון 2 והלוגים שלה בחלונית הצד
קנבס האוטומציות של Rex אחרי הרצה: ‏Run now,‏ Rex task,‏ Goal check ו-Notify me מחוברים, כולם Succeeded, בדיקת היעד בניסיון 2 והלוגים שלה בחלונית הצד

הפעלה

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

  • בצ׳אט: כשמבקשים שמשהו יקרה לבד (כל לילה…, בכל פעם שה-CI נכשל…, תעשה אוטומציה…), מופיעה שורה קטנה מתחת לתשובה של Rex עם Turn on ו-×. ‏Turn on פותח קנבס שמתחיל מההודעה שלכם. ‏**×** מסתיר אותה לתמיד.
  • סרגל הכלים: אייקון ה-workflow ליד האווטאר של Rex. כשהאוטומציות כבויות, לחיצה אחת מפעילה ופותחת אותן.
  • תפריט +: ה-+ ליד תיבת ההודעה, ואז New automation.
  • Settings › Features › Automations: מתג ההפעלה ו-Open.
  • לוח הפקודות: ‏⌘K ‏(Ctrl+K), ואז Turn on Automations (או Open Automations כשהן כבר פועלות) או New automation.
  • אפליקציית המחשב: File › New Automation ‏(⇧⌘A) או View › Automations.
  • אפליקציות הטלפון: אותם כפתורים, או הקישור zaprex://app?automation=new.
שורה קטנה מתחת לתשובה של Zaprex: ‏Want this to run on its own? Turn on Automations to build it on a canvas, עם Turn on ו-×שורה קטנה מתחת לתשובה של Zaprex: ‏Want this to run on its own? Turn on Automations to build it on a canvas, עם Turn on ו-×
שורה קטנה מתחת לתשובה של Zaprex: ‏Want this to run on its own? Turn on Automations to build it on a canvas, עם Turn on ו-×
תפריט ה-+ ליד תיבת ההודעה של Zaprex: ‏Attach files or images ו-New automation עם תגית Betaתפריט ה-+ ליד תיבת ההודעה של Zaprex: ‏Attach files or images ו-New automation עם תגית Beta
תפריט ה-+ ליד תיבת ההודעה של Zaprex: ‏Attach files or images ו-New automation עם תגית Beta
‏Settings › Features ב-Zaprex: ‏Automations עם תגית Beta, מתג ההפעלה, Open ו-How it works, מעל Suggest extensions in chat‏Settings › Features ב-Zaprex: ‏Automations עם תגית Beta, מתג ההפעלה, Open ו-How it works, מעל Suggest extensions in chat
‏Settings › Features ב-Zaprex: ‏Automations עם תגית Beta, מתג ההפעלה, Open ו-How it works, מעל Suggest extensions in chat

האוטומציות שלכם

מסך Automations מציג את האוטומציות שלכם עם הטריגר, ההרצה האחרונה ומתג הפעלה, ויוצר חדשות מתבנית: Fix CI when it fails,‏ Nightly maintenance,‏ Review new pull requests ו-Webhook to n8n. ‏Import from n8n והגשר ל-n8n נמצאים באותו מסך.

מסך Automations: אוטומציה אחת עם הטריגר וההרצה האחרונה, התבניות, Import from n8n ו-New automationמסך Automations: אוטומציה אחת עם הטריגר וההרצה האחרונה, התבניות, Import from n8n ו-New automation
מסך Automations: אוטומציה אחת עם הטריגר וההרצה האחרונה, התבניות, Import from n8n ו-New automation

בנייה על הקנבס

  • הוספת צעד: גוררים אותו מהפלטה אל הקנבס, או מקישים עליו כדי להוסיף אותו אחרי הצעד הנבחר, כבר מחובר.
  • חיבור: גוררים מהקצה הימני של צעד (פורט היציאה שלו) אל צעד אחר. בטלפון מקישים על הפורט ואז על הצעד. ל-If יש שני פורטים, true ו-false.
  • עריכה: בוחרים צעד כדי לערוך את התווית וההגדרות שלו בחלונית הצד. הגדרות חובה מסומנות ב-*.
  • מחיקה: בוחרים צעד או חיבור ולוחצים Delete או Backspace, או משתמשים בכפתור הפח.
  • תנועה: גוררים את הרקע או גוללים כדי להזיז את התצוגה, ‏⌘ או Ctrl + גלילה (או צביטה) לזום, הכפתורים −, + והתאמה, או לחיצה על המפה הקטנה כדי לקפוץ לשם.
בניית אוטומציה: פלטת הטריגרים והצעדים, ארבעה צעדים מחוברים על הקנבס, המפה הקטנה וההגדרות של Notify me בחלונית הצדבניית אוטומציה: פלטת הטריגרים והצעדים, ארבעה צעדים מחוברים על הקנבס, המפה הקטנה וההגדרות של Notify me בחלונית הצד
בניית אוטומציה: פלטת הטריגרים והצעדים, ארבעה צעדים מחוברים על הקנבס, המפה הקטנה וההגדרות של Notify me בחלונית הצד

בטלפון, הפלטה נגללת מעל הקנבס וחלונית הצד נמצאת מתחתיו.

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

טריגרים

טריגרמפעיל את האוטומציה כאשר
Run nowלוחצים Run
Scheduleתזמון cron מגיע (לכל היותר כל 5 דקות, באזור הזמן שלכם)
Pull requestpull request נפתח, נפתח מחדש או מסומן כמוכן לסקירה
Commentמישהו מזכיר את הבוט בתגובה ב-pull request או ב-issue
CI failureworkflow או check של GitHub Actions נכשל
Slack messageהודעה או פקודת /ingot מגיעה לאפליקציית ה-Slack שלכם
Webhookהשירות שלכם קורא לכתובת ה-webhook הפרטית של האוטומציה

צעדים

צעדמה הוא עושה
Rex task‏Rex עובד על המשימה בארגז החול שלו בענן ופותח PR טיוטה כשהוא משנה קוד
Goal checkפקודה שחייבת לעבור; כל עוד היא נכשלת, משימת ה-Rex שלפניה מנסה שוב עם הפלט (3 ניסיונות כברירת מחדל, עד 20)
Ifשולח את ההרצה להסתעפות true או false
HTTP requestקורא לכתובת HTTPS ציבורית (כתובות פנימיות נחסמות)
Notify meהתראה של Rex, ואימייל אם הפעלתם אותם
Waitממתין עד 5 דקות לפני הצעד הבא
n8n workflowמריץ workflow ב-n8n שלכם דרך הגשר

בהגדרות אפשר להשתמש ב-{{title}},‏ {{branch}},‏ {{body}} ובשאר שדות הטריגר, וב-{{output}} מהצעד הקודם.

בדיקה ושמירה

כפתור המגן בסרגל הכלים מציג Valid, או כמה בעיות יש. לחיצה עליו מציגה את כל הבעיות: טריגר חסר, צעד לא מחובר, בדיקת יעד שלא באה אחרי משימת Rex, cron שרץ לעתים קרובות מדי. לחיצה על בעיה בוחרת את הצעד שלה. ‏Save חסום עד שאין שגיאות. המתג On משהה אוטומציה בלי למחוק אותה.

בדיקת יעד שמחוברת ישירות ל-Run now, מסומנת בשגיאה, והבעיה בחלונית הצד: ‏Goal check must come right after a Rex taskבדיקת יעד שמחוברת ישירות ל-Run now, מסומנת בשגיאה, והבעיה בחלונית הצד: ‏Goal check must come right after a Rex task
בדיקת יעד שמחוברת ישירות ל-Run now, מסומנת בשגיאה, והבעיה בחלונית הצד: ‏Goal check must come right after a Rex task

הרצה ומעקב אחרי כל צעד

‏Run שומר את השינויים ומתחיל הרצה. כל צעד מציג את הסטטוס שלו על הקנבס בזמן שהוא רץ:

  • ‏Running (כחול), Succeeded (ירוק), Failed (אדום), Skipped (אפור, להסתעפות ש-If לא בחר).
  • צעד שרץ יותר מפעם אחת מציג את מספר הניסיון, למשל Succeeded · try 2.
  • החיבורים שההרצה עברה בהם מודגשים, והמפה הקטנה מציגה את אותם צבעים.

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

ההרצה האחרונה של בדיקת יעד בחלונית הצד: ‏Succeeded בניסיון 2,‏ npm test passed והלוגים עם הניסיון הראשון שנכשלההרצה האחרונה של בדיקת יעד בחלונית הצד: ‏Succeeded בניסיון 2,‏ npm test passed והלוגים עם הניסיון הראשון שנכשל
ההרצה האחרונה של בדיקת יעד בחלונית הצד: ‏Succeeded בניסיון 2,‏ npm test passed והלוגים עם הניסיון הראשון שנכשל

הלשונית Runs מציגה הרצות קודמות. בוחרים אחת כדי לראות את הקנבס כפי שהיה באותה הרצה.

הלשונית Runs: הרצה אחת שמסומנת Goal met עם השעה ומשך הזמןהלשונית Runs: הרצה אחת שמסומנת Goal met עם השעה ומשך הזמן
הלשונית Runs: הרצה אחת שמסומנת Goal met עם השעה ומשך הזמן

ייבוא מ-n8n

‏Import from n8n במסך Automations (או Automation › Import an n8n workflow בעורך) מקבל ייצוא של workflow מ-n8n: מדביקים את ה-JSON או בוחרים את הקובץ. הייבוא מחליף את הקנבס.

  • טריגרים וצעדים שיש ל-Rex הופכים לצעדי Rex: ידני, תזמון, webhook,‏ GitHub,‏ If,‏ HTTP request,‏ Wait, סוכני AI ‏(Rex task) והודעות (Slack, אימייל, Teams ודומיהם הופכים ל-Notify me).
  • צמתי עזר (Set,‏ Code,‏ Merge,‏ No-op, פתקים) מוסרים והשכנים שלהם מתחברים.
  • כל השאר הופך לצעד n8n workflow, כך שהוא עדיין רץ ב-n8n שלכם.

אחרי הייבוא מוצג כל שינוי, כדי שתוכלו לבדוק לפני השמירה.

‏workflow מ-n8n שיובא לקנבס: ‏Webhook,‏ If עם הסתעפויות true ו-false,‏ Rex task,‏ Notify me וצעד n8n workflow עבור צומת Google Sheets, עם הערות הייבוא‏workflow מ-n8n שיובא לקנבס: ‏Webhook,‏ If עם הסתעפויות true ו-false,‏ Rex task,‏ Notify me וצעד n8n workflow עבור צומת Google Sheets, עם הערות הייבוא
‏workflow מ-n8n שיובא לקנבס: ‏Webhook,‏ If עם הסתעפויות true ו-false,‏ Rex task,‏ Notify me וצעד n8n workflow עבור צומת Google Sheets, עם הערות הייבוא

הגשר ל-n8n

מחברים את ה-n8n שלכם פעם אחת כדי להריץ צעדי n8n workflow: ‏Automations › n8n bridge, ואז כתובת ה-n8n ומפתח API של n8n (ב-n8n: ‏Settings › n8n API). ‏Rex בודק את שניהם מול ה-n8n שלכם לפני השמירה. המפתח נשמר מוצפן בשרת ולא מוצג שוב. ‏Disconnect מוחק אותו.

הגשר ל-n8n במסך Automations: כתובת ה-n8n ממולאת, שדה מפתח ה-API ו-Connectהגשר ל-n8n במסך Automations: כתובת ה-n8n ממולאת, שדה מפתח ה-API ו-Connect
הגשר ל-n8n במסך Automations: כתובת ה-n8n ממולאת, שדה מפתח ה-API ו-Connect
הגשר ל-n8n מחובר: כתובת ה-n8n עם Connected ו-Disconnectהגשר ל-n8n מחובר: כתובת ה-n8n עם Connected ו-Disconnect
הגשר ל-n8n מחובר: כתובת ה-n8n עם Connected ו-Disconnect

צעד n8n workflow קורא לנתיב ה-production של צומת ה-Webhook ב-workflow (למשל rex-deploy) עם הטריגר והפלט הקודם. כש-Wait for the result מופעל, התשובה של ה-workflow הופכת לפלט של הצעד.

באפליקציית המחשב

‏File › New Automation פותח קנבס חדש באפליקציית Zaprex למחשב, ו-View › Automations פותח את הרשימה. שניהם מפעילים את האוטומציות.

אפליקציית Zaprex למחשב עם אוטומציה פתוחה: שלושה צעדים מחוברים עם Succeeded והלוגים של ה-Rex taskאפליקציית Zaprex למחשב עם אוטומציה פתוחה: שלושה צעדים מחוברים עם Succeeded והלוגים של ה-Rex task
אפליקציית Zaprex למחשב עם אוטומציה פתוחה: שלושה צעדים מחוברים עם Succeeded והלוגים של ה-Rex task

מגבלות

עד 60 צעדים ו-120 חיבורים לאוטומציה, וכמה אוטומציות שהתוכנית שלכם מאפשרת. משימות Rex משתמשות בדקות ה-Zaprex של התוכנית כמו כל משימה אחרת. אוטומציות דורשות תוכנית עם סוכני ענן.

הגדרות

הגדרהברירת מחדלמה היא עושה
Automationsכבוימציג את Automations בסרגל הכלים, בתפריט ה-+ ובלוח הפקודות. כיבוי מסתיר אותם; אוטומציות שמורות ממשיכות לרוץ בענן עד שמשהים או מוחקים אותן.
Suggest extensions in chatפועלמציג את שורת ההצעה מתחת לתשובה כשתכונה או הרחבה יכולות לעזור, כמו Automations כשרוצים שמשהו ירוץ לבד. הצעה שנסגרה לא חוזרת.
n8n bridgeלא מחוברכתובת ה-n8n ומפתח ה-API שלכם עבור צעדי n8n workflow. המפתח נשמר מוצפן ולא מוצג שוב.

ההגדרות האלה מופיעות גם במדריך ההגדרות.

למפתחים

הקנבס משתמש ב-API של הזרימות: ‏/api/bot/automations/flows לרשימה, יצירה, עדכון ומחיקה, ‏/flows/:id/run להתחלת הרצה, ‏/flows/:id/fires ו-/automations/fires/:fireId להרצות עם הסטטוס והלוגים של כל צעד, ו-/automations/n8n לגשר. ראו API › זרימות.

פתרון בעיות

  • ‏Save חסום: לוחצים על כפתור המגן ומתקנים את השגיאות ברשימה.
  • ‏Connect your n8n first: מחברים את הגשר ומריצים שוב.
  • צעד נכשל: בוחרים אותו כדי לקרוא את הלוגים, משנים ולוחצים Run שוב.

Beta אוטומציות Rex נמצאות בבטא. ספרו לנו אילו טריגרים וצעדים להוסיף בעמוד התמיכה.

ראו גם אוטומציות בתיעוד של Zaprex ואוטומציות עבור קובצי אוטומציה שנשמרים במאגר.