תהליכי עבודה
פלטפורמת הליבהworkflow_definitions_readתהליכי עבודהקורא את האוטומציות של תהליכי העבודה של מתקן: תהליכי העבודה, הגרף המלא של תהליך עבודה אחד, סוגי הצמתים שגרף יכול להשתמש בהם ותבניות נבחרות. קראו את node_types לפני בנייה או עריכה של גרף, כדי שכל סוג וכל פרמטר יהיו תקפים במתקן.
פעולות:
- list: רשימת תהליכי עבודה. כל תהליך עבודה עם ציון האם הוא פעיל, הגרסה שפורסמה, מספר ההרצות, ההרצה האחרונה והצמתים שלו (id, name, type). תהליכי עבודה של מותג ושל ארגון אינם מופיעים ברשימה.
- get: קבלת תהליך עבודה. גרף הטיוטה המלא (צמתים, חיבורים, הערות, הגדרות) ו-meta: active, publishedVersionId ולאחר הפרסום גם publishedWorkflow, הגרף שפעיל כעת. רק תהליכי עבודה של מתקן זה. דורש workflowId.
- node_types: סוגי צמתים. פריטי לוח הכלים עם type, label, category, outputs (ענפים) ו-inputSchema, הפרמטרים שיש למלא. available הוא false, עם הסיבה, כשחסר למתקן מודול שהצומת צריך. כלי MCP מופיעים כצמתי mcp.
. . - templates: תבניות. נקודות התחלה לאוטומציות נפוצות, עם risk ו-riskNote (מה משתבש אם מפרסמים בלי זהירות), סוגי צמתים, מודולים נדרשים, זמינות במתקן זה וגרף לתצוגה מקדימה. הפכו תבנית לגרף באמצעות workflow_definitions_write instantiate_template.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
action* | "list" | "get" | "node_types" | "templates" | מה לעשות; כל פעולה מתוארת בתיאור הכלי. |
limit | integer | פריטים בעמוד (ברירת מחדל 25, לכל היותר 100) (list, node_types, templates) |
cursor | string | nextCursor מהעמוד הקודם (list, node_types, templates) |
facilityId | string | מזהה המתקן. אופציונלי כשהמתקן המחובר הוא המתקן שאליו אתם מתכוונים. |
workflowId | string | מזהה תהליך העבודה מ-workflow_definitions_read list (get) |
query | string | מילים לחיפוש בסוג, בתווית, בתיאור או במונחי החיפוש (node_types) |
category | string | רק הקטגוריה הזו: trigger, action, logic או ai (node_types) |
types | array | סוגים מדויקים לתיאור, לדוגמה אלה שבתהליך עבודה שאתם עורכים. כולל סוגים שהוצאו משימוש ושלוח הכלים כבר אינו מציג; מתעלם מ-query ומ-category. (node_types) |
workflow_definitions_writeתהליכי עבודהיוצר, עורך, מפרסם, עוצר ומוחק את האוטומציות של תהליכי העבודה של מתקן. מחזור העבודה: קראו את node_types באמצעות workflow_definitions_read, בנו את הגרף (או התחילו מ-instantiate_template), צרו אותו כטיוטה, נסו אותו באמצעות workflow_runs_write test (בסימולציה), ולאחר מכן פרסמו. עריכות בטיוטה לעולם אינן משנות את מה שפעיל עד שהיא מתפרסמת.
פעולות:
- create: יצירת תהליך עבודה. שומר טיוטה חדשה ולא פעילה מגרף מלא עם צומת אחד לפחות; ברירת המחדל של name היא "Untitled workflow". בעיות אימות מוחזרות ב-errors עם פרטי הצומת. דורש nodes.
- update: שמירת טיוטה. מחליף את כל הטיוטה: שלחו כל צומת וכל חיבור, לא רק את השינויים. מה שפעיל ממשיך לרוץ עד שאתם מפרסמים. בעיות אימות מוחזרות ב-errors עם פרטי הצומת. דורש workflowId, nodes.
- patch_meta: שינוי שם. משנה רק את השם או את התיאור; הגרף ומה שפעיל נשארים כפי שהם. changed הוא false כששניהם כבר תואמים. דורש workflowId.
- duplicate: שכפול. מעתיק תהליך עבודה לטיוטה חדשה בשם "
(copy)" עם מזהי צמתים חדשים, שלעולם אינה מפורסמת או פעילה. המקור אינו משתנה. דורש workflowId. - delete: מחיקה. מוחק את תהליך העבודה לצמיתות: הטיוטה, הגרסאות שפורסמו, היסטוריית ההרצות וניתוב הטריגרים. set_active false עוצר אותו אך שומר אותו; discard_draft רק מאפס עריכות בטיוטה. דורש workflowId. מבקש אישור.
- discard_draft: ביטול עריכות בטיוטה. מאפס את הטיוטה לגרסה האחרונה שפורסמה ומשליך את העריכות שבוצעו מאז. הגרסה הפעילה לעולם אינה מושפעת; נדרשת גרסה שפורסמה. דורש workflowId. מבקש אישור.
- publish: פרסום. מאמת את הטיוטה, שומר אותה כגרסה הפעילה ומפעיל את תהליך העבודה, כך שהטריגרים שלו מופעלים והפעולות שלו רצות באמת. הרצות שנמצאות בתהליך מסתיימות בגרסה הישנה. אם התזמון של שלבי Delay ממתינים ישתנה, התוצאה כוללת את הקוד WAIT_RETARGET_CONFIRMATION_REQUIRED ו-impacts: קראו שוב עם confirmWaitRetargets ועם ה-impacts האלה. דורש workflowId. מבקש אישור.
- set_active: הפעלה או כיבוי. active true מפעיל מחדש תהליך עבודה שפורסם. active false עוצר אותו: הטריגרים מפסיקים לפעול ושלבי Delay ממתינים מבוטלים כך שלעולם אינם מסתיימים. דבר אינו נמחק. מבקש אישור תחילה, אלא אם תהליך העבודה כבר במצב הזה. דורש workflowId, active. עשוי לבקש אישור.
- instantiate_template: גרף מתבנית. הופך תבנית לגרף מוכן ל-create: { name, description, nodes, connections } עם מזהי צמתים חדשים. תבניות משאירות בכוונה נמענים, דלתות ושעות ריקים; מלאו אותם תחילה. אינו שומר דבר. דורש templateId.
- generate: יצירת גרף. בונה גרף מהנחיה בשפה פשוטה באמצעות ה-AI של המתקן ומחזיר { name, description, nodes, connections } תוך שימוש בסוגי צמתים תקפים בלבד. העבירו workflow כדי לשפר תהליך עבודה קיים; הגרף המשופר המלא מוחזר. אינו שומר דבר, אך מנצל את קרדיטי ה-AI של המתקן. דורש prompt. מבקש אישור.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
action* | "create" | "update" | "patch_meta" | "duplicate" | "delete" | "discard_draft" | "publish" | "set_active" | "instantiate_template" | "generate" | מה לעשות; כל פעולה מתוארת בתיאור הכלי. |
name | string | שם תהליך העבודה (create, update, patch_meta) |
description | string | מה תהליך העבודה עושה (create, update, patch_meta) |
nodes | array | כל צומת: { id, name, type, position, parameters }. הסוגים והפרמטרים מגיעים מ-workflow_definitions_read node_types. (create, update) |
connections | object | חיבורים לפי שם צומת המקור; יכול להיות ריק עבור צומת יחיד (create, update) |
notes | array | הערות על לוח העבודה (create, update) |
settings | object | הגדרות תהליך העבודה (create, update) |
facilityId | string | מזהה המתקן. אופציונלי כשהמתקן המחובר הוא המתקן שאליו אתם מתכוונים. |
workflowId | string | מזהה תהליך העבודה מ-workflow_definitions_read list (update, patch_meta, duplicate, delete, discard_draft, publish, set_active) |
confirmWaitRetargets | boolean | תזמון מחדש של שלבי ה-Delay הממתינים שמפורטים ב-impacts של התוצאה הקודמת (publish) |
confirmedWaitRetargets | array | ה-impacts מהתוצאה WAIT_RETARGET_CONFIRMATION_REQUIRED, שנשלחים בחזרה ללא שינוי (publish) |
active | boolean | true כדי להפעיל, false כדי לעצור (set_active) |
templateId | string | מזהה התבנית מ-workflow_definitions_read templates (instantiate_template) |
prompt | string | מה תהליך העבודה אמור לעשות (generate) |
workflow | object | תהליך עבודה מלא מ-workflow_definitions_read get, לשיפור במקום להתחיל מאפס (generate) |
confirm | boolean | הגדירו רק לאחר שהמשתמש אישר את התצוגה המקדימה שהוחזרה בקריאה הראשונה |
workflow_runs_readתהליכי עבודההיסטוריית ההרצות של תהליך עבודה, מהחדשה לישנה, והרצה אחת שלב אחר שלב. השתמשו בו כדי לבדוק אם אוטומציה רצה, לעקוב אחר הרצה שהתחילה באמצעות workflow_runs_write, או לגלות איזה צומת נכשל ומדוע.
פעולות:
- list: רשימת הרצות. כל הרצה עם הסטטוס, המצב (live או test), תופעות הלוואי, הטריגר, מי הפעיל אותה, הזמנים, מספר השלבים, הצומת שהיא ממתינה לו וכל שגיאה. דורש workflowId.
- get: קבלת הרצה. סטטוס ההרצה וכל השלבים לפי הסדר, עם הקלט, הפלט, ההערה והשגיאה של כל צומת. ההרצות הן אסינכרוניות: הרצה עם Delays ממתינה עד שמגיע מועד ההמשך שלה. דורש workflowId, executionId.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
action* | "list" | "get" | מה לעשות; כל פעולה מתוארת בתיאור הכלי. |
workflowId | string | מזהה תהליך העבודה מ-workflow_definitions_read list |
limit | integer | פריטים לעמוד (ברירת מחדל 25, לכל היותר 100) (list) |
cursor | string | nextCursor מהעמוד הקודם (list) |
facilityId | string | מזהה המתקן. אופציונלי כשהמתקן המחובר הוא המתקן שאליו אתם מתכוונים. |
executionId | string | מזהה ההרצה מ-workflow_runs_read list (get) |
workflow_runs_writeתהליכי עבודהמתחיל, מריץ בבדיקה, מבטל ומריץ מחדש הרצות של תהליכי עבודה. העדיפו את test, שמריץ את הטיוטה עם תופעות לוואי בסימולציה; run מריץ את תהליך העבודה שפורסם באמת. ההרצות הן אסינכרוניות: עקבו אחריהן באמצעות workflow_runs_read get.
פעולות:
- run: הרצה עכשיו. מריץ את תהליך העבודה שפורסם מהטריגר הידני שלו (custom.manualTrigger), עם תופעות לוואי אמיתיות. טריגרים מתוזמנים, טריגרים של webhook וטריגרים של אירועים מופעלים מעצמם. מחזיר את ה-executionId של ההרצה ואת הסטטוס הראשון. דורש workflowId. מבקש אישור.
- test: בדיקת טיוטה. מריץ את הטיוטה השמורה בלי לפרסם אותה, ונרשם כהרצת בדיקה. תופעות הלוואי מדומות כברירת מחדל: דבר אינו נשלח או מופעל, וכל צומת מדווח מה הוא היה עושה. sideEffects live מבקש אישור תחילה. דורש workflowId. עשוי לבקש אישור.
- cancel: ביטול הרצה ממתינה. מבטל הרצה שממתינה ל-Delay: ההמתנות הממתינות שלה נסגרות והשלבים שאחריהן לעולם אינם רצים. לא ניתן לבטל הרצות שהסתיימו והרצות שנמצאות באמצע שלב. דורש workflowId, executionId. מבקש אישור.
- retry: הרצה חוזרת. מריץ מחדש הרצה שהסתיימה מקלט הטריגר שנרשם עבורה, ומקושר אליה דרך retryOf. published (ברירת מחדל) מריץ מחדש באמת את הגרסה שבה השתמשה ומבקש אישור תחילה; draft-test מריץ את הטיוטה הנוכחית בסימולציה, הבחירה הנכונה בזמן תיקון כשל. דורש workflowId, executionId. עשוי לבקש אישור.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
action* | "run" | "test" | "cancel" | "retry" | מה לעשות; כל פעולה מתוארת בתיאור הכלי. |
workflowId | string | מזהה תהליך העבודה מ-workflow_definitions_read list |
nodeId | string | מזהה צומת הטריגר שממנו יש להתחיל; השמיטו עבור הטריגר הידני (run, test) |
payload | object | קלט עבור הצמתים שאחרי הטריגר, לדוגמה { "visitorName": "Ada" } (run, test) |
facilityId | string | מזהה המתקן. אופציונלי כשהמתקן המחובר הוא המתקן שאליו אתם מתכוונים. |
sideEffects | "simulate" | "live" | האם פעולות הצמתים מתבצעות באמת (test) |
executionId | string | מזהה ההרצה מ-workflow_runs_read list (cancel, retry) |
mode | "published" | "draft-test" | מול מה להריץ מחדש (retry) |
confirm | boolean | הגדירו רק לאחר שהמשתמש אישר את התצוגה המקדימה שהוחזרה בקריאה הראשונה |