Oversigt

Agents API er tilgængeligt i beta. Det giver udviklere mulighed for at bygge applikationer med en Codex-agent, som administreres af OpenAI og kan arbejde i flere trin og fortsætte i samme session.

Din applikation leverer opgaven, værktøjerne og konfigurationen. OpenAI administrerer agentens session og koordineringen mellem dens model og værktøjer.

Hvad kan en agent gøre?

Afhængigt af sine værktøjer og sit kørselsmiljø kan en agent køre kode, redigere filer, bruge MCP-forbindelser og oprette filer til din applikation. Du kan sende yderligere instruktioner eller fortsætte med en anden opgave i samme session.

Se oversigten over Agents API for understøttede funktioner og eksempler.

Hvordan kommer jeg i gang?

1. Opret en API-nøgle til applikationen i dit projekt på OpenAI Platform. Tildel tilladelserne api.agents.read og api.agents.write til sessioner samt api.responses.write til modelanmodninger.

2. Følg startvejledningen for at konfigurere en agent, oprette en session og sende en opgave.

3. Følg sessionens hændelser for at se fremskridt og resultater. Gem sessions-id'et, hvis du vil fortsætte arbejdet.

Opbevar din API-nøgle uden for agentens sandkasse. Anmodninger kræver headeren OpenAI-Beta: agents=v1. OpenAI's SDK'er tilføjer automatisk denne header.

Har min agent brug for en sandkasse?

Vælg det miljø, der passer til opgaven:

• Intet miljø: Agenten besvarer spørgsmål eller bruger eksterne værktøjer uden at have brug for indbyggede shellkommandoer eller filer i arbejdsområdet.

• Sandkasse hostet af OpenAI: Agenten skal køre scripts eller arbejde med filer, og du vil have OpenAI til at administrere dens sandkasse.

• Selvhostet sandkasse: Du har brug for din egen infrastruktur, din egen software eller dit eget private netværk. Din applikation administrerer miljøets livscyklus.

Se arkitekturen i Agents API for detaljer om konfiguration.

Hvor kan jeg gennemgå en session?

Åbn Logfiler i Platform-dashboardet, vælg Agenter, og søg efter sessions-id'et. Du kan undersøge runder, værktøjskald og underagenters aktivitet.

Vejledningen om observerbarhed forklarer også, hvordan du gennemgår det registrerede tokenforbrug.

Hvad gør jeg, hvis forbindelsen til hændelsesstrømmen afbrydes?

Hent den eksisterende session og dens gemte elementer, før du prøver igen. Så kan du kontrollere, hvad der skete, før du sender flere opgaver.

En afsluttet runde betyder ikke, at alle værktøjer blev kørt uden fejl. Gennemgå det rapporterede resultat. At en session er inaktiv, er ikke i sig selv bevis på, at opgaven er fuldført korrekt.

Hvordan afregnes forbruget?

Modelanmodninger afregnes til den valgte models API-priser. OpenAI-værktøjer og sandkasser hostet af OpenAI afregnes til de gældende priser for værktøjer og containere.

Se de aktuelle priser under API-priser.

Hvordan håndteres sessionsdata og filer?

Agents API gemmer sessionens tilstand, så arbejdet kan fortsætte på tværs af runder. Du kan slette sessioner og publicerede artefakter, når der ikke længere er brug for dem. Gem de filer, du har brug for, før du sletter en session.

Agents API understøtter i øjeblikket kun dataresidens i USA. Det understøtter ikke indstillingen ingen datalagring, heller ikke når du bruger en selvhostet sandkasse. Se dokumentationen til Agents API for detaljer om datakontrol.