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

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

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

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

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

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

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

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

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

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

## Режимы работы: Обсуждение / Обучение / Агент

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

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

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

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

### Терминал

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

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

Агент ищет сам, если вы не указали файлы через `#`: по точному тексту, по имени файла и по смыслу. Подробнее — на странице [Поиск по коду](/docs/agent/tools/search).

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

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

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

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

## Проверка кода и планирование

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

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

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

Начинать новый чат вручную, когда индикатор приближается к пределу, не обязательно: при заполнении контекстного окна WorkAI автоматически сжимает историю диалога и продолжает работу в том же чате, без потери сути того, что обсуждалось раньше. Сжатие можно запустить и вручную, командой `/compact`. Подробнее — на странице [Сжатие контекста](/docs/agent/compaction).

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

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

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

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

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

## Дальше

Если вы ещё не проходили быстрый старт — начните с [Быстрого старта](/docs/get-started/quickstart). Про то, какие модели доступны и сколько стоит их использование, — на странице [Модели и цены](/docs/models-and-pricing).