OpenAI запускає Agents API у публічній бета-версії, надаючи доступ до Codex harness через один виклик API
OpenAI випустила Agents API у форматі публічної бета-версії. Вона надає розробникам той самий рушій і ту саму інфраструктуру, на яких працює Codex. OpenAI розміщує та обслуговує рушій. Розробники запускають обчислення агента в пісочниці під керуванням OpenAI, у власній інфраструктурі або в пісочниці партнера.
Чи придатна вона для розгортання? Так. Вона доступна всім розробникам у форматі публічної бета-версії. Дані зберігаються лише у США, а Zero Data Retention не підтримується.
Що випустила OpenAI
Agents API — це керований сервіс, створений на основі рушія Codex з відкритим кодом. Команда OpenAI заявляє, що масштабування Codex і ChatGPT для Work продемонструвало, що потрібно агентам, які працюють тривалий час. Їм потрібен рушій, який керує контекстом, ефективно використовує інструменти та координує субагентів. Їм також потрібна інфраструктура, яка надійно підтримує їхню роботу протягом кількох днів.
Офіційна документація структурує API навколо 4 концепцій:
- Агент: модель, інструкції, інструменти та MCP-сервери, доступні для нього.
- Середовище: необов’язкова пісочниця, у якій агент отримує доступ до файлів, завантажує навички та виконує команди.
- Сеанс: тривалий екземпляр агента, який працює над завданнями та відповідає на введені дані.
- Події та елементи: дані, що надсилаються агенту, і результат, який він створює.
Сеанс працює у 4 етапи. Ви створюєте його та надаєте йому завдання. Потім відстежуєте перебіг через потокову передачу даних або вебхуки. Нарешті, продовжуєте роботу з новим завданням або спрямовуєте поточний раунд.
Один виклик API
В анонсі OpenAI показано агента для розслідування інцидентів, створеного одним викликом:
import OpenAI from "openai";
const client = new OpenAI();
const session = await client.beta.agents.sessions.create({
agent: {
model: "gpt-6-astra",
tools: [
{
type: "mcp",
server_label: "observability",
transport: {
type: "http",
server_url: "https://observability.example.com/mcp",
},
},
],
multi_agent: { enabled: true, max_concurrent_subagents: 3 },
},
vault_ids: ["vault_YOUR_VAULT_ID"],
environment: {
type: "openai_hosted",
capability_directories: ["/workspace/capabilities/skills"],
},
input:
"Investigate service-api's elevated 5xx rate over the last 30 minutes. " +
"Delegate deployment, error, and dependency analysis to subagents. " +
"Save findings, evidence, and recommended mitigation in /workspace/outputs.",
});Короткий посібник охоплює дозволи для ключа API та налаштування SDK.
Де працює агент
Вибір середовища — головне архітектурне рішення. Agents API підтримує 3 варіанти пісочниць, а також може працювати без пісочниці.
- Пісочниця OpenAI: використовує інфраструктуру пісочниць, що лежить в основі Codex і ChatGPT. Її можна налаштувати за допомогою файлів, пакетів, навичок і плагінів.
- Власний хостинг: ви запускаєте
codex exec-serverу своєму середовищі. Він реєструється за допомогою ключа з обмеженими правами та підключається через WebSocket. Усі підключення є вихідними. - Пісочниці партнерів: Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop і Vercel мають інтеграції першого класу.
За що відповідає рушій
OpenAI підтримує рушій разом зі своїми моделями, надаючи версійний доступ під час кожного запуску моделі.
- Тривалі сеанси: API автоматично стискає попередній контекст, коли сеанс наближається до свого ліміту. Розробникам не потрібно самостійно писати логіку стиснення.
- Ефективне використання інструментів: пошук інструментів завантажує визначення інструментів лише за потреби. Це зменшує використання токенів і витрати, зберігаючи кеш моделі. Програмний виклик інструментів дає агентам змогу виконувати виклики паралельно та об’єднувати операції в ланцюжки. Агенти фільтрують або комбінують результати в коді, тому в контекст повертаються лише релевантні дані. Серед підтримуваних інструментів — MCP, користувацькі функції та вбудовані інструменти, як-от вебпошук.
- Субагенти: завдяки підтримці кількох агентів головний агент розподіляє складні завдання на незалежні частини. Кожен субагент зберігає власний контекст. Головний агент координує їх і об’єднує результати.
Agents API проти Agents SDK і Responses API
Порівняння середовищ виконання від OpenAI представляє 3 варіанти так:
| Agents API | Agents SDK | Responses API | |
|---|---|---|---|
| Де працює агент | OpenAI запускає керований рушій Codex | У вашому застосунку | Ваш застосунок із необов’язковою оркестрацією на стороні сервісу |
| Зусилля для інтеграції | Низькі | Середні | Високі |
| Стан між завданнями | Збережена конфігурація сеансу, раунди та елементи | Ваше сховище та сеанси SDK | Історія вручну, ланцюжки відповідей або Conversations |
| Середовище виконання | Під керуванням OpenAI, власний хостинг або без пісочниці | Ваше середовище виконання та постачальники пісочниць | Ваше власне середовище |
Перші результати клієнтів
OpenAI опублікувала ці показники, надані клієнтами. Це дані від постачальника, а не незалежні бенчмарки.
- Ciridae: оцінка під час тестування зросла з 0,71 до 0,85, а затримка в робочих процесах субагентів скоротилася в 4 рази.
- SafetyKit: після перенесення робочого процесу перевірки справ вартість на одну справу знизилася на 60%.
- Hypha: після відокремлення рушія від пісочниці кількість невдалих відповідей агентів скоротилася на 86%.
- Nash.ai: запускає тисячі агентів, які працюють тривалий час, у глобальних логістичних мережах.
Головні висновки
- Agents API від OpenAI надає доступ до керованого рушія Codex через API у форматі публічної бета-версії.
- Агенти працюють у пісочницях OpenAI, у власних пісочницях або в 9 пісочницях партнерів.
- Стиснення, пошук інструментів, програмний виклик інструментів і субагенти вбудовані за замовчуванням.
- Додаткової плати немає; ви платите за токени, інструменти та час роботи контейнера.
- Розміщення даних лише у США та відсутність ZDR наразі обмежують використання у регульованих робочих процесах.
Ознайомтеся з технічними деталями. Також підписуйтеся на нас у Twitter і не забудьте приєднатися до нашого сабреддіту про машинне навчання зі 150 тисячами+ учасників та підписатися на нашу розсилку. Стривайте! Ви є в Telegram? тепер ви також можете приєднатися до нас у Telegram.
Потрібно стати нашим партнером для просування вашого репозиторію GitHub, сторінки Hugging Face, випуску продукту, вебінару тощо? Зв’яжіться з нами
Перекладено автоматично з англійської. Оригінал статті — за посиланням нижче.