Перейти к содержимому

Обзор агента

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

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

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

Подробнее — в разделе Режимы.

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

  • Чтение и навигация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-серверов

Полный справочник инструментов — в разделе Инструменты.

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

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

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

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

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

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

Во время длинных ответов живой текст и ход рассуждений передаются лёгкими обновлениями, поэтому длинные чаты и рабочие области с несколькими панелями продолжают плавно обновляться, а полные снимки состояния по-прежнему отвечают за перезагрузку, инструменты, повторы и переподключения. Раскрываемые детали — например, диффы, вывод команд, рассуждения и результаты поиска — монтируются только в открытом состоянии и удаляются после анимации закрытия. Текст, полученный большими порциями, появляется с равномерной скоростью; незавершённый Markdown сохраняет итоговую структуру таблиц, ссылок, списков и кода, а код в блоках остаётся подсвеченным во время стриминга. Прокрутите вверх, чтобы сохранить позицию чтения; перетаскивание полосы прокрутки чата обратно к концу возобновляет автоматическое следование, даже пока ответ продолжает расти.

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

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

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

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

Агент может делегировать изолированные подзадачи дочерним агентам через инструмент sub_agent. Дочерний агент работает в своём собственном контексте и возвращает результат родителю. Подробнее — в разделе Субагенты.

Во всех режимах чата, где Browser включён в Harness, агент может использовать Integrated Browser с одинаковым полным набором действий. Он может запустить локальный предпросмотр, сделать скриншот, прочитать консоль, изменить размер viewport, проинспектировать элементы и взаимодействовать со страницей, пока вы наблюдаете или берёте управление на себя. Подробнее — в разделах Определение dev-сервера и Инструменты.

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