Инструменты агента¶
Сила агентского режима в том, что он умеет не только рассуждать, но и действовать в пределах доступных ему возможностей. Именно поэтому он может продвигаться по задаче, а не просто предлагать идеи.
При этом важна не столько точная внутренняя классификация инструментов, сколько понимание: что агент вообще умеет делать от вашего имени и где лучше оставлять подтверждение за собой.
Что агент умеет делать¶
Обычно инструменты агента покрывают несколько практических сценариев.
Читать и изучать проект¶
Агент может:
Это особенно полезно в начале задачи, когда нужно сначала понять, как всё устроено.
Предлагать и вносить изменения¶
Агент умеет:
Именно на этом этапе особенно важно держать под контролем чувствительные или большие изменения.
Использовать внешний контекст¶
В зависимости от настроек агент может обращаться к документации и другим внешним источникам, если это помогает решить задачу точнее.
Запускать команды¶
Для некоторых задач агенту бывает полезно выполнить команду: например, чтобы проверить результат, посмотреть вывод или воспроизвести проблему. Это одна из самых чувствительных зон, поэтому её обычно разумно оставлять с подтверждением.
Инструменты в Koda¶
Koda предоставляет набор встроенных инструментов для работы с проектом:
| Инструмент | Описание |
|---|---|
read_file |
Чтение содержимого файлов |
edit_file |
Редактирование файлов с заменой текста |
create_new_file |
Создание новых файлов |
run_terminal_command |
Выполнение команд в терминале |
grep_search |
Поиск по коду с помощью ripgrep |
file_glob_search |
Поиск файлов по маске |
view_diff |
Просмотр изменений в рабочей директории |
fetch_url_content |
Получение содержимого веб-страниц |
docs_search |
Поиск по документации библиотек |
search_web |
Поиск информации в интернете |
read_skill |
Загрузка навыков (скиллов) |
Как управлять инструментами¶
В интерфейсе можно настроить политику для разных действий. Обычно используются три режима:
- автоматически — агент выполняет действие без отдельного запроса;
- с подтверждением — агент сначала показывает намерение и ждёт вашего решения;
- выключено — агент не использует этот тип действий.
Если вы только осваиваетесь, самый безопасный рабочий вариант — оставлять подтверждение для изменений файлов и запуска команд.
Для пользователя здесь важнее всего не список внутренних названий инструментов, а прозрачность: что именно агент собирается сделать сейчас и почему.
Если агент использует слишком много действий¶
Если кажется, что он читает лишнее, уходит слишком широко или предлагает больше шагов, чем нужно, попробуйте:
- сузить область задачи;
- указать конкретные папки или файлы;
- перевести чувствительные действия в режим подтверждения;
- попросить работать по одному шагу за раз.