Режим агента¶

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

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

Когда стоит выбирать агента¶

Агент особенно полезен, если задача:

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

Типичные примеры:

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

Как начать¶

Шаг 1. Переключитесь в режим агента¶

1. Откройте панель Koda.
2. Выберите режим Агент.

Шаг 2. Опишите задачу по-человечески, но конкретно¶

Хороший стартовый запрос обычно включает цель, рамки и важные ограничения.

Например:

Добавь форму логина с валидацией и не меняй существующий стиль компонентов

Или так:

Добавь CRUD для пользователей.
Используй существующие паттерны проекта.
Не добавляй новые зависимости без необходимости.

Шаг 3. При необходимости настройте политику действий¶

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

Шаг 4. Следите за ходом работы¶

После запуска агент начинает двигаться по задаче шаг за шагом. В процессе он может:

• изучать файлы и структуру проекта;
• уточнять детали;
• предлагать изменения;
• просить подтверждение перед более чувствительными действиями.

Как получить лучший результат¶

Формулируйте рамки заранее¶

Чем понятнее ограничения в начале, тем меньше лишних шагов потом.

✅ Хорошо:

Сделай рефакторинг только в src/auth/
Не меняй публичные интерфейсы
Тесты не запускай, я проверю сам

Ограничивайте область задачи¶

Если вам не нужно, чтобы агент расползался по проекту, так и скажите.

Работай только в папке src/components/profile
Не трогай конфигурацию и соседние модули

Просите идти небольшими порциями¶

Когда задача чувствительная, удобно явно попросить размер шага:

Делай по одному файлу за раз и показывай изменения перед следующим шагом

Так легче контролировать результат и вовремя скорректировать курс.

Типовые сценарии¶

Добавление функциональности¶

Добавь пагинацию в список пользователей и придерживайся текущего стиля API

Рефакторинг¶

Вынеси валидацию из сервиса аутентификации в отдельный модуль, не меняя внешнее поведение

Исправление ошибки¶

Разберись, почему здесь возникает утечка памяти, и предложи минимальное исправление

Работа по существующим паттернам¶

@src/components @src/theme
Создай новый компонент в том же стиле, что и существующие

Как сочетать агента с контекстом¶

Агент умеет сам собирать нужный контекст по ходу работы, но вы можете ускорить его, если сразу укажете важные файлы, папки или материалы через @.

Например:

@src/types/index.ts @src/utils/
Создай сервис, который использует эти типы и утилиты

Подробнее об этом — на странице Выбор контекста.

Если агент пошёл не туда¶

Это нормальная рабочая ситуация. Лучше не ждать, пока ошибка разрастётся.

Обычно помогает один из вариантов:

• остановить выполнение;
• уточнить рамки задачи;
• попросить вернуться к более узкому варианту;
• начать заново с более точной постановкой.

Например:

Стоп. Не трогай остальные файлы.
Сосредоточься только на исправлении в src/auth/service.ts

Практические советы¶

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

Что важно с точки зрения безопасности¶

Агент очень полезен именно потому, что умеет действовать, а не только отвечать. Поэтому для чувствительных операций лучше сохранять привычку к контролю:

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