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


הפעלה
האוטומציות כבויות עד שמפעילים אותן. כל אחת מהדרכים האלה עושה את זה בלחיצה אחת, באפליקציות 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.






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


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


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


טריגרים
| טריגר | מפעיל את האוטומציה כאשר |
|---|---|
| Run now | לוחצים Run |
| Schedule | תזמון cron מגיע (לכל היותר כל 5 דקות, באזור הזמן שלכם) |
| Pull request | pull request נפתח, נפתח מחדש או מסומן כמוכן לסקירה |
| Comment | מישהו מזכיר את הבוט בתגובה ב-pull request או ב-issue |
| CI failure | workflow או 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 שומר את השינויים ומתחיל הרצה. כל צעד מציג את הסטטוס שלו על הקנבס בזמן שהוא רץ:
- Running (כחול), Succeeded (ירוק), Failed (אדום), Skipped (אפור, להסתעפות ש-If לא בחר).
- צעד שרץ יותר מפעם אחת מציג את מספר הניסיון, למשל Succeeded · try 2.
- החיבורים שההרצה עברה בהם מודגשים, והמפה הקטנה מציגה את אותם צבעים.
בוחרים צעד כדי לראות את ההרצה האחרונה שלו: סטטוס, זמן, פלט ולוגים.


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


ייבוא מ-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 שלכם.
אחרי הייבוא מוצג כל שינוי, כדי שתוכלו לבדוק לפני השמירה.


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




צעד n8n workflow קורא לנתיב ה-production של צומת ה-Webhook ב-workflow (למשל rex-deploy) עם הטריגר והפלט הקודם. כש-Wait for the result מופעל, התשובה של ה-workflow הופכת לפלט של הצעד.
באפליקציית המחשב
File › New Automation פותח קנבס חדש באפליקציית Zaprex למחשב, ו-View › Automations פותח את הרשימה. שניהם מפעילים את האוטומציות.


מגבלות
עד 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 ואוטומציות עבור קובצי אוטומציה שנשמרים במאגר.