Общ преглед

Agents API е наличен в бета версия. Той позволява на разработчиците да създават приложения с управляван от OpenAI Агент Codex, който може да работи в няколко стъпки и да продължава в същата сесия.

Вашето приложение предоставя задачата, инструментите и конфигурацията. 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.