Запустить оркестрацию

Это руководство показывает, как превратить одну большую цель в план для всей команды, который выполняется сам. О том, как это устроено, см. Оркестрация.

Когда использовать оркестрацию

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

Шаг 1. Попросите план

Откройте (или создайте) пространство и якорный тикет. Он нужен для каждого предложения (propose_orchestration принимает ticket_id); общее пространство берётся из этого тикета.
При желании переключите выпадающий список режимов в композере на Оркестрация. Этот режим сужает возможности агента до чтения и предложения — память, граф кода, чтение репозиториев и тикетов, propose_orchestration и инструменты плейбука, — поэтому он не может начать писать код вместо планирования.
@-упомяните своего оркестратора (обычно агента CEO) и сформулируйте цель простыми словами:

@ceo Исследуй конкурентный ландшафт для диктофона встреч, работающего в первую очередь офлайн, и напиши одностраничный документ о позиционировании.

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

Поскольку предложение — это типизированный объект, приложение проверяет его (корректно оформленные роли, объявленные схемы вывода, DAG без циклов), прежде чем что-либо запустится. Предложение, не прошедшее проверку, нельзя утвердить.

Шаг 2. Просмотрите и отредактируйте предложение

Карточка в чате предлагает три действия: Утвердить план, Отклонить и Открыть — последнее открывает план в Plan Studio как вкладку редактора. Саму карточку редактировать нельзя.

Чтобы что-то изменить, нажмите Открыть и работайте в инспекторе справа:

Название, описание, роль, зависимости и схема вывода любого рабочего шага. Роль здесь означает, какой из существующих ключей ролей плана владеет шагом — закрепить роль за именованным агентом или отредактировать список найма из инспектора нельзя, и бюджет редактировать тоже нельзя.

Две вещи доступны только для чтения: структурные узлы (исследование, обсуждение, синтез) и любой узел, работа которого уже выполнялась. Редактирование возможно, только пока оркестрация остаётся в статусе proposed.

Нажмите Оценить на панели утверждения, чтобы до подтверждения увидеть диапазоны стоимости, длительности и радиуса воздействия. Полный обзор редактора см. в разделе Работать в Plan Studio.

Шаг 3. Утвердите

Утвердите план — из карточки в чате или с панели утверждения Plan Studio. Это единственное решение, которое вы принимаете. Утверждение доступно только оператору — для него нет инструмента MCP, поэтому агент может предлагать и дорабатывать план, но никогда не может утвердить свой собственный.

Дальше детерминированный материализатор (чистая функция, без LLM) превращает предложение в настоящий конвейер и создаёт каркас:

нанимает все новые роли (и записывает id нанятых агентов, чтобы сбой посреди утверждения можно было возобновить без дублирующих наймов)
объединяет роли в команду
создаёт проект и помещает в него родительский тикет
запускает запуск конвейера, который всем этим управляет

Статус переходит в approved, затем в executing.

Шаг 4. Наблюдайте за выполнением

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

родительский тикет, к которому была привязана оркестрация
общее пространство, в котором общается команда, где строка плана отслеживает состояние каждого узла
детали запуска конвейера с привычным водопадом и стоимостью по шагам — см. Мониторить запуски конвейеров
проект, в который был помещён родительский тикет

Когда подтикеты готовы, статус переходит в synthesizing, и шаг синтеза создаёт итоговый результат. Этот текст публикуется в общем пространстве, родительский тикет помечается завершённым, а затем статус становится completed.

Остановите её досрочно

Нажмите Отменить оркестрацию на карточке в чате или Отменить запуск на панели утверждения Plan Studio. Отмена сворачивает работу, находящуюся в процессе.

Оркестрация завершается сбоем, когда не удаётся материализация или когда сбоем завершается запуск её сгенерированного конвейера (исследование, обсуждение, синтез или persist — эти шаги не продолжаются при сбое). Сгенерированные шаги work всегда продолжаются при сбое, поэтому один провалившийся подтикет не проваливает запуск. Не существует пути сбоя из-за превышения бюджета и порога «все подтикеты провалились».

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

Работать в Plan Studio: редактирование, оценка, diff и утверждение плана
Создавать и управлять тикетами: родительский тикет, к которому привязана оркестрация
Организовать работу через проекты: куда помещается родительский тикет
Мониторить запуски конвейеров: как материализованная оркестрация выглядит в движке
Собрать команду агентов: роли, которые оркестрация заполняет или нанимает