Как формулировать задачи агенту

Агент WorkAI получает задачу текстом в чате — так же, как вы бы объяснили её коллеге. Но у текстовой формулировки есть несколько усилителей: вложенные файлы, изображения, голосовой ввод, режим работы и выбор модели. Разберём, как ими пользоваться и что агент умеет делать после того, как получил задачу.

Формулировка задачи #

Чем конкретнее задача, тем меньше агенту нужно гадать. Полезно указывать:

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

Если вы уже знаете, какой файл, папка, вывод терминала или diff относятся к задаче — прикрепите их к промпту явно через #-упоминание, начните вводить # в поле ввода и выберите нужный элемент из списка. Это быстрее и надёжнее, чем полагаться на то, что агент сам найдёт нужное. Если вы не уверены, какие файлы относятся к задаче — не пытайтесь угадать, агент сам ищет их через grep_search и file_search по проекту.

Вложения к промпту #

Кроме текста в промпт можно добавить изображение — например, скриншот UI-бага, макет дизайна или фото со стек-трейсом. Это полезно, когда словами описывать визуальную проблему дольше, чем показать её.

Есть и голосовой ввод: вместо набора текста можно надиктовать задачу — удобно для длинных или объясняемых на ходу формулировок.

Переключение модели #

В любой момент диалога можно сменить модель через селектор моделей в поле ввода — смена применяется к текущему и последующим сообщениям в этом чате. Модели различаются по скорости и глубине рассуждений: для рутинных правок разумно выбрать более быструю и дешёвую модель, для сложного рефакторинга или многошагового рассуждения — более мощную. Есть и режим "Auto" — единая системная модель, которая выбирается автоматически (подробнее — на странице Автовыбор модели). Полный список доступных моделей и их стоимость в Ⓦ — на странице Модели и тарификация.

Режимы работы: Ask / Learn / Agent #

У чата есть три режима, которые определяют, какие инструменты доступны агенту:

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

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

Что умеет агент помимо чтения и правки кода #

Терминал #

Агент может выполнять команды в терминале — создаёт сессию, стримит вывод построчно (буфер вывода ограничен, сохраняются последние ~20 КБ). Команды, которых нет в списке разрешённых, требуют вашего подтверждения перед запуском — список Allowed/Denied команд настраивается в разделе "Терминал и защита" (подробнее — в разделе про безопасность ниже).

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

Два инструмента поиска: поиск по содержимому файлов (в духе ripgrep, с режимами "показать совпадения", "только файлы", "количество", с контекстными строками вокруг найденного) и поиск файлов по имени. Это то, чем агент пользуется, чтобы найти релевантный код сам, если вы не указали файлы через #-упоминания.

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

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

Worktree в режиме Создатель #

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

Agent Review и Plan Mode #

Прежде чем agent начнёт вносить изменения в код, можно попросить его сначала составить план — набросок шагов без реального выполнения правок. Это удобно для задач, где вы хотите свериться с подходом до того, как агент тронет файлы. Отдельно, после того как агент внёс изменения, WorkAI даёт возможность просмотреть их как ревью — до того как принять итоговый результат в проект.

Контроль контекстного окна #

Пока идёт диалог, агент накапливает контекст — историю сообщений, системный промпт, инструменты, правила проекта, MCP-серверы. Индикатор заполненности контекстного окна в панели чата показывает, сколько места занято, и даёт разбивку по категориям (системный промпт, инструменты, правила, MCP, переписка). Это полезно, чтобы вовремя заметить, что диалог разросся, и начать новый чат вместо того, чтобы агент терял ранний контекст.

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

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

Что именно требует подтверждения, настраивается в разделе "Терминал и защита" в настройках:

• списки разрешённых и запрещённых команд терминала;
• общий список разрешений — что агент может выполнять без запроса каждый раз — с разными областями действия: на весь аккаунт, на конкретный проект или только на текущий чат (последнее не переживает перезапуск). Каждое разрешение можно отозвать.
• общий переключатель "разрешить всё без подтверждения" — отключает запросы подтверждения разом, используйте с пониманием, что это снимает защиту.

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

Дальше #

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