Управление агентом¶

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

Поле запроса¶

Поле ввода с подсказкой Опишите задачу или добавьте файл через @ отправляет текст в активную сессию.

• Enter отправляет сообщение.
• Shift+Enter добавляет новую строку.
• Стоп останавливает работу в чате, включая фоновых субагентов.

Если активной сессии ещё нет, приложение создаст её для выбранного проекта при первой отправке.

Кнопка Добавить файлы рядом с полем добавляет вложения к следующему сообщению. После добавления файлов поле меняет подсказку на Напишите, что сделать с этими файлами.

Задачу можно и надиктовать голосом — кнопка слева от кнопки отправки распознаёт речь и вставляет текст в черновик.

Режим подтверждений¶

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

Доступные режимы:

• Запрашивать — агент будет просить разрешение на действия, которым нужен явный ответ пользователя.
• Авто-правки — агент может выполнять часть безопасных правок без отдельного вопроса.
• Без подтверждений — агент работает с минимальным количеством интерактивных остановок.

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

Read-only¶

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

Этот режим полезен для:

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

Запросы разрешений¶

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

Модель¶

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

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

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

Стоимость моделей¶

В раскрытом списке моделей рядом с названием может отображаться множитель стоимости — коэффициент в формате x3, показывающий, сколько от лимита потребляет один запрос к этой модели.

Чем выше множитель, тем больше токенов расходуется на запрос. Для экономии лимитов выбирайте модели с меньшим множителем для простых задач.

Множитель отображается только в списке выбора: свёрнутый чип модели показывает чистое имя без коэффициента. Коэффициент x1 не показывается — он ничем не отличается от моделей без множителя.

Пользовательские модели¶

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

Модели и изображения¶

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

Размышления модели¶

Некоторые модели умеют обдумывать запрос перед ответом.

Чем глубже размышления, тем больше времени и токенов модель тратит на анализ и тем выше качество ответа на сложных задачах. Низкие уровни отвечают быстрее и экономнее.

Во время обдумывания в чате видно живое превью размышлений — см. Что видно во время ответа.

Где переключается уровень¶

Рядом с чипом модели в композере находится переключатель размышлений. Он появляется только для моделей, которые поддерживают размышления.

Список уровней:

Каждая модель поддерживает свой набор уровней — в списке видны только доступные для выбранной модели.

Как переключить с клавиатуры¶

Уровень размышлений можно менять горячими клавишами, не открывая список:

• ⌘⌥↑ / Ctrl + Alt + ↑ — на шаг сильнее;
• ⌘⌥↓ / Ctrl + Alt + ↓ — на шаг слабее.

На границе доступного списка переключение останавливается.

Как сохраняется выбор¶

Выбор уровня запоминается для каждой модели.

Если агент запущен, новый уровень передаётся в живую сессию. Если агент не запущен, выбор сохраняется в общие настройки — тот же ключ, который использует команда /reasoning в CLI. Поэтому уровень, заданный в Desktop, учитывается и в CLI, и наоборот.

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

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

Чип режима показывает роль агента для новой задачи, например Стандартный или один из ваших пользовательских режимов.

Когда менять режимы¶

Выбирайте режим под тип задачи:

• Только чтение — анализ, ревью, поиск причин, подготовка плана.
• Запрашивать — правки в незнакомом коде, миграции, конфиги, изменения сборки.
• Авто-правки — небольшие UI-правки, тексты, тесты, локальные исправления.
• Без подтверждений — быстрые черновики и задачи, где вы готовы принять изменения целиком.

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

План¶

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

Когда агент публикует план, над чатом появляется панель План со списком шагов и их статусами.

Как останавливать задачу¶

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

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

После остановки можно отправить новый запрос в тот же чат или создать новый чат для чистого контекста.

Если у агента есть фоновые субагенты, они отменяются вместе с ним — см. остановка чата с субагентами.

Почему задача остановилась¶

Если задача закончилась не обычным ответом, приложение пишет в ленту чата предложение с причиной:

• Ход остановлен по вашей команде. — вы нажали Стоп;
• Ход остановлен: модель повторяла одни и те же действия без продвижения. — сработала защита от зацикливания, переформулируйте запрос или подскажите, что сделать иначе;
• Ход остановлен: слишком много обращений к модели без итогового ответа. — отправьте новое сообщение, чтобы продолжить;
• Ответ оборван: закончился лимит токенов модели. — модель исчерпала доступный размер ответа;
• Модель отказалась выполнять запрос. — модель вернула отказ.

Причины, на которые стоит отреагировать, помечаются предупреждением.

Зацикливание и превышение числа обращений к модели не считаются успешным завершением: уведомление «Koda завершил работу» не приходит, а задача по расписанию не помечается выполненной.