> ## Documentation Index > Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt > Use this file to discover all available pages before exploring further. # Режим «Проект» > Как провести сложную задачу через уточнение требований, утверждение плана, последовательное выполнение и итоговый документ. # Режим «Проект» Режим **Проект** предназначен для сложной работы, где важно сначала уточнить требования, согласовать план и сохранить результаты каждого этапа. Велес ведёт один проект внутри одного диалога, выполняет этапы строго по очереди и складывает рабочие материалы в выбранную папку. Для короткого вопроса или задачи без предварительного согласования оставьте обычный режим. ## Как начать проект 1. Создайте новый диалог. Переключатель режима показывается только пока диалог пуст. 2. Под кнопкой отправки выберите **Проект** вместо **Обычный**. 3. Подробно опишите желаемый результат и при необходимости прикрепите файлы. 4. Отправьте первое сообщение. Выбранный режим действует только для первого сообщения этого диалога. Каждый новый диалог снова начинается в обычном режиме. При запуске Велес фиксирует текущую модель и уровень рассуждений диалога. Служебное значение **Авто** не передаётся поставщику как буквальный уровень: модель использует своё поведение по умолчанию. ## Уточняющие вопросы Перед составлением плана Велес задаёт от 5 до 10 вопросов. Nerve публикует их в диалоге как специальное сообщение с анкетой. У каждого вопроса есть ровно три подготовленных варианта и поле для собственного ответа. Если анкета не помещается по высоте окна, она прокручивается вместе с остальными сообщениями диалога. Нижние вопросы, выбор папки и кнопка отправки ответов остаются доступны без изменения масштаба страницы. После отправки анкета остаётся в истории как завершённое сообщение, а принятые ответы сохраняются в состоянии проекта. Ответьте на все обязательные вопросы и проверьте папку результатов. Велес предлагает безопасный путь вида: ```text theme={null} docs/<дата>-<краткое-название>--<8-символьный-идентификатор> ``` Можно указать другой точный путь внутри рабочей области. Он должен быть относительным, не выходить за пределы рабочей области и не вести в служебные каталоги Велеса. Существующую папку использовать можно, если в ней нет файлов, которыми управляет этот проект. Велес не перезаписывает посторонние материалы. ## Утверждение плана После ответов Велес публикует следующим специальным сообщением краткое описание задачи и план. План содержит не более десяти выполняемых этапов, а его первым этапом всегда является исследование. Перед началом работы выберите одно из действий: * **Утвердить** — начать выполнение; * **Попросить изменить** — написать, что нужно исправить, и получить новую редакцию плана. Результат первого этапа сохраняется в `research.md`. Если исследование изменило ещё не выполненные этапы, Велес обновляет план и снова просит его утвердить. Уже выполненное исследование при этом не запускается повторно. ## Выполнение и материалы Каждый этап выполняется отдельным исполнителем с новым контекстом. Исполнители запускаются строго по одному. Следующий исполнитель получает исходную задачу, утверждённый план, краткий итог исследования, пути готовых материалов и ограниченную передачу результата только от предыдущего этапа. Полные внутренние диалоги и журналы инструментов между этапами не переносятся. Исполнитель использует те же доступные возможности, что и Велес в обычном диалоге: работу с файлами, поиск и загрузку страниц, поиск по памяти и документации, разбор документов и подключённые средства MCP. В запрос модели попадают только действительно настроенные и доступные средства. Управление родительским диалогом, создание вложенных исполнителей, смена модели и расписания недоступны, чтобы один этап не мог нарушить последовательность проекта. В папке проекта появляются: | Файл | Содержимое | | ---------------------------- | ---------------------------------------------------------------------- | | `brief.md` | Исходная задача и подтверждённые уточнения. | | `plan.md` | Текущая утверждаемая редакция плана. | | `research.md` | Результаты обязательного исследования. | | `progress.md` | Дополняемый журнал этапов и попыток. | | `steps/NN-<название>.md` | Отчёт отдельного этапа. | | `failures/<этап>-<время>.md` | Безопасное описание неудачной попытки и ссылка из сообщения об ошибке. | | `final.md` | Итоговый документ для пользователя. | Проект не занимает отдельную постоянную панель. Анкета, план, ход выполнения, ошибки и итог появляются по очереди как сообщения внутри обычного диалога. Вызовы инструментов и промежуточные пояснения исполнителя отображаются теми же элементами, что и в обычном режиме. После завершения Велес собирает результаты всех этапов в `final.md` и публикует отдельное итоговое сообщение со ссылкой на документ. Если Велес изменил план по просьбе пользователя или после исследования, новая редакция появляется отдельной карточкой внизу диалога. Предыдущие редакции остаются в истории для сравнения, но утвердить или снова изменить можно только последнюю карточку. Поэтому остановка для повторного утверждения видна рядом с последними сообщениями и не требует прокрутки к первому плану. ## Ошибки, продолжение и восстановление Ошибка отдельного средства не завершает этап автоматически. Велес показывает её исполнителю как результат вызова, после чего тот может исправить параметры, выбрать другое средство или продолжить по имеющимся данным — так же, как в обычном диалоге. Проект запрашивает вмешательство пользователя только когда исполнитель после этих попыток не смог завершить сам этап, поставщик модели прекратил ответ или исчерпан предел итераций. В этом случае сообщение об ошибке показывает безопасное описание и доступные действия. Предел для каждого этапа и подготовки итогового документа задаёт `agents.defaults.maxToolIterations`. При возобновлении создаётся новый исполнитель с полным пределом из текущей настройки: использованные в предыдущей попытке итерации не вычитаются. Уже сохранённые файлы и результаты при этом остаются на месте, чтобы исполнитель продолжил работу с последнего подтверждённого состояния. * **Продолжить этап** создаёт новый контекст только для незавершённого этапа. Это не очистка и не запуск с нуля: уже созданные файлы, изменения, материалы и ход прошлой попытки сохраняются. Исполнитель сначала проверяет фактическое состояние рабочей области, отчёт об ошибке и сохранённый ход диалога, затем продолжает с последнего подтверждённого состояния. Завершённые этапы и готовые части текущего этапа без необходимости не повторяются. * **Отменить** прекращает проект. Уже созданные файлы остаются на месте. Удаление диалога с незавершённым проектом сначала отменяет проект, а затем применяет обычное правило хранения или удаления истории. Материалы в выбранной папке при этом не удаляются. После перезапуска шлюза подготовка вопросов или плана и этап, который выполнялся в этот момент, переходят в состояние **Приостановлен**. Велес не повторяет работу без явного нажатия **Продолжить**. Уже показанная анкета и запрос на утверждение плана сохраняются без изменения; завершённые перед сбоем вызовы средств и их результаты остаются в истории диалога как ход прерванной попытки. События хода работы служат только для быстрого обновления интерфейса. После переподключения Nerve заново получает сохранённое состояние проекта у Велеса, поэтому пропущенное событие не приводит к потере проекта. Поле ввода блокируется только на короткое время между отправкой первого запроса и сохранением состояния проекта. Затем можно писать как в обычном диалоге. Велес сам сопоставляет смысл сообщения с текущим состоянием, выбирает подходящее средство или задаёт уточняющий вопрос. Жёсткого сопоставления отдельных фраз с действиями нет. Средства управления анкетой, утверждением и изменением плана, продолжением и отменой добавляются только к ходу активного проекта. В обычном диалоге они не попадают ни в запрос модели, ни в список доступных средств.