Проблемы с агентским режимом¶

Агент зацикливается¶

Симптомы: Повторяет одни и те же действия.

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

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

Решения:

1. Остановите агента (Esc или кнопка Stop)
2. Выполните /summarize, чтобы сжать контекст
3. Уточните задачу или начните новую сессию с кратким описанием оставшейся работы
4. Разбейте на меньшие подзадачи или выберите другую модель

Агент выполняет неверные действия¶

Причины:

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

Решения:

1. Остановите агента
2. Переформулируйте задачу конкретнее
3. Добавьте контекст через @
4. Отключите ненужные инструменты

Ошибка при редактировании файла¶

Причины:

• Файл не открыт
• Файл заблокирован
• Конфликт изменений
• Неправильный дифф

Решения:

1. Откройте файл в редакторе
2. Сохраните все изменения
3. Попробуйте применить вручную

Терминальная команда не выполняется¶

Причины:

• Неправильная команда
• Отсутствуют зависимости
• Проблемы с окружением

Решения:

1. Проверьте команду вручную
2. Убедитесь, что зависимости установлены
3. Проверьте рабочую директорию
4. Выполните ту же команду в своём терминале — вне Koda, чтобы сравнить поведение

Агент пропускает шаги¶

Причины:

• Задача слишком большая
• Ограничение токенов
• Ошибка в планировании

Решения:

1. Разбейте задачу на части
2. Используйте /summarize для длинных сессий
3. Контролируйте выполнение пошагово
4. Для сложных задач сначала составьте план в режиме планирования, а затем запустите его в агенте

Агент не выполняет действия¶

Причины:

• Инструменты отключены
• Требуется подтверждение действий

Решение:

1. Проверьте настройки инструментов в чате
2. Включите необходимые инструменты
3. Подтверждайте действия агента

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

Агент выполняет неверные действия¶

Решение:

1. Уточните задачу более подробно
2. Требуйте подтверждения для редактирования файлов
3. Отключите опасные инструменты (терминал)
4. Используйте обычный чат для простых задач