Обзор

Agents API доступен в бета-версии. Он позволяет разработчикам создавать приложения с агентом Codex под управлением OpenAI, который может выполнять многошаговые задачи и продолжать работу в той же сессии.

Ваше приложение задаёт задачу, инструменты и настройки. OpenAI управляет сессией агента и координирует взаимодействие его модели с инструментами.

Что умеет агент?

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

Поддерживаемые возможности и примеры приведены в обзоре Agents API.

Как начать работу?

1. Создайте API-ключ для приложения в своём проекте на платформе OpenAI. Предоставьте разрешения api.agents.read и api.agents.write для работы с сессиями, а также api.responses.write для запросов к модели.

2. Следуйте руководству по быстрому старту, чтобы настроить агента, создать сессию и отправить задачу.

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

Храните API-ключ за пределами песочницы агента. В запросах необходимо указывать заголовок OpenAI-Beta: agents=v1. SDK OpenAI добавляют этот заголовок автоматически.

Нужна ли моему агенту песочница?

Выберите среду, подходящую для вашей задачи:

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

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

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

Подробнее о настройке см. в разделе «Архитектура Agents API».

Где можно просмотреть сессию?

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

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

Что делать, если соединение с потоком событий прервалось?

Перед повторной попыткой получите существующую сессию и её сохранённые элементы. Так вы сможете проверить, что произошло, прежде чем отправлять новые задачи.

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

Как рассчитывается плата за использование?

Запросы к модели оплачиваются по тарифам API выбранной модели. Инструменты OpenAI и песочницы на инфраструктуре OpenAI оплачиваются по соответствующим тарифам на инструменты и контейнеры.

Актуальные тарифы приведены на странице цен на API.

Как обрабатываются данные сессий и файлы?

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

В настоящее время Agents API поддерживает резидентность данных только в США. Нулевое хранение данных (ZDR) не поддерживается, в том числе при использовании песочницы на собственной инфраструктуре. Подробнее об управлении данными см. в документации Agents API.