Шолу

Agents API бета нұсқасында қолжетімді. Ол әзірлеушілерге OpenAI басқаратын Codex агенті бар қолданбалар жасауға мүмкіндік береді. Бұл агент бірнеше қадамнан тұратын жұмысты орындап, оны сол сеанста жалғастыра алады.

Қолданбаңыз тапсырманы, құралдарды және баптауларды ұсынады. OpenAI агенттің сеансын басқарады және оның моделі мен құралдарының жұмысын үйлестіреді.

Агент не істей алады?

Құралдары мен орындау ортасына қарай агент кодты іске қоса алады, файлдарды өңдей алады, MCP қосылымдарын пайдалана алады және қолданбаңызға файлдар жасай алады. Бір сеанс ішінде қосымша нұсқаулар жіберуге немесе басқа тапсырманы жалғастыруға болады.

Қолдау көрсетілетін мүмкіндіктер мен мысалдарды Agents API шолуынан қараңыз.

Қалай бастауға болады?

1. OpenAI платформасындағы жобаңызда қолданбаға арналған API кілтін жасаңыз. Сеанстар үшін api.agents.read және api.agents.write, ал модельге сұрау жіберу үшін api.responses.write рұқсаттарын беріңіз.

2. Агентті баптау, сеанс жасау және тапсырма жіберу үшін жылдам бастау нұсқаулығын орындаңыз.

3. Орындалу барысы мен нәтижелерді көру үшін сеанс оқиғаларын бақылаңыз. Жұмысты жалғастырғыңыз келсе, сеанс идентификаторын сақтап алыңыз.

API кілтін агенттің оқшауланған ортасынан тыс жерде сақтаңыз. Сұрауларда OpenAI-Beta: agents=v1 тақырып өрісі болуы керек. OpenAI SDK жинақтары бұл тақырып өрісін автоматты түрде қосады.

Агентіме оқшауланған орта қажет пе?

Тапсырмаға сай ортаны таңдаңыз:

• Ортасыз: Агент кіріктірілген командалық қабық пәрмендерін немесе жұмыс кеңістігінің файлдарын қажет етпей, сұрақтарға жауап береді немесе сыртқы құралдарды пайдаланады.

• OpenAI инфрақұрылымындағы оқшауланған орта: Агентке скрипттерді іске қосу немесе файлдармен жұмыс істеу қажет, ал сіз оның оқшауланған ортасын OpenAI басқарғанын қалайсыз.

• Өз инфрақұрылымыңыздағы оқшауланған орта: Сізге өз инфрақұрылымыңыз, бағдарламалық жасақтамаңыз немесе жеке желіңіз қажет. Ортаның өмірлік циклін қолданбаңыз басқарады.

Баптау туралы толығырақ Agents API архитектурасы бетінен қараңыз.

Сеансты қайдан қарап шығуға болады?

Платформаның басқару панеліндегі журналдарды ашып, Агенттер бөлімін таңдаңыз да, сеанс идентификаторы бойынша іздеңіз. Өзара әрекеттесу кезеңдерін, құрал шақыруларын және қосалқы агенттердің әрекеттерін тексере аласыз.

Бақылау нұсқаулығында токендердің тіркелген пайдалану есебін қалай қарау керектігі де түсіндіріледі.

Оқиғалар ағынымен байланыс үзілсе не істеу керек?

Қайталап көрмес бұрын бар сеансты және оның сақталған элементтерін алыңыз. Бұл қосымша тапсырма жібермес бұрын не болғанын тексеруге көмектеседі.

Өзара әрекеттесу кезеңінің аяқталуы барлық құралдың сәтті орындалғанын білдірмейді. Хабарланған нәтижені қарап шығыңыз. Сеанстың әрекетсіз күйде болуының өзі тапсырманың сәтті аяқталғанын растамайды.

Пайдалану ақысы қалай есептеледі?

Модельге жіберілген сұрауларға таңдалған модельдің API тарифтері қолданылады. OpenAI құралдары мен OpenAI инфрақұрылымында орналасқан оқшауланған орталарға тиісті құрал және контейнер тарифтері қолданылады.

Қолданыстағы тарифтерді API бағалары бетінен қараңыз.

Сеанс деректері мен файлдары қалай өңделеді?

Жұмыс келесі өзара әрекеттесу кезеңдерінде жалғасуы үшін Agents API сеанс күйін сақтайды. Сеанстар мен жарияланған артефактілер қажет болмай қалғанда, оларды жоюға болады. Сеансты жоймас бұрын қажетті файлдарды сақтап алыңыз.

Қазір Agents API деректердің орналасу аймағы ретінде тек АҚШ-ты қолдайды. Ол деректерді мүлде сақтамау режимін қолдамайды, соның ішінде өз инфрақұрылымыңызда орналасқан оқшауланған ортаны пайдаланған кезде де. Деректерді басқару туралы толығырақ Agents API құжаттамасынан қараңыз.