Працювати в 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
Запустити оркестрацію: життєвий цикл «затвердити один раз» з боку розмови
Створити шаблон конвеєра: коли вам потрібна логіка, яку плейбук не може виразити
Моніторити запуски конвеєрів: погляд рушія на затверджений план

Пов’язані поняття

Оркестрація