שימוש במצב תוכנית

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

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

העברת מרחב למצב תכנון

כל אחת מהפעולות האלה מחליפה את המצב של המרחב, והשינוי נשמר:

בחרו תכנון מהתפריט הנפתח של המצב בקצה השמאלי ביותר של סרגל הכלים של תיבת הכתיבה
הקישו Shift+Tab
שלחו /plan. ‏/plan לבדו רק מחמש את המצב; /plan <request> מחמש אותו ושולח את שאר הטקסט כהודעה שלכם

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

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

מה הסוכן מפיק

הוא חוקר בקריאה בלבד — הזיכרון, אינדקס הקוד, קבצים
הוא קורא ל-submit_plan פעם אחת, עם goal ו-nodes, כשכל צומת נושא key יציב, title, description ומפתחות הצמתים שהוא dependsOn (וזה מה שמאפשר לעבודה בלתי־תלויה לרוץ במקביל)
הוא עוצר

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

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

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

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

פרוזה אינה תוצר כאן. הרצה שמסתיימת בלי לקרוא ל-submit_plan מפרסמת בשיחה שורה גלויה “Ended without submitting a plan (no submit_plan call).” ומסמנת את ההרצה ככזו שהחמיצה את התוצר שלה. הסטטוס של ההרצה נשאר במכוון completed — זה משאיר את מכונות המצב של פייפליין ושל כרטיס ללא שינוי — לכן קראו את השורה, ולא את תג הסטטוס.

אישור התוכנית

מהשורה של התוכנית בשיחה, לחצו על אישור והרצה. מסרגל האישור של Plan Studio, לחצו על אישור התוכנית (או דחייה שלצידו; האישור מושבת כשבגרף יש שגיאת אימות).

לאחר מכן:

Control Center מקמפל את התוכנית לתזמור ומממש אותה — הכרטיסים וההרצה. שום מודל אינו מעורב בשלב הזה; הוא דטרמיניסטי
התוכנית רצה כסוכן שכתב אותה. אם לצרף מישהו נוסף הוא החלטה של אותו סוכן בזמן ההרצה — הוא יכול delegate_task שלב לעמית מתאים יותר, בתוך תקרת העומק של ההאצלה של סביבת העבודה
המטרה של התוכנית הופכת למטרת השיחה, והעבודה רצה באותה שיחה: כל שלב מפרסם מה התבקש מהסוכן ומזרים את התור שלו בחזרה, כך שאתם עוקבים אחריו (ויכולים לעצור תור) במקום שבו אתם כבר נמצאים
שורת המטרה בלוח הצד כללי של השיחה (מתחת למטלות) נושאת את התקדמות ההרצה כ-settled/total ואת כפתור העצירה שלה; Plan Studio מציג מצב לכל צומת על הגרף ומאפשר לבטל גם שם

המשך העבודה בלי לאשר

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

כדי לצאת ממצב תכנון, החליפו את התפריט הנפתח של תיבת הכתיבה (או Shift+Tab), או אשרו את התוכנית שהוגשה. exit_plan_mode פותח אישור עמיד המוכרע בכלי ה-MCP ‏decide_approval. שכבת-העל של מעקות הבטיחות לקריאות כלים חסומות היא תור אחר, בזיכרון, ואינה נושאת בקשות יציאה ממצב תכנון.

מצב תכנון בשלב פייפליין

צומת פייפליין מסוג messaging.createSpace קורא את מצב השיחה מהextra ‏mode של תצורת הצומת — extras['mode']: 'plan'. המפתח הוא התאמה מדויקת: כל איות אחר, כולל conversationMode או dispatchMode, מתעלמים ממנו בשקט, והחדר נופל חזרה לברירת המחדל של הגוף, שהיא מצב סקירה, ולא צ’אט. שלב promptAgent מצטרף לחדר שהוא לא יצר ואינו משנה את ההרשאות שלו. הבורר מצב שיגור (allParallel / manager) בעורך תצורת הצומת מיועד לצומתי שיגור צוות. הגדירו את מצב השיחה עם extras['mode'] בתבנית שפותחת את המרחב, או בתצורה של אותו צומת דרך ה-API.