✴️ Subagents в Codex — небольшой стартовый гайд для общего понимания
В Codex появились subagents — дочерние агенты, которых вы запускаете вручную для параллельной работы. Каждый из них работает со своими инструкциями, настройками модели и инструментами, а затем Codex объединяет их результаты в один ответ.
Это особенно полезно для задач, которые можно разбить на части — например, ревью PR, исследование кода или дебаг, где один агент анализирует, другой проверяет, третий реализует.
Важно:
🟡 субагенты не запускаются автоматически — только по вашему запросу
🟡 каждый агент выполняет свою работу отдельно → это увеличивает расход токенов
Кастомные агенты
В Codex есть встроенные агенты (default, worker, explorer), но основная сила — в собственных агентах.
Они задаются через TOML-файлы в:
🟡 ~/.codex/agents/
🟡 .codex/agents/Минимально нужно указать:
🟡 name — имя
🟡 description — описание
🟡 developer_instructions — инструкции
Пример:
name = "reviewer" description = "PR reviewer focused on correctness, security, and missing tests." developer_instructions = """ Review code like an owner. Prioritize correctness, regressions, security, and missing test coverage.
Лучшие агенты — узкоспециализированные.
Один агент = одна роль. Если агент делает всё сразу, теряется смысл разделения.
Как работает runtime
Субагенты:
🟡 наследуют sandbox и разрешения основной сессии
🟡 работают как параллельные воркеры, а не отдельные независимые сессии
Глобальные настройки:
[agents] max_threads = 6 max_depth = 1
🟡 max_threads — сколько агентов может работать одновременно
🟡 max_depth — глубина делегирования (агенты внутри агентов)
Как правильно использовать
Хороший паттерн — разбивать задачу на роли:
🟡 pr_explorer — находит затронутые части кода
🟡 reviewer — ищет баги и уязвимости
🟡 docs_researcher — проверяет API и документацию
Пример запроса:
Review this branch against main. Have pr_explorer map the affected code paths, reviewer find real risks, and docs_researcher verify the APIs the patch relies on. Wait for all agents and summarize the findings.
Советы по использованию
🟡
используйте субагентов только если задача реально
параллелится
🟡
делайте агентов
узкими и понятными
🟡
для анализа используйте
read-only sandbox
🟡
быстрые модели — для поиска, сильные — для оценки
🟡
не увеличивайте глубину без необходимости
Главная идея
Subagents — это не просто про скорость.
Это про разделение ролей, чистый контекст и более точную декомпозицию сложных задач.
Подробнее в документации:
Codex Subagents

Добавить комментарий