Для долгих задач с управляемым OpenAI исполнением существует Agents API. Если же приложению нужен короткий запрос к модели и вы хотите сами управлять дальнейшими шагами, начните с Responses API. Если нужен цикл работы с инструментами, передачей задач между агентами и проверками, рассмотрите Agents SDK.
Запрос «openai agents api» часто смешивает эти уровни. Agents SDK — библиотека для организации работы агента, а не новое название Responses API. Для моделей OpenAI она по умолчанию использует Responses API, добавляя управление процессом поверх вызовов.
Когда нужен Agents API, а не SDK
В Agents API OpenAI управляет исполнением агента на основе Codex harness и сохраняет ход работы. Этот вариант предназначен в том числе для длительных задач. Среда выполнения может быть размещена у OpenAI, подключена самостоятельно либо отсутствовать, если песочница задаче не нужна.У SDK другое место в архитектуре: библиотека работает внутри вашего приложения. Она удобна, когда развёртывание, хранение данных и интеграции должны оставаться под вашим контролем. Это не два названия одного продукта.
Сеанс Agents API, сеанс SDK, разговор Responses и песочница — разные ресурсы. Правила сохранения и завершения работы нужно брать из документации выбранного варианта, а не переносить по совпадению слова «session».
Что остаётся на вашей стороне
Responses API предоставляет интерфейс к модели. Agents SDK добавляет управляющую логику: какой агент действует, какой инструмент вызвать и когда завершить работу. Ваше приложение всё равно должно где-то выполняться, иметь доступ к нужным данным и обрабатывать ошибки.Установка библиотеки сама по себе не создаёт постоянно работающий сервер. Не следует также считать её готовой системой доступа к CRM, платежам или файлам: возможности определяются подключёнными инструментами и их разрешениями.
Когда прямой вызов проще
Представим учебную задачу: получить краткое резюме уже подготовленного текста. Если после ответа работа заканчивается, дополнительный агентный слой может не принести заметной пользы.Другой случай: приложение уже само решает, какой источник запросить, как проверить ответ и куда его сохранить. Если этот процесс понятен и управляем, переход на SDK только ради слова «агент» добавит новую зависимость без ясной цели.
Прямой API не запрещает сложные сценарии. Он означает, что цикл вызовов, запуск ваших инструментов и обработку состояния вы организуете самостоятельно.
Что берёт на себя Runner
В Agents SDK Runner управляет последовательностью шагов. После ответа модели он может завершить работу, выполнить запрошенные инструменты и продолжить цикл либо передать управление другому агенту.Для ограничения числа обращений к модели предусмотрен max_turns. При превышении лимита возникает MaxTurnsExceeded. Лимит шагов не равен лимиту денег. Разные шаги могут потреблять разный объём токенов и обращаться к разным инструментам.
Практический смысл SDK появляется, когда разработчику действительно нужны такие механизмы, а не один ответ в текстовом поле. Например, учебный процесс «найти документ, извлечь данные, проверить формат и подготовить результат» удобнее оценивать как управляемую цепочку.
Почему несколько агентов не гарантируют лучший результат
Разделение на роли имеет смысл, если у них разные инструкции, инструменты или критерии результата. Три одинаковых агента с одинаковым доступом не становятся независимой проверкой только из-за разных имён.Начните с одного агента и одного безопасного инструмента на чтение. Добавляйте передачу задач, когда можете назвать конкретную проблему, которую она решает. Иначе будет трудно понять, улучшился ли ответ или только выросло число вызовов.
Что проверить до подключения реальных действий
- Что считается завершённым результатом, а не промежуточным рассуждением.
- Что происходит, если инструмент не ответил или вернул неполные данные.
- Как предотвращается повторное выполнение действия после сбоя.
- Какие операции требуют отдельного подтверждения человека.
- Как ограничиваются шаги и учитывается потребление.
- Какие данные разрешено включать в диагностические журналы.
Не обязательно выбирать один вариант навсегда
В одном приложении можно оставить простые вызовы напрямую через Responses API, а многошаговый процесс построить на Agents SDK. Выбирать следует для конкретной задачи, а не для всего проекта по одному модному названию.Сравнение всех трёх вариантов есть в обзоре Agents. Связь SDK и Responses описана в официальном руководстве Agents SDK, порядок работы цикла — в документации Runner. Примеры задач выше учебные; платные вызовы и измерения качества для статьи не проводились.