עבודה ב־Plan Studio

מדריך זה מסביר איך לעבוד עם תוכניות ב־Plan Studio. להסבר מהם תזמור ומסמכי תוכנית, ראו תזמור ושימוש במצב תוכנית.

פתיחת תוכנית

תוכנית שייכת לשיחה שהפיקה אותה, ולכן שם תגיעו אליה בדרך כלל: לשורה של התוכנית בשיחה יש פעולת פתיחה, ו־Plan Studio נפתח כלשונית עורך לצד השיחה.

המרכז מציג שלושה מקטעים:

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

לחצו על כרטיס כדי לפתוח אותו ב־Plan Studio. הנתיב הוא /workspaces/<workspace-id>/plans/<kind>/<plan-id>, כאשר kind הוא orchestration או document, כך שאפשר לקשר ישירות גם תוכנית בודדת.

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

עריכת ה־DAG

אפשר לערוך תזמור כל עוד הוא proposed. כל עריכות הקנבס מבוצעות במקלדת:

לחצו על הקנבס, ואז הזיזו את הבחירה עם מקשי החצים.
הקישו n כדי להוסיף שלב. הוא מופיע כשהוא נבחר, בשם “שלב חדש”; שנו את שמו בלוח הצומת מימין.
הקישו e על השלב שחייב לרוץ ראשון, ואז לחצו על השלב התלוי (או בחרו אותו והקישו Enter) כדי לחבר תלות. הקישו Esc כדי לנטוש חיבור ממתין.
הקישו x כדי לחתוך את התלות החדשה ביותר של השלב הנבחר, או החליפו תלויות מדויקות בעורך התלויות שבלוח הצומת.
הקישו Delete כדי להסיר את השלב הנבחר; ההפניות אליו מוסרות מהתלויות של שאר השלבים.

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

רק שלבי עבודה ניתנים לעריכה. צמתים מבניים — מחקר, דיון וסינתזה — הם לקריאה בלבד, וכך גם כל שלב שעבודתו כבר רצה (הוא מסומן “כבר בוצע”, כי עריכתו תפצל את התוכנית).

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

קריאת אומדני עלות, זמן וסיכון

לחצו על חישוב אומדן בסרגל האישור.

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

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

תקרת התקציב היא השוואה לתצוגה מול האומדן הזה. שום דבר לא אוכף אותה מרגע שהתוכנית רצה — ראו ניהול עלויות לפקדים שבאמת עוצרים הוצאה.

השוואת גרסה מול הצעה קודמת

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

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

propose_orchestration והעורך גם יחד דוחים שינויים ברגע שהתוכנית אינה עוד proposed, כך שהרצה בעיצומה אינה קולטת תכנון מחדש באמצע ההרצה.

אישור, דחייה או הרחבה של תוכנית

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

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

ברגע שתזמור נמצא בביצוע, הסרגל משתנה:

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

שלבים שמחוץ לקבוצת אישור חלקית מוצגים כדחויים ואינם רצים עד שתרחיבו את הקבוצה.

הרצת פלייבוק עם פרמטרים

פלייבוק הוא תבנית תוכנית שמורה עם מצייני מקום בעלי טיפוס {{param}} במטרה, בכותרות השלבים, בתיאורים ובהנחיות שלו. ההחלפה היא מילולית — אין שפת ביטויים; אם אתם צריכים לוגיקה, השתמשו בפייפליין במקום.

במקטע פלייבוקים שבמרכז, לחצו על הרצה בפלייבוק (או פתחו את לוח הפקודות ⌘K ובחרו שם את הפלייבוק).
מלאו את הפרמטרים. פרמטרי מנייה מוצגים כרשימות נפתחות; פרמטרי מאגר וסוכן מקבלים הפניה למאגר או לסוכן; פרמטרים אופציונליים נופלים חזרה לברירת המחדל שלהם.
בחרו את כרטיס העוגן שהתוכנית מוצעת כנגדו, ואז אשרו.

הרצת פלייבוק רק מציעה תוכנית — התזמור המיוצר נפתח ב־Plan Studio כ־proposed ושום דבר לא מבוצע עד שתאשרו אותו שם. כדי להסיר פלייבוק, לחצו על סמל האשפה בכרטיס שלו.

סוכנים יוצרים ומריצים פלייבוקים עם כלי MCP ‏create_playbook ו־run_playbook; ראו עזר כלי MCP.

מדריכים קשורים

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

מושגים קשורים

תזמור