BroadRouter
Начать

Субагент (subagent)

Обновлено

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

Также называют: субагент, саб-агент, подагент, дочерний агент, sub-agent, subagent, child agent

Субагент — это делегирование для агентов: отдайте одну задачу свежему исполнителю и получите назад только ответ.

Как это работает

Основной агент решает, что задача самодостаточна, например «найди все вызовы этой функции» или «запусти тесты и сообщи о падениях». Он запускает субагента с описанием задачи. Субагент крутит собственный агентный цикл и возвращает результат.

В документации Claude Code это сформулировано так: “Each subagent runs in its own context window with a custom system prompt, specific tool access, and independent permissions.” (перевод: «Каждый субагент работает в собственном контекстном окне со своим системным промптом, определённым доступом к инструментам и независимыми разрешениями».) Субагент описывается файлом Markdown с фронтматтером YAML, на уровне проекта — в .claude/agents/:

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

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

В других фреймворках есть похожие идеи. В OpenAI Agents SDK сказано: “Handoffs allow an agent to delegate tasks to another agent,” (перевод: «Handoffs позволяют агенту делегировать задачи другому агенту»), и каждый handoff представлен модели как инструмент.

Статья Anthropic о context engineering описывает этот паттерн со стороны контекста: каждый субагент работает в чистом контекстном окне и “returns only a condensed, distilled summary of its work,” (перевод: «возвращает лишь сжатую, выжатую сводку своей работы»), часто на 1 000–2 000 токенов.

Почему это важно

  • Контекст. Прогон тестов может вывести десятки тысяч токенов. В субагенте этот вывод не попадает в основное контекстное окно; возвращается только сводка. Это ключевой инструмент context engineering.
  • Стоимость. Общее число токенов обычно растёт, потому что каждый субагент загружает собственный промпт и инструменты. Множитель оценивается в статье о стоимости мультиагентных систем.
  • Параллельность. Субагенты, работающие одновременно, — это параллельные запросы. Сколько их выполнится разом, определяет лимит параллельности вашего провайдера.

В BroadNet Inference

BroadNet обслуживает модели; логика субагентов живёт в вашем агентном инструменте. Любой инструмент, который принимает OpenAI-совместимый базовый URL, может направить на BroadNet и основного агента, и субагентов, причём с разными моделями для каждого.

При оплате по факту ключ допускает 4 одновременных запросов. На тарифах с фиксированной ценой для DeepSeek V4.1 Flash каждая сессия выполняет один запрос за раз, поэтому считайте, сколько запросов к модели может выполняться в один и тот же момент: трём одновременно работающим субагентам нужны три сессии, а если оркестратор тоже обращается к модели, пока они работают, — четыре. Подробно расчёт числа сессий разобран в статье о параллельных агентах для кода на API с фиксированной ценой.

Вопросы и ответы

Экономит ли субагент токены?

Он экономит контекст основного диалога, а не общее число токенов. Собственные запросы субагента тоже стоят токенов. Документация Claude Code отмечает, что запросы субагентов всё равно расходуют ваш лимит использования, и советует для простых задач субагентов модель поменьше.

Может ли субагент запускать своих субагентов?

Зависит от инструмента. Документация Claude Code говорит, что по умолчанию субагент может запускать собственных субагентов, до трёх уровней ниже основного диалога, и что это можно ограничить.

Чем субагент отличается от handoff?

Субагент выполняет задачу и отчитывается перед агентом, который его вызвал. В OpenAI Agents SDK handoff позволяет одному агенту делегировать работу другому, а хелпер handoff() передаёт управление этому агенту.

Открыть в MarkdownСпросить ChatGPTСпросить ClaudeСпросить Perplexity