Преминаване към основното съдържание
OpenAI

Представяме API за агенти

Създавайте и изпълнявайте облачни агенти с рамката на Codex, изцяло управлявана от OpenAI.

Зареждане…

Докато разширявахме Codex и ChatGPT for Work до милиони хора по света, научихме какво е необходимо, за да работят добре на практика дълго работещите агенти. Полезните агенти се нуждаят от мощна рамка, която управлява контекста, използва ефективно инструментите и координира подагентите. Нужна им е и инфраструктура, която ги поддържа надеждно работещи с дни, със среди, в които могат да обработват файлове, да изпълняват код и да запазват междинни резултати.

Днес представяме публичната бета-версия на API за агенти⁠(отваря се в нов прозорец), която предоставя на разработчиците чрез прост и гъвкав API същата рамка и инфраструктура, задвижващи Codex.

Какво казват клиентите ни за API за агенти

1 от 8
„С API за агенти оценката ни се повиши от 0,71 на 0,85. Поддръжката на подагенти в API е отлична и ускори драстично работния ни процес. Преди наблюдението и оркестрацията на подагенти в старата ни конфигурация бяха доста тромави, но новите API намалиха закъснението четири пъти. Дълго се опитвахме да оптимизираме това, а работните процеси с подагенти донесоха огромно подобрение още с готовата конфигурация.“
Jack Weissenberger, технически директор, Ciridae

Създавайте облачни агенти с едно извикване на API

С API за агенти можете да създадете готов за продукционна среда агент с едно извикване на API, като посочите задачата, модела, инструментите и средата:

JavaScript

1
import OpenAI from "openai";
2

3
const client = new OpenAI();
4

5
const session = await client.beta.agents.sessions.create({
6
agent: {
7
model: "gpt-6-astra",
8
tools: [
9
{
10
type: "mcp",
11
server_label: "observability",
12
transport: {
13
type: "http",
14
server_url: "https://observability.example.com/mcp",
15
},
16
},
17
],
18
multi_agent: { enabled: true, max_concurrent_subagents: 3 },
19
},
20
vault_ids: ["vault_YOUR_VAULT_ID"],
21
environment: {
22
type: "openai_hosted",
23
capability_directories: ["/workspace/capabilities/skills"],
24
},
25
input:
26
"Investigate service-api’s elevated 5xx rate over the last 30 minutes. " +
27
"Delegate deployment, error, and dependency analysis to subagents. " +
28
"Save findings, evidence, and recommended mitigation in /workspace/outputs.",
29
});

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

Приложение изпраща задачи към API за агенти и получава събития и резултати. API за агенти изпълнява управляваната рамка на Codex, изпраща извиквания на инструменти към изолирана среда и получава резултатите от тях. Приложението управлява собствено хостваните изчислителни ресурси.

API за агенти предоставя на агентите ви същата рамка и инфраструктура, които стоят зад Codex.

Изберете средата на агента си

Различните натоварвания изискват различни възможности за изчисления, съхранение и внедряване. API за агенти ви позволява да изберете изолирана среда, подходяща за приложението ви.

Партнираме си с доставчици от екосистемата⁠(отваря се в нов прозорец), сред които Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop и Vercel, за да предложим първокласни интеграции за различни нужди:

  • Изцяло управлявани среди или внедрявания във вашия VPC

  • Конкретни механизми за съхранение на файлове и поверителни данни

  • Различни конфигурации на CPU, GPU и паметта с профили за производителност, студено стартиране и разходи, съобразени с работния процес на компанията ви.

Партньори за изолирани среди: Modal, Cloudflare, Daytona, Blaxel, Runloop, Vercel, Oracle, E2B и DigitalOcean.

API за агенти предлага първокласни интеграции с популярни доставчици от екосистемата.

Изолирани среди, хоствани от OpenAI

За разработчиците, които искат да започнат бързо и да мащабират ефективно, представяме и изолирана среда, хоствана от OpenAI⁠(отваря се в нов прозорец). Тя използва същата инфраструктура за изолирани среди, която задвижва Codex и ChatGPT.

OpenAI предоставя и управлява изолираната среда, като осигурява на агента ви защитена и производителна среда за изпълнение на код, работа с файлове и създаване на артефакти. Тези изолирани среди могат да се конфигурират гъвкаво с вашите файлове, пакети, умения и приставки, за да разполага агентът с необходимото за изпълнение на задачата.

Създавайте с непрекъснато развиваща се рамка на Codex

Използването на новите възможности на моделите често изисква преработване на рамката, което отнема ценно време от подобряването на приложението ви. С всяко пускане на нов модел API за агенти предоставя версиониран достъп до тези възможности. Поддържаме и непрекъснато подобряваме рамката заедно с моделите си, за да помагаме на агентите ви да постигат по-добра производителност при всяка надстройка. Сред последните подобрения на рамката например са:

Поддържайте работата на агентите в продължителни сесии

За да поддържаме модели, които работят с часове, създадохме управление на контекста, което помага на агентите да пренасят важната информация между по-дълги сесии. Когато дадена сесия наближи лимита на контекста си, API за агенти автоматично сбива⁠(отваря се в нов прозорец) по-ранния контекст, като запазва информацията, необходима на агента да продължи. Разработчиците могат да създават работни процеси, обхващащи множество контекстни прозорци, без да прилагат собствена логика за сбиване.

Помогнете на агентите да използват ефективно повече инструменти

API за агенти помага на агентите да намират правилните инструменти и да ги използват ефективно. Търсенето на инструменти⁠(отваря се в нов прозорец) зарежда при необходимост определенията на подходящите инструменти, като помага да се намалят използването на токени и разходите и същевременно запазва кеша на модела. Щом инструментите са налични, програмното извикване на инструменти⁠(отваря се в нов прозорец) позволява на агентите да изпълняват извиквания паралелно, да свързват последователни операции и да филтрират или обединяват резултати в код. Така могат да обработват големи обеми данни, като връщат в контекста само подходящите резултати. API за агенти поддържа MCP, персонализирани функции и вградени инструменти, като търсене в мрежата.

JSON

1
"agent": {
2
"tools": [
3
{
4
"type": "mcp",
5
"server_label": "openai_docs",
6
"transport": {
7
"type": "http",
8
"server_url": "https://developers.openai.com/mcp"
9
}
10
},
11
]
12
}

Позволете на агентите да разпределят работата паралелно между подагенти

С поддръжката на множество агенти⁠(отваря се в нов прозорец) API за агенти може да разделя сложните задачи на независими части и да ги възлага на подагенти, които работят паралелно. Всеки подагент поддържа собствен контекст, който му помага да остане съсредоточен върху задачата си, а основният агент координира работата им и обединява резултатите. Това може да ускори проучванията, анализите и задачите по програмиране, които се възползват от паралелната работа, без да се налага да създавате собствена оркестрация.

JSON

1
"agent": {
2
"model": "gpt-6-astra",
3
"multi_agent": {
4
"enabled": true,
5
"max_concurrent_subagents": 3,
6
}
7
}

Основа с отворен код

API за агенти се задвижва от рамката с отворен код на Codex, която дава на разработчиците видимост към основната логика за координиране на извикванията на модели, инструментите и контекста. При API за агенти OpenAI управлява и поддържа тази рамка, а разработчиците могат да преглеждат и изучават нейната публична кодова база⁠(отваря се в нов прозорец).

Започнете да изграждате

От днес Agents API е достъпен в публична бета версия за всички разработчици. Няма допълнителни такси за използване на Agents API — плащате само за токените и инструментите, които агентите ви използват, както е описано на нашата страница с цени⁠(отваря се в нов прозорец).

Разгледайте общия преглед на API за агенти⁠(отваря се в нов прозорец), за да научите повече, или следвайте ръководството за бърз старт⁠(отваря се в нов прозорец), за да започнете и да използвате рамката, на която е изграден Codex, в собствените си агенти.

По време на публичната бета версия ще правим бързи подобрения въз основа на отзивите ви, докато се подготвяме за общодостъпната версия. Споделете какво работи добре, къде срещате затруднения и от какво се нуждаете, за да създавате и използвате агентите си в реална работна среда.