Агент — обзор

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

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

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

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

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

Некоторые действия — правка и создание файлов, локальное превью — доступны только в режимах «Агент» и «Обучение». Переключить режим можно прямо в чате.

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

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

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

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

Агент ориентируется в проекте, не открывая всё подряд: ищет по точному тексту, по имени файла и по смыслу. Подробнее — на странице Поиск по коду.

Терминал #

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

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

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

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

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

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

Изоляция генерации в режиме Создателя #

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

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

Проверка кода #

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

Планирование #

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

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

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

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

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

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

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

Что дальше #

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