OpenAI Agents API или Agents SDK: что выбрать

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

Что выбрать?

Для небольшой платформенной команды, которая выпускает долго работающих ИИ-агентов, разумным выбором по умолчанию будет OpenAI Agents API. OpenAI запускает оркестратор Codex, хранит сессию и результаты работы, сжимает контекст, координирует субагентов и обеспечивает восстановление между асинхронными ходами. Так команда избавляется от целого пласта инфраструктурных задач, которые редко создают конкурентное преимущество продукта. OpenAI выпустила сервис в публичной бете 10 сентября 2026 года и заявляет, что он доступен всем разработчикам.

Для основателя стартапа с финансированием и небольшой бэкенд-командой, чей агент проверяет документы и может часами ждать согласования, управляемая сессия ценнее собственного цикла выполнения. Ограниченное время продуктовой команды лучше тратить на политики, инструменты, оценки качества и пользовательский опыт.

OpenAI Agents SDK предпочтительнее, если контроль среды выполнения — обязательное требование, а не пожелание. SDK работает внутри приложения, поэтому развертывание, хранение данных, логика согласований, реализация инструментов и стратегия управления состоянием остаются на вашей стороне. Техническому директору компании среднего сегмента с обязательной политикой Zero Data Retention сегодня стоит выбрать этот путь: публичная бета Agents API не поддерживает ZDR.

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

OpenAI Agents API и Agents SDK: главное отличие

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

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

Оркестратор и песочница — разные архитектурные решения

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

Среда может отсутствовать, размещаться у OpenAI или на вашей инфраструктуре. Без среды оркестратор по-прежнему способен обращаться к удаленным MCP-серверам и отправлять вызовы функций приложению, но встроенных Bash, apply-patch и файлов рабочего пространства у него не будет. В песочнице OpenAI компания предоставляет рабочее пространство Linux. В собственной среде ваш исполнитель запускает команды и файловые операции по запросу управляемого оркестратора. Это разделение прямо показано в руководстве по архитектуре.

Понимание этой разницы помогает избежать двух дорогих ошибок. Во-первых, выбирать Agents SDK только потому, что код должен работать в вашем VPC, преждевременно: Agents API умеет подключаться к собственной среде. Во-вторых, рассчитывать, что с Agents API OpenAI будет выполнять вообще все, тоже не стоит: обработчики функций приложения остаются в вашем коде, а при собственном исполнителе вы по-прежнему отвечаете за выделение ресурсов, повторное подключение, завершение работы и сохранение файлов.

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

Владение сессией: Agents API лучше справляется с долгими задачами

Agents API выигрывает, если жизненный цикл задачи длится дольше одного запроса к приложению. Сессия сохраняет конфигурацию агента, диалог и результаты работы. Когда сессия простаивает, новый ввод запускает асинхронный ход; если работа уже идет, он направляет активный ход. Приложение может читать поток событий или получать изменения состояния через вебхуки.

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

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

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

Откровенное ограничение — точность учета. Агенты могут делать несколько вызовов модели, а корневые агенты, субагенты, повторные попытки, инструменты и песочницы вместе формируют стоимость. OpenAI предупреждает, что показатели использования Agents API приблизительны, иногда равны null и могут позднее измениться; это не окончательный счет. Токены рассуждений считаются выходными, а кэшированные входные токены остаются платными. Для отладки используйте руководство по учету ресурсов, а для финансового контроля сверяйтесь с платежными данными.

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

Контроль среды выполнения и развертывания: преимущество Agents SDK

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

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

Управление состоянием здесь гибкое, а не автоматическое. Приложение на SDK может воспроизводить result.history, сохранять сессию SDK в своем хранилище, подключать идентификатор OpenAI Conversations или продолжать цепочку от идентификатора предыдущего ответа Responses API. Каждый вариант по-своему полезен, но руководство по запуску агентов предупреждает: если без явного согласования смешать локальное воспроизведение с состоянием на сервере, контекст может дублироваться.

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

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

Сравнение стоимости: отдельной платы за оркестратор нет

Если обе среды используют одну модель OpenAI, одинаковое соотношение токенов и одинаковые вызовы инструментов, счет за токены и размещенные инструменты совпадает. Цены сверены с действующими страницами OpenAI 11 сентября 2026 года. Стандартный тариф GPT-6 Astra для короткого контекста составляет $10.00 за 1 миллион входных токенов и $50.00 за 1 миллион выходных токенов. Веб-поиск стоит $10.00 за 1,000 вызовов плюс токены найденного контента по тарифу выбранной модели. Сам управляемый Agents API отдельной платы не добавляет.

Рассмотрим одну нормализованную нагрузку. Это допущения, а не данные реальной эксплуатации:

• 1,000 заданий агента в месяц.
• Каждое задание в сумме использует 10,000 некэшированных входных токенов и 2,000 выходных токенов GPT-6 Astra. Возвращенный поисковый контент входит в лимит входных токенов.
• Каждое задание делает один вызов веб-поиска.
• В сценарии с размещенным Agents API для каждого задания запускается одна новая тарифицируемая сессия контейнера объемом 1 GB по опубликованной цене $0.03. Повторное использование песочницы сократит эту строку расходов.
• В сценарии с SDK используется один общий воркер: предполагается, что он стоит $40 в месяц и обладает достаточной мощностью. Хранение, сеть и трудовые затраты не учитываются.

Расходы на модель составляют $0.10 за вход и $0.10 за выход, то есть $0.20 на задание. Для принятой смеси из 12,000 токенов это $0.0167 за 1,000 смешанных токенов модели. Один вызов веб-поиска добавляет $0.01, поэтому общие расходы на OpenAI достигают $0.21 на задание.

При 1,000 заданий Agents API с новым размещенным контейнером объемом 1 GB для каждого задания стоит $240: $210 общих расходов на модель и поиск плюс $30 за контейнеры. Сценарий с SDK стоит $250: те же $210 за OpenAI плюс предполагаемые $40 за воркер. При таком небольшом объеме размещенные контейнеры выигрывают по прямым расходам.

При 10,000 заданий расходы управляемого размещенного сценария достигают $2,400: $2,100 общих затрат плюс $300 за контейнеры. Сценарий с SDK при условии общего воркера стоит $2,140. Точка пересечения прямых затрат на вычисления — 1,334 новые сессии контейнера в месяц: это первое целое число сессий, при котором $0.03 за сессию превышает $40.

Самая важная строка — Agents API в собственной среде. Если он использует тот же предполагаемый воркер за $40, итог при 10,000 заданий также составит $2,140. Оркестратор Codex остается управляемым, но расходы на выполнение совпадают со сценарием SDK, поскольку OpenAI не берет дополнительную плату за оркестратор.

Но денежный счет по-прежнему не учитывает главную переменную — время инженеров. Выше точки пересечения экономия $260 в месяц на вычислениях не имеет значения, если SDK требует нескольких часов работы платформенной команды. Ниже этой точки зрелая система на SDK может почти ничего не стоить в обслуживании.

Чтобы жестко контролировать бюджет в любой из двух архитектур, сопоставьте оценку нагрузки с проектными ограничителями из материала Как контролировать бюджет API ИИ-агентов в 2026 году. Оценка помогает планировать, но не устанавливает лимиты.

Миграция на Agents API: сколько стоит переход с SDK

Переход с Agents SDK на Agents API — это миграция среды выполнения, а не переименование пакета. Определения агентов и схемы инструментов могут выглядеть знакомо, однако идентификаторы сессий, сессии SDK, диалоги Responses, сессии Agents API и песочницы являются разными ресурсами. Состояние нужно переносить как данные, а не как идентификатор, который якобы сохранит смысл после миграции.

1. 1

   Зафиксируйте контракт поведения

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

2. 2

   Сопоставьте настройки агентов и инструментов

   Перенесите модель, инструкции, MCP-подключения и определения функций в конфигурацию Agents API. Обработчикам функций приложения все равно нужен сервис, который принимает вызовы и возвращает результаты: перенос оркестрации сам по себе не делает их размещенными.

3. 3

   Проведите границу состояния

   Новые диалоги начинайте как сессии Agents API и сохраняйте их идентификаторы рядом с записями диалогов приложения. Во время перехода оставьте старые истории SDK доступными для чтения. Если прежний контекст необходимо продолжить, преобразуйте только нужное бизнес-состояние в явный ввод — не выдавайте сессию SDK за сессию Agents API.

4. 4

   Замените инфраструктуру жизненного цикла

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

5. 5

   Запустите теневое тестирование и регрессию

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

Примерный бюджет миграции делает компромисс нагляднее. Допустим, в существующем процессе есть три функции-инструмента, постоянные сессии и согласование человеком. Выделим 24 инженерных часа по $150 в час: 6 часов на конфигурацию и сопоставление инструментов, 8 — на сессии и жизненный цикл, 6 — на вебхуки, восстановление и идемпотентность, 4 — на регрессию и проверку затрат. Единовременная стоимость составит $3,600.

Если управляемые сжатие, восстановление, сессии и оркестрация экономят предполагаемые 6 инженерных часов в месяц, экономия на труде равна $900 ежемесячно, а окупаемость занимает четыре месяца. Если текущий путь на SDK требует лишь эпизодического внимания, окупаемости может не быть вовсе. Именно в допущениях суть расчета: миграцию оправдывает сокращение эксплуатационной работы, а не более дешевые токены.

Кому не стоит переходить на Agents API

Не переходите, если средства контроля данных в публичной бете не проходят требования закупки. В актуальном обзоре Agents API сказано, что хранение данных ограничено Соединенными Штатами, а Zero Data Retention не поддерживается. Собственная песочница не меняет эту политику, поскольку оркестратор и сессия по-прежнему находятся в управляемом сервисе.

Оставайтесь на Agents SDK, если верно хотя бы одно из условий:

• Среда выполнения должна работать под управлением собственного планировщика, внутри заданной границы транзакции или с контролируемыми приложением требованиями к задержке.
• Политики хранения, экспорта трасс или размещения данных несовместимы с управляемой публичной бетой.
• Агенту нужна свобода выбора поставщиков или абстракция моделей, которая не должна зависеть от оркестратора Codex.
• Ваша система на SDK уже надежно выполняет сжатие, восстановление, наблюдаемость и развертывание, не требуя заметных постоянных расходов.
• Большинство задач короткие и не сохраняют состояние, поэтому управляемая долговечная сессия почти не сокращает объем инфраструктуры.

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

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

Для агентов, которым необходимо выполнять код, отдельно сравните слой среды по материалу Лучшие песочницы для ИИ-агентов в 2026 году. Выбор песочницы не отвечает на вопрос, кто должен владеть состоянием оркестрации.

Результаты клиентов — ориентир, а не универсальный прогноз

Первые показатели говорят в пользу управляемого пути, однако это отчеты клиентов из публикации OpenAI о запуске 10 сентября, а не независимый контролируемый бенчмарк. SafetyKit сообщила о снижении стоимости одного кейса на 60%. Hypha — о сокращении числа неудачных ответов агентов на 86% после разделения управляемого оркестратора и своей песочницы. Ciridae зафиксировала рост оценки с 0.71 до 0.85 и 4x-сокращение задержки.

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

Вопросы об OpenAI Agents API и Agents SDK

Зачем использовать OpenAI Agents SDK?

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

Что лучше выбрать: OpenAI Agents SDK или PydanticAI?

Это отдельное сравнение фреймворков. Сначала решите, должен ли OpenAI управлять оркестратором Codex через Agents API или среда выполнения SDK останется внутри приложения. Затем сравнивайте SDK-фреймворки в рамках второго пути.

Какой SDK для ИИ-агентов лучше?

Универсально лучшего SDK для любой архитектуры не существует. OpenAI Agents SDK хорошо подходит, если его цикл на TypeScript или Python, инструменты, передача задач, защитные механизмы, сессии и интеграции OpenAI соответствуют вашему приложению, а развертыванием вы хотите управлять самостоятельно.

OpenAI Agents SDK бесплатный?

Agents SDK для Python распространяется по лицензии MIT, поэтому за сам пакет платить не нужно. Однако вызовы моделей, платные инструменты, сервисы песочниц и инфраструктура приложения по-прежнему оплачиваются.

Как пользоваться OpenAI Agents SDK?

Установите официальный пакет для TypeScript или Python, задайте агенту инструкции и инструменты, выберите одну стратегию состояния и запускайте его внутри приложения. Добавляйте согласования, сохранение состояния, трассировку и песочницы только там, где они нужны процессу.

Сколько стоит агент OpenAI?

Сложите расходы на входные, кэшированные входные и выходные токены, вызовы инструментов, песочницу или вычислительные ресурсы приложения, сторонние сервисы и эксплуатационный труд. Отдельной платы за оркестратор Agents API нет; при допущениях этой статьи прямая стоимость среды меняет победителя на отметке 1,334 новых сессий контейнера объемом 1 GB в месяц по сравнению с общим воркером за $40.

OpenAI API бесплатный или платный?

Использование моделей и платных инструментов OpenAI API тарифицируется по ценам API. План ChatGPT — отдельный продуктовый договор, который не покрывает расходы приложения на Agents API или Agents SDK.

Зачем платить $20 за ChatGPT?

Это вопрос выбора подписки ChatGPT, а не Agents API или SDK. Подписка ChatGPT дает доступ к продукту ChatGPT на условиях выбранного плана; использование OpenAI API оплачивается отдельно.

OpenAI Agent Builder бесплатный или платный?

Agent Builder входил в стандартную стоимость моделей API, но это не одна из двух сравниваемых здесь сред выполнения. OpenAI сообщает, что сворачивает Agent Builder, а окончательное отключение запланировано на 30 ноября 2026 года.

Что сделать в понедельник

На следующей неделе выберите один долгий рабочий процесс и проведите теневое сравнение. Зафиксируйте модель, инструкции, бюджет токенов, инструменты и набор оценок. Новые тестовые диалоги направьте в Agents API, существующие пользовательские истории оставьте на пути SDK, а для чистого сравнения управляемого оркестратора используйте с обеих сторон одну среду выполнения.

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

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