Yleiskatsaus

Agents API -rajapinta on saatavilla beetaversiona. Sen avulla kehittäjät voivat rakentaa sovelluksia, joissa OpenAI:n hallinnoima Codex-agentti voi suorittaa monivaiheisia tehtäviä ja jatkaa työskentelyä samassa istunnossa.

Sovelluksesi määrittää tehtävän, työkalut ja asetukset. OpenAI hallinnoi agentin istuntoa sekä mallin ja työkalujen välistä koordinointia.

Mitä agentti voi tehdä?

Työkaluistaan ja suoritusympäristöstään riippuen agentti voi suorittaa koodia, muokata tiedostoja, käyttää MCP-yhteyksiä ja tuottaa tiedostoja sovelluksellesi. Voit lähettää lisäohjeita tai jatkaa toiseen tehtävään samassa istunnossa.

Katso tuetut ominaisuudet ja esimerkit Agents API -rajapinnan yleiskatsauksesta.

Miten pääsen alkuun?

1. Luo sovelluksen API-avain OpenAI Platform -projektissasi. Myönnä istuntoja varten oikeudet api.agents.read ja api.agents.write sekä mallipyyntöjä varten oikeus api.responses.write.

2. Määritä agentti, luo istunto ja lähetä tehtävä pika-aloitusoppaan ohjeiden mukaan.

3. Tarkastele edistymistä ja tuloksia seuraamalla istunnon tapahtumia. Tallenna istunnon tunnus, jos haluat jatkaa työtä.

Pidä API-avaimesi agentin hiekkalaatikon ulkopuolella. Pyynnöt edellyttävät otsaketta OpenAI-Beta: agents=v1. OpenAI:n SDK:t lisäävät tämän otsakkeen automaattisesti.

Tarvitseeko agenttini hiekkalaatikon?

Valitse tehtävään sopiva ympäristö:

• Ei ympäristöä: Agentti vastaa kysymyksiin tai käyttää ulkoisia työkaluja tarvitsematta sisäänrakennettuja komentotulkin komentoja tai työtilan tiedostoja.

• OpenAI:n ylläpitämä hiekkalaatikko: Agentin on suoritettava skriptejä tai käsiteltävä tiedostoja, ja haluat OpenAI:n hallinnoivan sen hiekkalaatikkoa.

• Itse ylläpidetty hiekkalaatikko: Tarvitset omaa infrastruktuuria, ohjelmistoja tai yksityistä verkkoa. Sovelluksesi hallinnoi ympäristön elinkaarta.

Katso määritysohjeet Agents API -rajapinnan arkkitehtuurikuvauksesta.

Missä voin tarkastella istuntoa?

Avaa Platform-hallintapaneelin lokit, valitse Agentit ja hae istunnon tunnuksella. Voit tarkastella vuoroja, työkalukutsuja ja aliagenttien toimintaa.

Havainnoitavuusoppaassa kerrotaan myös, miten voit tarkastella kirjattua tokenien käyttöä.

Entä jos tapahtumavirran yhteys katkeaa?

Hae olemassa oleva istunto ja sen tallennetut kohteet ennen kuin yrität uudelleen. Näin voit tarkistaa, mitä tapahtui, ennen kuin lähetät lisää tehtäviä.

Vuoron päättyminen ei tarkoita, että kaikkien työkalujen suoritus onnistui. Tarkista raportoitu tulos. Pelkkä istunnon odotustila ei osoita, että tehtävä valmistui onnistuneesti.

Miten käytöstä laskutetaan?

Mallipyynnöt laskutetaan valitun mallin API-hinnaston mukaan. OpenAI:n työkaluihin ja OpenAI:n ylläpitämiin hiekkalaatikoihin sovelletaan niiden omia työkalu- ja konttihintoja.

Katso ajantasaiset hinnat API-hinnastosta.

Miten istunnon tietoja ja tiedostoja käsitellään?

Agents API -rajapinta säilyttää istunnon tilan, jotta työ voi jatkua vuorosta toiseen. Voit poistaa istunnot ja julkaistut tuotokset, kun niitä ei enää tarvita. Tallenna tarvitsemasi tiedostot ennen istunnon poistamista.

Agents API -rajapinta tukee tällä hetkellä tietojen sijaintipaikkana vain Yhdysvaltoja. Se ei tue tietojen määräaikaista säilyttämistä edes silloin, kun käytät itse ylläpitämääsi hiekkalaatikkoa. Katso lisätietoja tietojen hallinnasta Agents API -rajapinnan dokumentaatiosta.