Prehľad

Rozhranie Agents API je dostupné v beta verzii. Umožňuje vývojárom vytvárať aplikácie s agentom Codex spravovaným spoločnosťou OpenAI, ktorý dokáže pracovať vo viacerých krokoch a pokračovať v tej istej relácii.

Vaša aplikácia poskytuje úlohu, nástroje a konfiguráciu. OpenAI spravuje reláciu agenta a koordináciu medzi jeho modelom a nástrojmi.

Čo dokáže agent?

V závislosti od svojich nástrojov a prostredia na vykonávanie úloh môže agent spúšťať kód, upravovať súbory, používať pripojenia MCP a vytvárať súbory pre vašu aplikáciu. V tej istej relácii môžete poslať ďalšie pokyny alebo pokračovať ďalšou úlohou.

Podporované funkcie a príklady nájdete v prehľade rozhrania Agents API.

Ako začať?

1. Vo svojom projekte na platforme OpenAI vytvorte kľúč API pre aplikáciu. Udeľte oprávnenia api.agents.read a api.agents.write pre relácie a tiež api.responses.write pre požiadavky na model.

2. Podľa stručného návodu nakonfigurujte agenta, vytvorte reláciu a zadajte úlohu.

3. Sledujte udalosti relácie, aby ste mali prehľad o priebehu a výsledkoch. Ak chcete v práci pokračovať, uložte si ID relácie.

Kľúč API uchovávajte mimo sandboxu agenta. Požiadavky vyžadujú hlavičku OpenAI-Beta: agents=v1. Súpravy SDK od OpenAI pridávajú túto hlavičku automaticky.

Potrebuje môj agent sandbox?

Vyberte prostredie vhodné pre danú úlohu:

• Bez prostredia: Agent odpovedá na otázky alebo používa externé nástroje bez potreby vstavaných príkazov shellu či súborov pracovného priestoru.

• Sandbox hostovaný spoločnosťou OpenAI: Agent potrebuje spúšťať skripty alebo pracovať so súbormi a chcete, aby jeho sandbox spravovala spoločnosť OpenAI.

• Sandbox hostovaný vo vlastnej infraštruktúre: Potrebujete vlastnú infraštruktúru, softvér alebo súkromnú sieť. Životný cyklus prostredia spravuje vaša aplikácia.

Podrobnosti o konfigurácii nájdete v architektúre rozhrania Agents API.

Kde si môžem prezrieť reláciu?

Otvorte Protokoly na paneli platformy, vyberte Agenti a vyhľadajte ID relácie. Môžete si prezrieť jednotlivé interakcie, volania nástrojov a aktivitu podagentov.

Príručka monitorovania tiež vysvetľuje, ako skontrolovať zaznamenanú spotrebu tokenov.

Čo ak sa preruší prúd udalostí?

Pred opätovným pokusom načítajte existujúcu reláciu a jej uložené položky. Takto si môžete overiť, čo sa stalo, skôr než zadáte ďalšiu prácu.

Dokončená interakcia neznamená, že každý nástroj vykonal svoju úlohu úspešne. Skontrolujte oznámený výsledok. Samotná nečinnosť relácie nepotvrdzuje, že sa úloha úspešne dokončila.

Ako sa účtuje využívanie?

Požiadavky na model sa účtujú podľa sadzieb API vybraného modelu. Na nástroje OpenAI a sandboxy hostované spoločnosťou OpenAI sa vzťahujú príslušné sadzby za nástroje a kontajnery.

Aktuálne sadzby nájdete v cenníku API.

Ako sa nakladá s údajmi a súbormi relácie?

Rozhranie Agents API uchováva stav relácie, aby práca mohla pokračovať naprieč jednotlivými interakciami. Relácie a publikované artefakty môžete odstrániť, keď ich už nepotrebujete. Pred odstránením relácie si uložte všetky súbory, ktoré potrebujete.

Rozhranie Agents API v súčasnosti podporuje rezidenciu údajov iba v Spojených štátoch. Nepodporuje nulové uchovávanie údajov, a to ani pri použití sandboxu hostovaného vo vlastnej infraštruktúre. Podrobnosti o správe údajov nájdete v dokumentácii rozhrania Agents API.