Översikt

Agents API är tillgängligt i betaversion. Med det kan utvecklare bygga applikationer med en Codex-agent som hanteras av OpenAI och kan arbeta i flera steg och fortsätta i samma session.

Din applikation tillhandahåller uppgiften, verktygen och konfigurationen. OpenAI hanterar agentens session och samordningen mellan dess modell och verktyg.

Vad kan en agent göra?

Beroende på verktyg och körmiljö kan en agent köra kod, redigera filer, använda MCP-anslutningar och skapa filer för din applikation. Du kan skicka ytterligare instruktioner eller fortsätta med en annan uppgift i samma session.

Se översikten över Agents API för funktioner som stöds och exempel.

Hur kommer jag igång?

1. Skapa en API-nyckel för applikationen i ditt projekt på OpenAI-plattformen. Ge behörigheterna api.agents.read och api.agents.write för sessioner samt api.responses.write för modellanrop.

2. Följ snabbstartsguiden för att konfigurera en agent, skapa en session och skicka in en uppgift.

3. Följ sessionens händelser för att se hur arbetet fortskrider och granska resultaten. Spara sessions-ID:t om du vill fortsätta arbetet.

Förvara din API-nyckel utanför agentens sandlåda. Anrop kräver HTTP-huvudet OpenAI-Beta: agents=v1. OpenAI:s SDK:er lägger till detta HTTP-huvud automatiskt.

Behöver min agent en sandlåda?

Välj den miljö som passar uppgiften:

• Ingen miljö: Agenten besvarar frågor eller använder externa verktyg utan att behöva inbyggda skalkommandon eller filer i arbetsytan.

• Sandlåda som driftas av OpenAI: Agenten behöver köra skript eller arbeta med filer, och du vill att OpenAI ska hantera sandlådan.

• Egenhostad sandlåda: Du behöver egen infrastruktur, egen programvara eller ett privat nätverk. Din applikation hanterar miljöns livscykel.

Se arkitekturen för Agents API för konfigurationsdetaljer.

Var kan jag granska en session?

Öppna Loggar i plattformens kontrollpanel, välj Agenter och sök efter sessions-ID:t. Du kan granska turer, verktygsanrop och underagenters aktivitet.

I guiden om observerbarhet beskrivs också hur du granskar registrerad tokenanvändning.

Vad gör jag om anslutningen till händelseströmmen bryts?

Hämta den befintliga sessionen och dess sparade objekt innan du försöker igen. Då kan du kontrollera vad som hände innan du skickar in fler uppgifter.

En avslutad tur innebär inte att alla verktyg lyckades. Granska det rapporterade resultatet. Att en session är inaktiv är i sig ingen bekräftelse på att uppgiften slutfördes utan problem.

Hur debiteras användningen?

Modellanrop debiteras enligt den valda modellens API-priser. OpenAI-verktyg och sandlådor som driftas av OpenAI debiteras enligt respektive verktygs- och containerpriser.

Se API-priser för aktuella priser.

Hur hanteras sessionsdata och filer?

Agents API sparar sessionens tillstånd så att arbetet kan fortsätta över flera turer. Du kan radera sessioner och publicerade artefakter när de inte längre behövs. Spara alla filer du behöver innan du raderar en session.

Agents API stöder för närvarande endast datahemvist i USA. Det stöder inte noll datalagring, inte heller när du använder en egenhostad sandlåda. Se dokumentationen för Agents API för detaljer om datakontroller.