Преглед

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.