Агенты в облаке: Agents API на обвязке Codex

OpenAI открыла Agents API, управляемый сервис на обвязке Codex, который держит на себе сессии, оркестрацию, сжатие контекста и восстановление после сбоев. Приложение поставляет инструменты и выбирает среду исполнения, следует из анонса OpenAI.

Коротко

• Агент работает в песочнице, где выполняет команды и код, правит файлы, применяет навыки, подключается к MCP-серверам и внешним данным через инструменты и отдаёт готовые артефакты.
• Тарификация раздельная: модель по обычным ставкам API выбранной модели, инструменты OpenAI по своим стандартным ставкам, песочницы на стороне OpenAI по стандартным ставкам контейнеров, то есть расход складывается из трёх отдельных статей.
• Сервис доступен с размещением данных только в США и без режима Zero Data Retention, причём собственная песочница на стороне приложения права на ZDR тоже не даёт.

Agents API выглядит как попытка перенести в управляемый сервис трудоёмкий слой агентных приложений: удержание длинной сессии, сжатие контекста, восстановление после сбоя и разбиение работы между субагентами. Команды, которые собирали эту логику сами, получают готовую замену, но вместе с ней и зависимость от чужой инфраструктуры. Ограничение по размещению данных в США и отсутствие Zero Data Retention, вероятно, оставят часть регулируемых нагрузок за пределами сервиса.

Сервис описан через четыре понятия: агент, среда, сессия и события

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

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

Состояние сессии сервис хранит на своей стороне, поэтому продолжать работу между ходами можно без пересборки контекста разговора. Сессии и опубликованные артефакты приложение удаляет само, когда они перестают быть нужны. Инструменты и выбор среды исполнения при этом остаются на стороне приложения.

В примере из документации агент работает на gpt-6-astra с лимитом в четыре субагента

Управляемая обвязка Codex выполняет команды и код в песочнице, подхватывает подходящие навыки и инструкции, ходит за внешними данными через инструменты и MCP, принимает правки от приложения по ходу работы, сворачивает предыдущие шаги в сводку ради контекстного окна, делит работу на подзадачи для субагентов и возобновляет сессию с места остановки.

В примере из документации сессия создаётся вызовом client.beta.agents.sessions.create с моделью gpt-6-astra и набором инструментов: программный вызов инструментов, MCP-сервер документации OpenAI по HTTP на developers.openai.com/mcp и веб-поиск. Мультиагентный режим там включён с лимитом в четыре одновременных субагента, а среда указана как self_hosted с рабочим каталогом /workspace и каталогом навыков внутри него.

Среда бывает двух видов: песочница, которую разворачивает и обслуживает OpenAI, и собственная площадка приложения. В варианте с хостингом OpenAI приложение отправляет ввод и получает события, а запуск агента и обслуживание песочницы берёт на себя сервис. Требования к правам API-ключа и настройке SDK вынесены в раздел с быстрым стартом.

OpenAI показывает пять готовых приложений, от разбора инцидентов до ревью документов

В документации OpenAI выложены два полных примера работы сервиса. Первый создаёт и запускает скрипт, который строит дерево каталогов, внутри песочницы, развёрнутой на стороне OpenAI. Второй поручает сравнение release notes нескольким субагентам и сводит их отдельные находки в один общий ответ.

Отдельно перечислены пять готовых приложений: агент разбора инцидентов, который расследует алерты и запрашивает подтверждение на восстановительные действия; Slack-бот, разбирающий запросы через подключённые рабочие инструменты; аналитик данных, отвечающий на вопросы к хранилищу запросами SQL только на чтение; исследователь issue на GitHub, который воспроизводит баги и публикует результаты; ревьюер документов, работающий с политиками через навыки и специализированных агентов.

Бета-неймспейс и границы доступности. Вызов в примере идёт через client.beta.agents.sessions.create, то есть метод находится в beta-неймспейсе SDK, а сроков перевода в стабильную версию OpenAI не называет. Планы по расширению резидентности за пределы США и по поддержке Zero Data Retention в документации тоже не описаны. Детали хранения и удаления данных OpenAI выносит в раздел о контроле данных на платформе.