Yfirlit

Agents API er í boði í betaútgáfu. Það gerir forriturum kleift að smíða forrit með Codex-fulltrúa sem OpenAI stýrir og getur unnið í mörgum skrefum og haldið áfram í sömu lotu.

Forritið þitt leggur til verkefnið, verkfærin og stillingarnar. OpenAI stýrir lotu fulltrúans og samhæfir líkanið og verkfærin sem hann notar.

Hvað getur fulltrúi gert?

Fulltrúi getur keyrt kóða, breytt skrám, notað MCP-tengingar og búið til skrár fyrir forritið þitt, eftir því hvaða verkfæri og keyrsluumhverfi hann hefur. Þú getur sent viðbótarleiðbeiningar eða haldið áfram með annað verkefni í sömu lotu.

Í yfirlitinu yfir Agents API má finna upplýsingar um studda eiginleika og dæmi.

Hvernig kemst ég af stað?

1. Búðu til API-lykil fyrir forrit í verkefninu þínu á OpenAI Platform. Veittu heimildirnar api.agents.read og api.agents.write fyrir lotur, auk api.responses.write fyrir beiðnir til líkans.

2. Fylgdu flýtileiðbeiningunum til að stilla fulltrúa, búa til lotu og senda inn verkefni.

3. Fylgstu með atburðum lotunnar til að sjá framvindu og niðurstöður. Vistaðu auðkenni lotunnar ef þú vilt halda vinnunni áfram.

Geymdu API-lykilinn þinn utan sandkassa fulltrúans. Beiðnir verða að innihalda hausinn OpenAI-Beta: agents=v1. SDK-söfn OpenAI bæta þessum haus sjálfkrafa við.

Þarf fulltrúinn minn sandkassa?

Veldu umhverfi sem hentar verkefninu:

• Ekkert umhverfi: Fulltrúinn svarar spurningum eða notar ytri verkfæri án þess að þurfa innbyggðar skeljaskipanir eða skrár á vinnusvæði.

• Sandkassi hýstur hjá OpenAI: Fulltrúinn þarf að keyra skriftur eða vinna með skrár og þú vilt að OpenAI sjái um sandkassann.

• Sandkassi í eigin hýsingu: Þú þarft eigin innviði, hugbúnað eða einkanet. Forritið þitt stýrir lífsferli umhverfisins.

Sjá nánar um stillingar í lýsingu á högun Agents API.

Hvar get ég skoðað lotu?

Opnaðu annála á stjórnborði Platform, veldu Fulltrúar og leitaðu að auðkenni lotunnar. Þú getur skoðað umferðir, verkfæraköll og aðgerðir undirfulltrúa.

Í leiðbeiningunum um vöktun er einnig útskýrt hvernig þú getur skoðað skráða tókanotkun.

Hvað ef tengingin við atburðastrauminn rofnar?

Sæktu núverandi lotu og vistuð atriði hennar áður en þú reynir aftur. Þannig geturðu kannað hvað gerðist áður en þú sendir inn fleiri verkefni.

Þótt umferð sé lokið þýðir það ekki að öll verkfærin hafi skilað árangri. Farðu yfir niðurstöðuna sem var skilað. Að lota sé aðgerðalaus staðfestir ekki eitt og sér að verkefnið hafi klárast.

Hvernig er rukkað fyrir notkun?

Beiðnir til líkans eru gjaldfærðar samkvæmt API-gjaldskrá þess líkans sem er valið. Fyrir verkfæri OpenAI og sandkassa sem OpenAI hýsir gilda viðeigandi gjaldskrár fyrir verkfæri og gáma.

Sjá gildandi verð í API-gjaldskránni.

Hvernig er farið með lotugögn og skrár?

Agents API varðveitir stöðu lotunnar svo hægt sé að halda vinnunni áfram milli umferða. Þú getur eytt lotum og birtum afurðum þegar ekki er lengur þörf á þeim. Vistaðu allar skrár sem þú þarft áður en þú eyðir lotu.

Agents API styður sem stendur aðeins gagnageymslu í Bandaríkjunum. Það styður ekki stillinguna „Engin gögn varðveitt“, jafnvel þótt þú notir sandkassa í eigin hýsingu. Sjá nánar um gagnastýringar í skjölun Agents API.