Pangkalahatang-ideya

Available ang Agents API sa beta. Nagbibigay-daan ito sa mga developer na bumuo ng mga application na may Codex agent na pinamamahalaan ng OpenAI, na kayang magsagawa ng maraming hakbang at magpatuloy sa parehong session.

Ang iyong application ang nagbibigay ng gawain, mga tool, at configuration. Pinamamahalaan ng OpenAI ang session ng agent at ang koordinasyon sa pagitan ng modelo at mga tool nito.

Ano ang kayang gawin ng isang agent?

Depende sa mga tool at kapaligiran sa pagpapatakbo nito, maaaring magpatakbo ng code, mag-edit ng mga file, gumamit ng mga koneksyon sa MCP, at gumawa ng mga file para sa iyong application ang isang agent. Maaari kang magpadala ng karagdagang tagubilin o magpatuloy sa ibang gawain sa parehong session.

Tingnan ang pangkalahatang-ideya ng Agents API para sa mga sinusuportahang kakayahan at halimbawa.

Paano ako magsisimula?

1. Gumawa ng API key para sa application sa iyong proyekto sa OpenAI Platform. Ibigay ang mga pahintulot na api.agents.read at api.agents.write para sa mga session, pati na ang api.responses.write para sa mga request sa modelo.

2. Sundin ang gabay sa mabilis na pagsisimula para mag-configure ng agent, gumawa ng session, at magsumite ng gawain.

3. Subaybayan ang mga event ng session para masuri ang pag-usad at mga resulta. I-save ang session ID kung gusto mong ipagpatuloy ang gawain.

Itago ang iyong API key sa labas ng sandbox ng agent. Kailangan ng mga request ang header na OpenAI-Beta: agents=v1. Awtomatikong idinaragdag ng mga SDK ng OpenAI ang header na ito.

Kailangan ba ng aking agent ng sandbox?

Piliin ang kapaligirang angkop sa gawain:

• Walang kapaligiran: Sumasagot ang agent sa mga tanong o gumagamit ng mga external na tool nang hindi nangangailangan ng mga built-in na shell command o file sa workspace.

• Sandbox na hino-host ng OpenAI: Kailangang magpatakbo ng mga script o gumamit ng mga file ang agent, at gusto mong OpenAI ang mamahala sa sandbox nito.

• Sandbox na ikaw mismo ang nagho-host: Kailangan mo ng sarili mong imprastraktura, software, o pribadong network. Ang iyong application ang namamahala sa kapaligiran mula sa paglikha hanggang sa pagwawakas nito.

Tingnan ang arkitektura ng Agents API para sa mga detalye ng configuration.

Saan ko masusuri ang isang session?

Buksan ang Mga log sa dashboard ng Platform, piliin ang Mga agent, at hanapin ang session ID. Maaari mong suriin ang mga turn, pagtawag sa tool, at aktibidad ng subagent.

Ipinapaliwanag din sa gabay sa pagsubaybay kung paano suriin ang naitalang paggamit ng token.

Paano kung maputol ang koneksyon ng event stream?

Kunin ang kasalukuyang session at ang mga naka-save na item nito bago subukang muli. Makakatulong ito sa iyong tingnan kung ano ang nangyari bago magsumite ng karagdagang gawain.

Ang natapos na turn ay hindi nangangahulugang matagumpay na gumana ang bawat tool. Suriin ang iniulat na resulta. Hindi sapat na batayan ang isang session na walang aktibidad para masabing matagumpay na natapos ang gawain.

Paano sinisingil ang paggamit?

Sinisingil ang mga request sa modelo ayon sa mga rate ng API ng napiling modelo. Sinisingil ang mga tool ng OpenAI at mga sandbox na hino-host ng OpenAI ayon sa naaangkop na mga rate para sa tool at container.

Tingnan ang pagpepresyo ng API para sa mga kasalukuyang rate.

Paano pinangangasiwaan ang data at mga file ng session?

Pinapanatili ng Agents API ang estado ng session para maipagpatuloy ang gawain sa mga susunod na turn. Maaari mong i-delete ang mga session at na-publish na artifact kapag hindi na kailangan ang mga ito. I-save ang anumang file na kailangan mo bago mag-delete ng session.

Sa kasalukuyan, Estados Unidos lang ang sinusuportahang lokasyon ng data ng Agents API. Hindi nito sinusuportahan ang zero na pagpapanatili ng data, kahit na gumagamit ka ng sandbox na ikaw mismo ang nagho-host. Tingnan ang dokumentasyon ng Agents API para sa mga detalye tungkol sa kontrol sa data.