Přehled

Agents API je dostupné v beta verzi. Umožňuje vývojářům vytvářet aplikace s agentem Codex spravovaným společností OpenAI, který dokáže pracovat ve více krocích a pokračovat v rámci stejné relace.

Vaše aplikace poskytuje úkol, nástroje a konfiguraci. OpenAI spravuje relaci agenta a koordinuje spolupráci mezi jeho modelem a nástroji.

Co agent umí?

Podle dostupných nástrojů a prostředí pro spouštění může agent spouštět kód, upravovat soubory, používat připojení MCP a vytvářet soubory pro vaši aplikaci. V rámci stejné relace můžete poslat další pokyny nebo pokračovat jiným úkolem.

Podporované funkce a příklady najdete v přehledu Agents API.

Jak začít?

1. Ve svém projektu na platformě OpenAI vytvořte klíč API pro aplikaci. Udělte oprávnění api.agents.read a api.agents.write pro relace a api.responses.write pro požadavky na model.

2. Podle stručného úvodního průvodce nakonfigurujte agenta, vytvořte relaci a zadejte úkol.

3. Sledujte události relace a kontrolujte průběh a výsledky. Pokud chcete v práci pokračovat, uložte si ID relace.

Klíč API uchovávejte mimo sandbox agenta. Požadavky vyžadují hlavičku OpenAI-Beta: agents=v1. Sady SDK OpenAI tuto hlavičku přidávají automaticky.

Potřebuje můj agent sandbox?

Vyberte prostředí, které odpovídá úkolu:

• Bez prostředí: Agent odpovídá na otázky nebo používá externí nástroje a nepotřebuje vestavěné příkazy shellu ani soubory pracovního prostoru.

• Sandbox hostovaný u OpenAI: Agent potřebuje spouštět skripty nebo pracovat se soubory a chcete, aby jeho sandbox spravovala společnost OpenAI.

• Sandbox na vlastní infrastruktuře: Potřebujete vlastní infrastrukturu, software nebo privátní síť. Životní cyklus prostředí spravuje vaše aplikace.

Podrobnosti o konfiguraci najdete v architektuře Agents API.

Kde si můžu prohlédnout relaci?

Otevřete Protokoly na řídicím panelu platformy, vyberte Agenti a vyhledejte ID relace. Můžete si prohlédnout jednotlivé tahy, volání nástrojů a aktivitu dílčích agentů.

Průvodce sledováním provozu také vysvětluje, jak si prohlédnout zaznamenanou spotřebu tokenů.

Co když se přeruší stream událostí?

Než pokus zopakujete, načtěte stávající relaci a její uložené položky. Díky tomu můžete před zadáním další práce zkontrolovat, co se stalo.

Dokončený tah neznamená, že všechny nástroje proběhly úspěšně. Zkontrolujte hlášený výsledek. Samotná nečinnost relace nepotvrzuje, že byl úkol úspěšně dokončen.

Jak se účtuje využití?

Požadavky na model se účtují podle sazeb API vybraného modelu. Nástroje OpenAI a sandboxy hostované u OpenAI se účtují podle příslušných sazeb za nástroje a kontejnery.

Aktuální sazby najdete v ceníku API.

Jak se nakládá s daty relace a soubory?

Agents API uchovává stav relace, aby práce mohla pokračovat napříč tahy. Relace a publikované artefakty můžete smazat, jakmile je už nepotřebujete. Před smazáním relace si uložte všechny potřebné soubory.

Agents API v současnosti podporuje datovou rezidenci pouze ve Spojených státech. Nepodporuje nulové uchovávání dat, a to ani při použití sandboxu hostovaného na vlastní infrastruktuře. Podrobnosti o správě dat najdete v dokumentaci Agents API.