Огляд

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 підтримує вимоги до локалізації даних лише для США. Нульове збереження даних не підтримується, зокрема й у разі використання ізольованого середовища на власній інфраструктурі. Докладніше про керування даними читайте в документації Agents API.