Oversikt

Agents API er tilgjengelig i beta. Med det kan utviklere bygge applikasjoner med en Codex-agent administrert av OpenAI, som kan arbeide gjennom flere trinn og fortsette i samme økt.

Applikasjonen din leverer oppgaven, verktøyene og konfigurasjonen. OpenAI administrerer agentens økt og koordinerer samspillet mellom modellen og verktøyene.

Hva kan en agent gjøre?

Avhengig av verktøyene og kjøremiljøet kan en agent kjøre kode, redigere filer, bruke MCP-tilkoblinger og opprette filer for applikasjonen din. Du kan sende flere instruksjoner eller fortsette med en annen oppgave i samme økt.

Se oversikten over Agents API for støttede funksjoner og eksempler.

Hvordan kommer jeg i gang?

1. Opprett en API-nøkkel for applikasjonen i prosjektet ditt på OpenAI-plattformen. Gi tillatelsene api.agents.read og api.agents.write for økter, samt api.responses.write for modellforespørsler.

2. Følg hurtigstartveiledningen for å konfigurere en agent, opprette en økt og sende inn en oppgave.

3. Følg med på hendelsene i økten for å se fremdrift og resultater. Lagre økt-ID-en hvis du vil fortsette arbeidet.

Oppbevar API-nøkkelen utenfor agentens sandkasse. Forespørsler krever headerfeltet OpenAI-Beta: agents=v1. OpenAIs SDK-er legger til dette headerfeltet automatisk.

Trenger agenten min en sandkasse?

Velg miljøet som passer til oppgaven:

• Uten miljø: Agenten svarer på spørsmål eller bruker eksterne verktøy uten å trenge innebygde skallkommandoer eller filer i arbeidsområdet.

• Sandkasse driftet av OpenAI: Agenten må kjøre skript eller arbeide med filer, og du ønsker at OpenAI skal administrere sandkassen.

• Egendriftet sandkasse: Du trenger egen infrastruktur, egen programvare eller et privat nettverk. Applikasjonen din administrerer miljøets livssyklus.

Se arkitekturen til Agents API for konfigurasjonsdetaljer.

Hvor kan jeg gjennomgå en økt?

Åpne Logger i plattformens kontrollpanel, velg Agenter, og søk etter økt-ID-en. Du kan undersøke turer, verktøykall og aktivitet fra underagenter.

Veiledningen om observerbarhet forklarer også hvordan du kan gjennomgå registrert tokenbruk.

Hva om hendelsesstrømmen kobles fra?

Hent den eksisterende økten og de lagrede elementene i den før du prøver igjen. Da kan du sjekke hva som skjedde før du sender inn flere oppgaver.

En fullført tur betyr ikke at alle verktøyene lyktes. Gjennomgå det rapporterte resultatet. At en økt er inaktiv, er ikke i seg selv en bekreftelse på at oppgaven ble fullført uten feil.

Hvordan faktureres bruken?

Modellforespørsler faktureres etter API-prisene for den valgte modellen. OpenAI-verktøy og sandkasser driftet av OpenAI faktureres etter de gjeldende verktøy- og containerprisene.

Se API-priser for gjeldende priser.

Hvordan håndteres øktdata og filer?

Agents API beholder øktens tilstand slik at arbeidet kan fortsette på tvers av turer. Du kan slette økter og publiserte artefakter når du ikke lenger trenger dem. Lagre filene du trenger før du sletter en økt.

Agents API støtter foreløpig bare dataresidens i USA. Det støtter ikke innstillingen for ingen oppbevaring av data, heller ikke når du bruker en sandkasse du drifter selv. Se dokumentasjonen for Agents API for detaljer om datakontroller.