Субагенты Codex: как разделить задачу и принять результат

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

Что такое субагент в Codex

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

• Главный агент хранит общий результат и решает конфликты.
• Субагенту нужна одна ограниченная цель и формат ответа.
• Независимые проверки хорошо выполняются параллельно.
• Совместная запись в одни файлы требует последовательности или разделения владения.

Карта результата до запуска

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

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

По теме: Бесплатный ИИ-агент для программирования: как выбрать

Пошаговый безопасный запуск

1. Сформулируйте общий результат и критерии приёмки.
2. Разбейте работу по вопросам: архитектура, безопасность, тесты и документация.
3. Для каждого вопроса задайте границы чтения и запретите изменения, если нужен отчёт.
4. Укажите формат: вывод, доказательство, риск и рекомендуемое действие.
5. Попросите главный агент дождаться всех результатов и разобрать противоречия.
6. После сводки запустите общие тесты и просмотрите итоговый diff одним потоком.

Проверяемый чек-лист приёмки

• Все запущенные подзадачи завершились или явно помечены как незавершённые.
• Каждое замечание привязано к файлу, тесту или источнику.
• Совпадающие выводы объединены, разногласия не скрыты.
• Ни один файл не изменялся двумя агентами одновременно.
• Финальные тесты выполнены после объединения результатов.

Как выбрать подходящий вариант

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

По теме: Codex Security: что это и как безопасно начать проверку кода

Диагностика частых сбоев

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

Что ещё проверить

Перед делегированием полезно составить план в режиме планирования Codex. Для выбора прав прочитайте про режимы Sandbox, а роли удобно сверить с материалом про команду ИИ-агентов.

По теме: Codex Sandbox: режимы, разрешения и безопасная проверка

Ограничения и случай, когда способ не подходит

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

Частые вопросы

Нужен ли агент для каждого файла?

Нет. Делите по независимым вопросам и зонам ответственности, а не по числу файлов.

Можно ли всем разрешить запись?

Только при непересекающихся каталогах и понятном владельце интеграции. Для ревью безопаснее чтение.

Что вернуть от каждого субагента?

Короткий вывод, проверяемое доказательство, открытый риск и одно рекомендуемое действие.