Субагенты и фоновые задачи

Субагент — помощник, которому агент поручает часть задачи. Субагент ведёт с моделью отдельный разговор, делает свою часть и возвращает агенту короткий итог. Так подробности не засоряют основной чат, а независимые части задачи идут параллельно.

#Когда агент запускает субагентов

Агент решает сам. Обычно поводы такие:

• поиск по большому проекту — найти, где что лежит и как устроено;
• независимые части задачи, которые можно делать одновременно. В Flow, пока проверяется один шаг плана, агент может взяться за следующий, если тот не зависит от первого (см. Flow);
• ваша прямая просьба: «поручи это субагенту», «проверь параллельно».

В ленте запуск выглядит как строка «Субагент» с кратким описанием поручения. Если режим требует спрашивать, перед запуском появится карточка «Запустить субагента?» (см. Разрешения и вопросы агента).

#Где следить: «Фоновые задачи»

Откройте в правой колонке вкладку «Задачи». Если колонки не видно, нажмите кнопку «Правая колонка» — последнюю в правом краю шапки окна. Пока в центре открыт файл, изменения или база данных, на месте «Задач» стоит вкладка «Агент»; закроете их — и «Задачи» вернутся (см. Окно приложения).

Во вкладке есть раздел «Фоновые задачи»:

У каждого субагента видны тип («общий» или «поиск по коду») и состояние: «идёт …» со временем работы, «готово» или «ошибка». Тип выбирает агент, когда запускает субагента: «общий» — для исследования и многошаговых частей задачи, «поиск по коду» — чтобы быстро найти файлы и разобраться, как устроен код. У субагентов, которых вы завели сами, вместо типа написано имя.

• Посмотреть, что делает субагент — нажмите на строку, и откроется его разговор. Чтобы вернуться, нажмите на строку «Фоновые задачи» вверху.
• Остановить — нажмите кнопку «Стоп» у работающего субагента. В строке появится «останавливается…», потом «остановлен».
• Субагент из другого чата — нажмите на строку, и откроется его чат.

Пока ничего не запущено, блоков нет, а в колонке видна строка «Субагенты сессии и серверы, запущенные из ADE, появятся здесь».

#Решения и вопросы субагентов

Своего чата в списке у субагента нет, поэтому разрешения и ответа он ждёт в чате, откуда его запустили: там появится карточка с подписью «Субагент «…» ждёт вашего решения» или «… ждёт вашего ответа». В списке чатов этот чат получит статус «Субагент ждёт решения: …» или «Субагент задал вопрос».

Субагент работает с правами чата, откуда его запустили. В режиме «Полный» агент спрашивает только перед самым опасным, и субагент сам делает всё, что этот режим разрешает. Режим «Без ограничений» включают для одного чата, когда доверяют агенту работу без присмотра. В таком чате у субагента тоже нет ограничений, но с ключами, файлами .env и сетью для него действуют правила «Полного» (см. Режимы агента).

#Модель субагентов

Субагенты могут работать на модели дешевле, чем у чата. Настроить это можно так:

1. Откройте «Настройки → Аккаунт и тариф».
2. В блоке «Расход лимита» найдите строку «Модель для помощников агента».
3. Выберите вариант:

Выбор действует сразу, в том числе в уже открытых чатах. А можно сказать прямо в чате: «субагентам — ту же модель». Подробнее о моделях — в разделе Модели.

#Свои субагенты

Можно завести и своего помощника: описать роль, когда его звать и как ему работать. Такой помощник — Markdown-файл в папке ~/.koder/agents. Агент зовёт его сам, когда задача подходит под описание, или по вашей просьбе. Как написать файл — в разделе Свои команды и агенты.

#Ограничения

• В списке чатов субагентов нет: их видно только в «Фоновых задачах» и по строке «Субагент» в ленте.
• Для проекта на сервере кнопка «Открыть» у портов недоступна: порт открыт на сервере, на вашем компьютере его нет.
• Каждый субагент тратит лимит подписки, как и основной агент.

#Что дальше

• Модели — модель «Авто», усилие, модель субагентов.
• Свои команды и агенты — свои типы субагентов.
• Список чатов и параллельные задачи — как работать в нескольких чатах сразу.