ИИ-агенты и автоматизация

OpenAI Agents API: харнесс Codex отдали по API

OpenAI Agents API: харнесс Codex отдали по API

OpenAI открыла Agents API и отдала наружу собственный харнесс Codex: цикл агента крутится на её стороне, она же хранит сессии, сжимает контекст и запускает инструменты в песочнице. Это третий рантайм рядом с Agents SDK и Responses, и отличаются они одним — где выполняется цикл и кто хранит состояние. Из России путь закрыт целиком, потому что упирается в оплату и в страну, а не в технику. Собрать тот же цикл руками можно на любом совместимом шлюзе: ставки нашего каталога на 12 сентября 2026 года начинаются от 1 ₽ за миллион токенов.

Разберём, что именно вендор отдал наружу, чем три его рантайма различаются на практике и что из этого воспроизводится своими руками.

Что такое харнесс и почему это важно

Харнесс — это обвязка вокруг модели: то, что решает, когда звать инструмент, что класть в контекст на следующем шаге, как обрабатывать ошибку инструмента и когда останавливаться. Модель сама по себе агентом не является, она отвечает на запрос. Агентом её делает цикл вокруг.

До сих пор харнесс Codex был внутренней деталью продукта. Теперь вендор предлагает его как сервис: вы описываете агента, а инфраструктуру, сессии и порядок шагов держит он. В документации это сформулировано прямо — OpenAI запускает управляемый харнесс Codex и берёт на себя инфраструктуру, чтобы вы занимались тем, что агент делает.

Три рантайма и чем они отличаются

Вендор публикует таблицу сравнения. Существенных различий три.

ПараметрAgents APIAgents SDKResponses
Где крутится циклу OpenAIв вашем приложенииу вас целиком
Состояние между задачамихранит вендорваше хранилищевручную
Трудоёмкость интеграциинизкаясредняявысокая

Логика выбора из этого следует простая. Чем больше отдаёте вендору, тем меньше пишете сами и тем меньше контролируете. Agents API забирает максимум: конфигурацию сессии, ходы, элементы диалога и сжатие контекста. Responses не забирает ничего, кроме самого вызова модели.

Что входит в Agents API

По документации, помимо самого цикла вендор берёт на себя:

  1. Автоматическое сжатие контекста. Главная боль длинных сессий: история переотправляется на каждом шаге и растёт нелинейно.
  2. Оркестрацию нескольких агентов. Передача задачи между агентами как штатная возможность.
  3. Программный вызов инструментов. Оркестрация вызовов кодом, а не только решением модели.
  4. Подключение MCP-серверов. Тот же протокол, про который мы писали в разборе что такое MCP.
  5. Песочницы. Своя у вендора, ваша собственная или никакой.
  6. Вебхуки, наблюдаемость и трассировку. То, что обычно дописывают руками через месяц после запуска.

Список честно закрывает те места, где самодельные агенты ломаются чаще всего. Сжатие контекста и трассировка в самописном цикле появляются последними, а нужны с первого дня.

Песочница: главный пункт для безопасности

Отдельного внимания заслуживает выбор среды выполнения. Вендор даёт три варианта: его песочница, ваша песочница, без песочницы.

Третий вариант звучит удобно и означает, что инструменты агента выполняются в вашей инфраструктуре без изоляции. Для агента, который читает файлы и запускает команды, это ровно тот сценарий, из которого вырастают инциденты: мы разбирали случаи, когда агент удалял файлы и когда агенты уходили из песочницы.

Практическое правило не меняется от того, чей рантайм вы взяли: агенту дают минимальные права, а не удобные. Разбор того, что именно стоит разрешать, — в статье права агента: что разрешать.

Сколько это стоит

Отдельной цены за сам рантайм вендор не публикует: расход идёт за токены выбранной модели плюс инструменты, которые тарифицируются отдельно. Ставки на 12 сентября 2026 года у OpenAI начинаются от 0,20 доллара за миллион входных токенов у младшей модели линейки и доходят до 10 долларов у флагмана.

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

Ставки нашего каталога для агентских задач на ту же дату, рубли за миллион токенов, одинаково на вход и на выход:

Модель₽ за миллионПод что
deepseek-v4-flash1дешёвая рутина в цикле
qwen-3-6-flash3быстрые шаги и классификация
glm-5-3-flash5недорогие рабочие агенты
haiku-4-58массовые операции
grok-4-20-multi-agent20параллельная агентная работа
opus-530сложная архитектура и разбор

Что из этого воспроизводится руками

Почти всё, и это стоит понимать до того, как вы привяжетесь к чужому рантайму.

Цикл агента — это тридцать строк кода: отправить запрос с описанием инструментов, получить решение модели, выполнить инструмент, вернуть результат, повторить. Всё остальное в Agents API — удобства вокруг этого цикла, и каждое из них имеет самодельный аналог.

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

Разница не в возможностях, а в том, сколько вы напишете сами и насколько потом сможете уйти. Подробный разбор устройства цикла — в статье как сделать ИИ-агента.

Четыре вопроса перед выбором рантайма

Решение принимается не по списку возможностей, а по четырём ответам.

Кто держит состояние? Если сессии агента живут у вендора, то перенос на другой стек означает потерю истории. Для внутреннего инструмента это терпимо, для продукта с клиентами — нет.

Где выполняются инструменты? Инструмент, который ходит в вашу базу, не может выполняться в чужой песочнице. Это не вопрос доверия, а вопрос сетевого доступа и того, где лежат секреты.

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

Сколько стоит уход? Разница между рантаймами измеряется не в удобстве на старте, а в объёме работы при переезде. Цикл переписывается за день, а привязка к чужому хранилищу сессий и формату событий — нет.

Чем агент отличается от чат-бота в счёте

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

Пример на нашей ставке. Задача в пять шагов, где история к последнему шагу выросла до 20 000 токенов, а ответы по 500: суммарно уходит около 60 000 входных токенов вместо 20 000 у одноразового вызова. На позиции за 8 ₽ за миллион это доли рубля, на флагмане за 30 ₽ — уже заметная сумма при тысяче задач в день.

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

Что это значит для тех, кто в России

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

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

Чего мы не утверждаем

Мы не тестировали Agents API: доступ к нему из России закрыт, а писать о качестве по чужим отзывам мы не будем.

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

Мы не называем цену самого рантайма, потому что отдельного тарифа за него в документации нет, а придумывать числа мы не станем.

Что нужно, чтобы собрать своего агента

Ключ заводится за минуту на keydealer.ru/login — почта и пароль, без документов и без зарубежной карты. Оплата российской картой в рублях, один ключ на все 53 позиции каталога.

Платные текстовые модели доступны сразу на приветственном бонусе: собрать первый цикл с одним инструментом и посмотреть, во что он обходится, можно без пополнения.

Что держать в голове

Agents API — это чужой харнесс как сервис. Вы отдаёте цикл, состояние и песочницу, взамен получаете низкую трудоёмкость интеграции и привязку к одному вендору.

Всё, что он делает, имеет самодельный аналог, и цикл агента сам по себе прост. Сложное в агентах — не цикл, а права, сжатие контекста и наблюдаемость.

Из России новый рантайм недоступен по тем же причинам, что и остальной API вендора, и техника тут ни при чём. Как мы проверяем факты и почему у каждой цифры стоит дата — на странице о проекте. Завести ключ: keydealer.ru/login.

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

Что такое OpenAI Agents API?

Это способ запустить агента, где сам цикл работы выполняет OpenAI на своей стороне. Вендор описывает это как управляемый харнесс Codex: он держит инфраструктуру, сессии и сжатие контекста, а вы описываете, что агент делает.

Чем Agents API отличается от Agents SDK?

Местом, где крутится цикл. В Agents API агента запускает OpenAI и сохраняет его прогресс, в SDK цикл работает внутри вашего приложения, а хранение состояния и развёртывание остаются на вас.

Нужен ли Agents API, если есть Responses?

Не обязательно. Responses — это прямые вызовы модели, из которых агент собирается вручную. Вендор сам оценивает трудоёмкость интеграции как высокую у Responses, среднюю у SDK и низкую у Agents API.

Где выполняются команды агента?

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

Работает ли это из России?

Нет, по тем же причинам, что и остальной API OpenAI: карта российского банка на оплате отклоняется, а доступ ограничен списком поддерживаемых стран.

Чем заменить агентский рантайм без доступа к OpenAI?

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

Источники