Перейти к содержанию

Субагенты

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

Вкладка Субагенты окна настроек

Вкладка Субагенты окна настроек

Если установленная версия Koda CLI не поддерживает субагентов, вкладка сообщит об этом — обновите CLI или переключитесь на встроенный режим в разделе «Общие».

Субагенты выключены по умолчанию, и пока переключатель выключен, на вкладке виден только он. Остальные параметры появляются после включения.

Параметры

  • Включить фоновых субагентов — главный переключатель; если выключить, агент перестанет делегировать подзадачи;
  • Продолжать работу основного агента — продолжает ли основной агент работу, пока субагенты исследуют (см. ожидание субагентов);
  • Одновременно задач — лимит параллельных субагентов; предлагается в границах, которые назвал агент;
  • Модель субагентов — отдельная модель или вариант «Как у основного агента»;
  • Уровень рассуждений — уровень рассуждений субагентов; выбирается из тех, что умеет модель субагентов, а пока она наследуется от основного агента — из уровней его модели; «По умолчанию для модели» — это стандартный уровень самой модели, а не тот, что выбран в основном чате;
  • Бюджет одной задачи, минут — максимальное время работы одного субагента: от 1 до 1440;
  • Считать подвисшим через, минут — порог ожидания признаков жизни: не меньше 0,25;
  • Инструменты субагента — список разрешённых инструментов; по умолчанию все доступные.

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

Если сохранённая модель исчезла из списка, она показывается отдельной строкой с пометкой «недоступна» — выбор не подменяется молча на «как у основного агента».

Общие роли субагентов

Ниже инструментов лежит раздел «Общие роли субагентов» — роли из ~/.kodacli/agents, доступные во всех проектах: у каждой переключатель, карандаш, корзина и кнопка запуска. Роли проекта, из .koda/agents открытого чата, живут в чипе Субагенты над полем ввода — см. роли субагентов.

Каталог читает агент открытого чата, поэтому без чата раздел пуст.

Когда изменения вступают в силу

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

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

Настройки общие для Desktop и CLI

Параметры субагентов хранятся в файле настроек CLI (~/.kodacli/settings.json, блок subagents), поэтому значение, заданное в Desktop, действует и в Koda CLI, и наоборот. Подробнее о параметрах — в конфигурации CLI.

О работе субагентов и панели задач в чате — на странице субагентов.