Документация

Документация/Агент

Режим «План»

Как договориться с агентом о плане до того, как он тронет код: вопросы, документ плана и карточка «План готов».

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

Как включить

  1. Нажмите на переключатель режима справа под полем ввода.
  2. Выберите пункт «План» с подписью «Уточняет детали, пишет спеку и план».

В начатом чате, где у агента ещё нет плана, над лентой видна плашка «Плана пока нет». Кнопка «Режим «План»» на ней тоже включает этот режим.

Как пользоваться

  1. Включите режим «План» и опишите задачу.
  2. Ответьте на вопросы агента. Они приходят карточками над полем ввода.
  3. Агент напишет план и покажет карточку «План готов».
  4. Откройте «Документ плана» и прочитайте план.
  5. Нажмите «Начать выполнение». Чтобы поправить план, нажмите «Продолжить планирование».

Что агент делает в режиме «План»

  • Читает проект и ищет по нему, чтобы разобраться в задаче.
  • Файлы проекта не меняет, пишет только два своих документа. Спецификация («спека» из подписи режима) — решение, о котором вы договорились; план — шаги, по которым агент будет это решение выполнять. Открыть их можно по ссылкам «Спецификация» и «Документ плана» на плашке плана над лентой.
  • Команды запускает только после вашего ответа на карточке.
  • В остальном спрашивает разрешения так же, как в режиме «Авто» (Режимы агента).

Если в проекте включён Flow, в режиме «План» агент работает по нему: сначала задаёт вопросы по одному и предлагает решение, потом пишет план. В папке с кодом Flow включён по умолчанию.

Вопросы агента

Карточка «Агент спрашивает» стоит над полем ввода, пока вы не ответите. На ней подпись: «Работа на паузе, пока вы не ответите».

  • Выберите вариант. Если под вопросом написано «можно несколько», выберите несколько.
  • Свой ответ напишите в поле «Свой вариант…».
  • Если вопросов несколько, вверху видно, на сколько вопросов вы уже ответили, например «2 из 4». Кнопка «Ответить» заработает, когда вы ответите на все.
  • «Пусть решит агент» — агент выберет сам и продолжит.

В ленте вопросы остаются диалогом: что спросил агент и что вы ответили. Подробнее о карточках — на странице Разрешения и вопросы.

Карточка «План готов»

Когда план написан, над полем ввода появляется карточка «План готов». На ней нумерованный список шагов и ссылка «Документ плана», которая открывает план во вкладке редактора.

КнопкаЧто произойдёт
«Начать выполнение» (Enter)Агент выйдет из режима «План» и начнёт делать задачу по плану. Режим чата сам переключится на «Авто».
«Продолжить планирование»Появится поле «Что уточнить в плане?». Напишите, что изменить, и нажмите Enter или кнопку отправки. Агент продолжит планировать и учтёт ваши слова.

Клавиша Esc на этой карточке ответа не отправляет: план можно только принять или доработать.

В ленте решение остаётся строкой: «План готов — ждёт вашего решения», потом «План одобрен — переход к реализации» или «Планирование продолжается».

Совет

После «Начать выполнение» чат работает в режиме «Авто», даже если до «Плана» был включён «Полный». Чтобы агент выполнил план без лишних вопросов, переключите чат на «Полный». В каком режиме чат сейчас, написано на переключателе режима справа под полем ввода.

Плашка плана над лентой

Над лентой начатого чата видна плашка плана. На ней шаги, которые агент составил для задачи, и сколько из них уже сделано, например «3 из 7». Пока агент работает, рядом написано «в работе» и время. Пока он ждёт вас — «ждёт вашего решения», а когда все шаги сделаны — «План выполнен». Выполненные шаги можно скрыть кнопкой «Скрыть выполненные».

Шаги агент составляет в любом режиме, если задача занимает несколько шагов. Документ плана из режима «План» тоже открывается с плашки.

Ограничения

  • «План» работает одинаково, из какого бы режима его ни включили. Даже после «Полного» или «Без ограничений» агент не меняет файлы проекта и спрашивает перед командами, а «Без ограничений» в этом чате выключается.
  • Документ плана лежит вне папки проекта, поэтому в git не попадает. Снова открыть его можно по ссылке «Документ плана» на плашке плана над лентой. Если план нужен в репозитории, попросите агента сохранить его в проект.

Что дальше

Обновлено · Нашли неточность? Напишите на support@devmachine.ai или в Telegram.