Субагенты¶
Во вкладке Субагенты настраиваются фоновые субагенты — параллельные подзадачи для долгого исследования.

Вкладка Субагенты окна настроек
Если установленная версия Koda CLI не поддерживает субагентов, вкладка сообщит об этом — обновите CLI или переключитесь на встроенный режим в разделе «Общие».
Субагенты выключены по умолчанию, и пока переключатель выключен, на вкладке виден только он. Остальные параметры появляются после включения.
Параметры¶
- Включить фоновых субагентов — главный переключатель; если выключить, агент перестанет делегировать подзадачи;
- Продолжать работу основного агента — продолжает ли основной агент работу, пока субагенты исследуют (см. ожидание субагентов);
- Одновременно задач — лимит параллельных субагентов; предлагается в границах, которые назвал агент;
- Модель субагентов — отдельная модель или вариант «Как у основного агента»;
- Уровень рассуждений — уровень рассуждений субагентов; выбирается из тех, что умеет модель субагентов, а пока она наследуется от основного агента — из уровней его модели; «По умолчанию для модели» — это стандартный уровень самой модели, а не тот, что выбран в основном чате;
- Бюджет одной задачи, минут — максимальное время работы одного субагента: от 1 до 1440;
- Считать подвисшим через, минут — порог ожидания признаков жизни: не меньше 0,25;
- Инструменты субагента — список разрешённых инструментов; по умолчанию все доступные.
Список инструментов только сужает то, что агент и так готов дать субагенту: там уже нет ничего пишущего и нет инструментов, которые спросили бы подтверждение, ответить на которое фоновой задаче некому. Пока отмечено всё, новые инструменты подхватываются сами; если снять отметки со всех, субагент будет отвечать без поиска.
Если сохранённая модель исчезла из списка, она показывается отдельной строкой с пометкой «недоступна» — выбор не подменяется молча на «как у основного агента».
Общие роли субагентов¶
Ниже инструментов лежит раздел «Общие роли субагентов» — роли из ~/.kodacli/agents, доступные во всех проектах: у каждой переключатель, карандаш, корзина и кнопка запуска.
Роли проекта, из .koda/agents открытого чата, живут в чипе Субагенты над полем ввода — см. роли субагентов.
Каталог читает агент открытого чата, поэтому без чата раздел пуст.
Когда изменения вступают в силу¶
Настройки общие для всех чатов и хранятся у CLI, а не в разговоре. Кнопки сохранения нет: каждое изменение записывается сразу, а число минут уходит в настройки через мгновение после ввода.
Переключатель Включить фоновых субагентов запущенный агент применяет со следующего сообщения; агент старой версии увидит его только после перезапуска чата, о чём подсказка под переключателем говорит прямо. Остальные параметры живой агент подхватывает сразу. Снижение лимита не останавливает уже запущенные задачи.
Настройки общие для Desktop и CLI
Параметры субагентов хранятся в файле настроек CLI (~/.kodacli/settings.json, блок subagents), поэтому значение, заданное в Desktop, действует и в Koda CLI, и наоборот.
Подробнее о параметрах — в конфигурации CLI.
О работе субагентов и панели задач в чате — на странице субагентов.