Работать в 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, чтобы удалить выделенный шаг; ссылки на него удаляются из зависимостей остальных шагов.

В инспекторе вы также можете редактировать описание шага, роль и схему вывода. Правки автоматически сохраняются как новая ревизия после короткой паузы; ошибка валидации (показанная на панели утверждения) блокирует сохранение, пока вы её не исправите.

Редактировать можно только рабочие шаги. Структурные узлы — исследование, обсуждение и синтез — доступны только для чтения, как и любой шаг, работа которого уже выполнена (он помечен «уже выполнено», потому что правка ответвила бы план).

Сохранение использует оптимистичный параллелизм относительно ревизии, с которой вы начали. Если оркестратор перепланирует у вас под руками, ваше сохранение отклоняется с сообщением «план ушёл вперёд», а не сливается и не перезаписывается молча; перечитайте текущую ревизию и повторите правку. Перепланирования, инициированные агентом, сами ограничены частотой — одно раз в две минуты, — поэтому это остаётся редким.

Читать оценки стоимости, времени и риска

Нажмите Оценить на панели утверждения.

Каждый шаг на холсте получает значок с диапазоном стоимости и размером выборки, на которой он основан, либо «Истории пока нет», если роль шага ещё ни разу не запускалась. Выберите шаг, чтобы увидеть подробности в инспекторе: диапазон стоимости с размером выборки, диапазон длительности и радиус воздействия (файлы и символы), выведенный из происхождения шага, — или «неизвестно», если у шага нет происхождения.
Панель утверждения показывает итог по плану: общий диапазон стоимости, диапазон длительности для критического пути (параллельные ветви перекрываются, поэтому это не сумма) и потолок бюджета, если план его задаёт.
Если история есть только у части шагов, итог помечается как частично и охватывает только оцениваемые шаги. Если верхняя граница оценки превышает потолок бюджета, итог становится красным с предупреждением о превышении бюджета.

Оценки либо честные, либо их нет: шаг, для роли которого нет истории завершённых запусков, сообщает размер выборки, равный нулю, вообще без диапазонов и показывается как неизвестный, а не выдуманный. Воспринимайте «Истории пока нет» как «никто не знает», а не как «дёшево».

Потолок бюджета — это отображение сравнения с этой оценкой. После запуска плана его ничто не обеспечивает — о средствах контроля, которые действительно останавливают расходы, см. Управлять затратами.

Сравнить ревизию с более ранним предложением

Каждая правка и каждое перепланирование оркестратора добавляются в шкалу ревизий, доступную только на добавление, которая показана на панели Версии слева от плана оркестрации.

Нажмите на ревизию, чтобы сравнить её с текущим предложением. Без выделения панель сравнивает предыдущую ревизию с текущей.
Читайте diff в нижней половине панели: шаги, добавленные, удалённые или изменённые между двумя ревизиями.
Если план всё ещё proposed, нажмите значок перемотки на ревизии, чтобы вернуться к ней. Перемотка сохраняет то предложение как новую ревизию — ничего не теряется.

propose_orchestration и редактор оба отказывают в изменениях, как только план перестаёт быть proposed, поэтому выполняющийся запуск не подхватывает перепланирование посреди выполнения.

Утвердить, отклонить или расширить план

В приложении предложенный план — это одно решение, принимаемое целиком: Утвердить план или Отклонить на панели утверждения. Утвердить план всегда утверждает каждый шаг — сначала выбрать подмножество нельзя. Утверждение блокируется, пока в предложении есть ошибки валидации, которые показываются рядом с кнопками.

Утверждать может только оператор. Для этого нет инструмента MCP, поэтому агент может предложить и доработать план, но никогда не может его утвердить.

Как только оркестрация выполняется, панель меняется:

Если шаг остановился, чтобы задать вопрос посреди запуска, выберите его и нажмите Продолжить узел, чтобы возобновить его.
Нажмите Утвердить выбранные, чтобы расширить частичное утверждение на выбранный шаг плюс всё, от чего он транзитивно зависит (шаг никогда не может быть утверждён без своих зависимостей). Этот элемент управления есть на панели выполнения для каждой оркестрации; он ничего не делает, если план был утверждён целиком.
Нажмите Отменить запуск, чтобы остановить всю оркестрацию.

Шаги вне частично утверждённого набора отображаются как отложенные и не выполняются, пока вы не расширите набор.

Запустить плейбук с параметрами

Плейбук — это сохранённый шаблон плана с типизированными подстановками {{param}} в цели, заголовках шагов, описаниях и промптах. Подстановка буквальная — языка выражений нет; если вам нужна логика, используйте вместо этого конвейер.

В разделе Плейбуки хаба нажмите Запустить у плейбука (или откройте палитру по ⌘K и выберите плейбук там).
Заполните параметры. Параметры-перечисления отображаются как раскрывающиеся списки; параметры репозитория и агента принимают ссылку на репозиторий или агента; необязательные параметры используют значение по умолчанию.
Выберите Якорный тикет, относительно которого предлагается план, затем подтвердите.

Запуск плейбука только предлагает план — инстанцированная оркестрация открывается в Plan Studio в состоянии proposed, и ничего не выполняется, пока вы не утвердите её там. Чтобы удалить плейбук, нажмите значок корзины на его карточке.

Агенты создают и запускают плейбуки с помощью инструментов MCP create_playbook и run_playbook; см. Инструменты MCP.

Связанные руководства

Использовать режим плана: как агент создаёт документ плана с помощью submit_plan
Запустить оркестрацию: жизненный цикл «утвердить один раз» со стороны разговора
Создать шаблон конвейера: когда нужна логика, которую плейбук выразить не может
Мониторить запуски конвейеров: представление движка для утверждённого плана

Связанные понятия

Оркестрация