Agent — обзор

Agent — это ИИ-ассистент, встроенный прямо в редактор WorkAI. Он читает и редактирует код, выполняет команды в терминале, ищет по проекту и — в режиме Создателя — собирает целые изменения в изолированной копии проекта, прежде чем предложить их вам.

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

Режимы работы #

Агент WorkAI работает в одном из трёх режимов чата, которые определяют, что он может делать без лишних вопросов:

• Ask — агент отвечает на вопросы и анализирует код, но не редактирует файлы и не выполняет команды.
• Learn — режим для разбора и обучения: агент может показывать и объяснять правки.
• Agent — полный доступ к редактированию файлов, созданию файлов, локальному превью и другим действующим инструментам.

Некоторые инструменты — например, редактирование и создание файлов, локальный превью — доступны только в режимах Agent и Learn. Переключить режим можно прямо в чате.

Для параллельной работы сразу с несколькими агентными сессиями есть отдельный режим окна — Agents Window.

Инструменты #

У агента нет ограничения на число вызовов инструментов за одну задачу — он делает столько шагов, сколько нужно, чтобы решить задачу.

Поиск по проекту #

Два нативных инструмента поиска: полнотекстовый поиск по содержимому файлов (в духе ripgrep — с режимами «показать совпадения», «только файлы», «количество совпадений» и контекстными строками вокруг найденного) и поиск файлов по имени. Ими агент ориентируется в проекте, не открывая всё подряд.

Терминал #

Агент может открыть терминальную сессию и выполнить команду, наблюдая за выводом построчно, — это удобно, чтобы он сразу видел ошибки сборки, результат теста или лог линтера. Вывод буферизуется до определённого объёма: если команда печатает очень много, в буфере остаётся только последняя часть.

Если команда не входит в список разрешённых (настраивается в разделе безопасности), агент запросит у вас подтверждение перед запуском.

Локальный превью #

Это не браузер общего назначения для сёрфинга по произвольным сайтам — агент не умеет переходить по чужим URL, кликать по элементам сторонних страниц или снимать с них скриншоты. Инструмент решает более узкую задачу: открыть локальный .html-файл во встроенном окне превью. Для статики поднимается лёгкий локальный сервер, а при сохранении .html/.css/.js файлов страница автоматически перезагружается — удобно смотреть результат вёрстки или простого фронтенда без переключения в браузер.

Редактирование файлов #

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

Worktree-изоляция в режиме Создателя #

В режиме Создателя (Builder) агент не работает прямо поверх вашей рабочей копии. Для каждой задачи создаётся изолированный git worktree — отдельная копия проекта на файловой системе, где агент вносит изменения и коммитит их от собственного имени. Внутри такой копии доступны черновые точки сохранения: агент может зафиксировать промежуточное состояние и откатиться к нему, если генерация пошла не туда.

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

Agent Review #

Перед тем как принять предложенные агентом изменения, их можно просмотреть — по аналогии с ревью пул-реквеста, но внутри редактора. Это отдельный этап проверки, который стоит между «агент предложил правку» и «правка применена к вашим файлам». Подробнее — на странице Agent Review.

Plan Mode #

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

Безопасность и подтверждения #

За контроль над тем, что агент может делать без вашего участия, отвечают два раздела настроек:

• Terminal and Security — Allowed / Denied команды терминала: списки команд, которые агент может выполнять сразу или которые ему запрещены в принципе.
• Tools and Security — Permissions: единый список разрешений на действия агента, каждое со своей областью действия — глобально, на весь workspace или только на текущую сессию чата. Разрешения с областью действия «глобально» и «workspace» можно отозвать в любой момент; разрешения уровня сессии отозвать нельзя — они действуют до конца текущего чата.

В обоих разделах есть переключатель Allow everything without confirmation, который разом отключает все запросы подтверждения. Использовать стоит осознанно.

Файлы с секретами — .env, credentials.json и подобные — помечаются значком замка в дереве проекта, чтобы было видно, где лежит чувствительное содержимое.

По умолчанию агент работает без встроенного в VS Code механизма Workspace Trust — он отключён.

Что дальше #

Если вы ещё не пробовали агента — начните с быстрого старта. Модель для агента и её стоимость в WorkCoins описаны в разделе «Модели и тарифы», а логику режима Auto — на странице «Model Router».