# Обзор агента

> Что такое агент Kodik и как он работает: инструменты, режимы и ключевые возможности рабочего процесса.

Источник: https://docs.kodik.ru/agent/overview

Kodik включает автономного агента, который читает и редактирует файлы, выполняет команды в терминале, выполняет поиск по кодовой базе, загружает страницы из интернета, управляет Integrated Browser для визуальных проверок и вызывает инструменты MCP — при этом каждое действие отображается в чате и требует вашего подтверждения (или выполняется автоматически, если вы настроили авто-одобрение).

## Режимы

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

| Режим                   | Назначение                                        | Изменяет файлы?     |
| ----------------------- | ------------------------------------------------- | ------------------- |
| **Code** (по умолчанию) | Выполнение задач: чтение, редактирование, команды | Да                  |
| **Plan**                | Создание плана реализации без изменений           | Нет                 |
| **Ask**                 | Ответы на вопросы по кодовой базе                 | Нет                 |
| **Debug**               | Гипотезы → инструментирование → минимальный фикс  | Да                  |
| **Educator**            | Обучение с пояснениями и интерактивными уроками   | Файлы проекта — нет |

Подробнее — в разделе [Режимы](https://docs.kodik.ru/agent/modes).

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

Агент использует набор встроенных инструментов:

- **Чтение и навигация** — `read_file`, `glob`, `rg` (ripgrep), `codebase_search`
- **Редактирование** — `edit_file`, `create_file`, `delete_file`, `edit_notebook`
- **Терминал** — `shell` (выполнение команд), `command_status` (опрос фоновых процессов)
- **Сеть** — `web_fetch` (только HTTPS)
- **Браузер** — `browser` для открытия локальных страниц, проверки отрендеренного UI, скриншотов, чтения консоли и взаимодействия со страницей
- **Обучение** — `check_understanding` для быстрых проверок понимания и `create_lesson` для уроков Educator, сохранённых в `.kodik/teach`
- **Вспомогательные** — `todo_write`, `memory`, `ask_questions`, `read_lints`
- **Субагенты** — `sub_agent` для делегирования подзадач
- **MCP** — любые инструменты из подключённых MCP-серверов

Полный справочник инструментов — в разделе [Инструменты](https://docs.kodik.ru/agent/tools).

## Ключевые возможности рабочего процесса

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

В режиме Plan агент исследует кодовую базу и сохраняет структурированный план через инструмент `generate_plan`, не внося никаких изменений. Переключитесь в Code, чтобы приступить к реализации. Подробнее — в разделе [Планирование](https://docs.kodik.ru/agent/planning).

### Контрольные точки

Kodik автоматически создаёт контрольную точку после каждого использования инструмента, сохраняя снимок рабочего пространства в теневом Git-репозитории. Вы можете откатиться к любой точке в любое время. Подробнее — в разделе [Контрольные точки](https://docs.kodik.ru/agent/checkpoints).

### Авто-одобрение

По умолчанию агент запрашивает подтверждение перед каждым действием. Вы можете настроить детализированные разрешения — разрешить чтение файлов, поиск, выполнение определённых команд и многое другое — не снимая контроля над операциями редактирования. В режиме «автопилот» одобряются все действия кроме команд из списка блокировки. Подробнее — в разделе [Авто-одобрение](https://docs.kodik.ru/agent/auto-approve).

### Прерванные ответы

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

Если сбой происходит, пока инструмент или foreground-субагент ещё выполняется, Kodik останавливает эту работу и переводит карточку инструмента в завершённое состояние перед подсказкой повтора. Отмена во время permission hook также остаётся отменой: поздний результат hook не может снова открыть одобрение.

Пока Kodik тихо повторяет запрос после временной ошибки провайдера, статус в чате меняется с «Работаем» на сообщение о повторе с номером следующей попытки и задержкой, поэтому долгие ожидания не выглядят как разрыв соединения.

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

В рабочих областях с несколькими панелями Kodik держит видимый выбор панели синхронизированным с выбранной сессией в хосте. Если хост не может переключить сессию, выбор панели откатывается, чтобы следующее действие чата без явной цели не ушло в другую сессию.

Если модель продолжает запрашивать инструменты сверх лимита безопасности для одного пользовательского хода, Kodik останавливает цикл инструментов и помечает чат как требующий ваших указаний. В этом состоянии нет кнопки повтора, потому что повтор, скорее всего, запустит тот же цикл; ответьте более узкими инструкциями, чтобы продолжить.

Если Kodik перезапускается, пока ход стримит текст или ход рассуждений, уже записал текст ассистента, но ещё не завершился, ждёт одобрения, задаёт интерактивный вопрос, выполняет инструмент, ждёт ответ модели после результата инструмента или сжимает контекст, восстановленный чат больше не показывает старое состояние как активное. Уже показанные текст, ход рассуждений и текст ассистента из прерванного хода возвращаются как контекст с возможностью повтора, ожидающие инструменты помечаются как отменённые, завершённые инструменты остаются видимыми с возможностью повтора для пропущенного продолжения, вопросы без ответа возвращаются как контекст только для чтения, неудачное сжатие показывается как ошибка сжатия, а прерванный ход предлагает повтор там, где это возможно.

Сообщения, которые вы поставили в очередь, пока ход выполнялся, после перезапуска восстанавливаются как редактируемые черновики в очереди.

### Субагенты

Агент может делегировать изолированные подзадачи дочерним агентам через инструмент `sub_agent`. Дочерний агент работает в своём собственном контексте и возвращает результат родителю. Подробнее — в разделе [Субагенты](https://docs.kodik.ru/agent/subagents).

### Браузерный предпросмотр

В режимах Code и Debug агент может использовать Integrated Browser, чтобы проверять всё, что рендерится в браузере. Он может запустить локальный предпросмотр, сделать скриншот, прочитать консоль, изменить размер viewport, проинспектировать элементы и взаимодействовать со страницей, пока вы наблюдаете или берёте управление на себя. Подробнее — в разделах [Определение dev-сервера](https://docs.kodik.ru/features/dev-server) и [Инструменты](https://docs.kodik.ru/agent/tools).

### Просмотр изменений

Все правки файлов отображаются в панели изменений в чате. Вы можете принять или отклонить каждый файл по отдельности, а также открыть режим просмотра diff. Подробнее — в разделе [Просмотр изменений](https://docs.kodik.ru/agent/reviewing-changes).