Áttekintés

Az Agents API bétaverzióban érhető el. Lehetővé teszi, hogy a fejlesztők olyan alkalmazásokat készítsenek, amelyekben egy OpenAI által felügyelt Codex-ügynök több lépésben dolgozhat, és ugyanabban a munkamenetben folytathatja a munkát.

Az alkalmazásod adja meg a feladatot, az eszközöket és a konfigurációt. Az OpenAI kezeli az ügynök munkamenetét, és összehangolja a modell és az eszközök működését.

Mire képes egy ügynök?

Az eszközeitől és a futtatási környezetétől függően az ügynök kódot futtathat, fájlokat szerkeszthet, MCP-kapcsolatokat használhat, és fájlokat hozhat létre az alkalmazásod számára. Ugyanabban a munkamenetben további utasításokat küldhetsz, vagy egy másik feladattal folytathatod a munkát.

A támogatott képességeket és példákat az Agents API áttekintésében találod.

Hogyan kezdhetem el?

1. Hozz létre egy API-kulcsot az alkalmazásod számára az OpenAI Platform-projektedben. Add meg az api.agents.read és az api.agents.write jogosultságokat a munkamenetekhez, valamint az api.responses.write jogosultságot a modellnek küldött kérésekhez.

2. Kövesd a gyorsútmutatót egy ügynök beállításához, egy munkamenet létrehozásához és egy feladat beküldéséhez.

3. A munkamenet eseményeit követve ellenőrizheted az előrehaladást és az eredményeket. Mentsd el a munkamenet azonosítóját, ha folytatni szeretnéd a munkát.

Az API-kulcsodat az ügynök sandboxán kívül tárold. A kérésekhez kötelező az OpenAI-Beta: agents=v1 fejléc. Az OpenAI SDK-k automatikusan hozzáadják ezt a fejlécet.

Szüksége van az ügynökömnek sandboxra?

Válaszd a feladathoz illő környezetet:

• Környezet nélkül: Az ügynök kérdésekre válaszol vagy külső eszközöket használ, és nincs szüksége beépített shellparancsokra vagy a munkaterület fájljaira.

• OpenAI által üzemeltetett sandbox: Az ügynöknek szkripteket kell futtatnia vagy fájlokkal kell dolgoznia, és szeretnéd, ha az OpenAI kezelné a sandboxát.

• Saját üzemeltetésű sandbox: Saját infrastruktúrára, szoftverre vagy privát hálózatra van szükséged. A környezet életciklusát az alkalmazásod kezeli.

A konfiguráció részleteit az Agents API architektúrájának leírásában találod.

Hol tekinthetek át egy munkamenetet?

Nyisd meg a Platform irányítópultjának Naplók oldalát, válaszd az Ügynökök lehetőséget, és keress rá a munkamenet azonosítójára. Megvizsgálhatod a fordulókat, az eszközhívásokat és az alügynökök tevékenységét.

A megfigyelhetőségi útmutató azt is bemutatja, hogyan tekintheted át a rögzített tokenhasználatot.

Mi történik, ha megszakad az eseményfolyam?

Az újrapróbálkozás előtt kérd le a meglévő munkamenetet és annak mentett elemeit. Így ellenőrizheted, mi történt, mielőtt további feladatokat küldenél be.

Egy forduló befejezése nem jelenti azt, hogy minden eszköz sikeresen végrehajtotta a feladatát. Tekintsd át a visszajelzett eredményt. A munkamenet tétlen állapota önmagában nem igazolja, hogy a feladat sikeresen befejeződött.

Hogyan számlázzák a használatot?

A modellnek küldött kérésekre a kiválasztott modell API-díjai vonatkoznak. Az OpenAI eszközeire és az OpenAI által üzemeltetett sandboxokra a megfelelő eszköz- és konténerdíjak vonatkoznak.

Az aktuális díjakat az API díjszabásában találod.

Hogyan történik a munkamenet adatainak és fájljainak kezelése?

Az Agents API megőrzi a munkamenet állapotát, így a munka több fordulón át folytatható. Törölheted a munkameneteket és a közzétett kimeneti állományokat, ha már nincs rájuk szükség. Mentsd el a szükséges fájlokat, mielőtt törölnéd a munkamenetet.

Az Agents API esetében az adatok tárolási helye jelenleg csak az Egyesült Államok lehet. Nem támogatja a zéró adatmegőrzést, még saját üzemeltetésű sandbox használata esetén sem. Az adatkezelési beállítások részleteit az Agents API dokumentációjában találod.