Overzicht

De Agents API is beschikbaar als bèta. Hiermee kunnen ontwikkelaars applicaties bouwen met een door OpenAI beheerde Codex-agent die in meerdere stappen kan werken en binnen dezelfde sessie verder kan gaan.

Je applicatie levert de taak, tools en configuratie aan. OpenAI beheert de sessie van de agent en de coördinatie tussen het model en de tools.

Wat kan een agent doen?

Afhankelijk van de tools en uitvoeringsomgeving kan een agent code uitvoeren, bestanden bewerken, MCP-verbindingen gebruiken en bestanden voor je applicatie maken. Je kunt aanvullende instructies sturen of in dezelfde sessie doorgaan met een andere taak.

Bekijk het overzicht van de Agents API voor ondersteunde mogelijkheden en voorbeelden.

Hoe ga ik aan de slag?

1. Maak een API-sleutel voor je applicatie aan in je OpenAI Platform-project. Ken de rechten api.agents.read en api.agents.write toe voor sessies, plus api.responses.write voor modelverzoeken.

2. Volg de snelstartgids om een agent te configureren, een sessie aan te maken en een taak in te dienen.

3. Volg de gebeurtenissen in de sessie om de voortgang en resultaten te bekijken. Bewaar de sessie-ID als je het werk wilt voortzetten.

Bewaar je API-sleutel buiten de sandbox van de agent. Voor verzoeken is de header OpenAI-Beta: agents=v1 vereist. OpenAI-SDK's voegen deze header automatisch toe.

Heeft mijn agent een sandbox nodig?

Kies de omgeving die bij de taak past:

• Geen omgeving: De agent beantwoordt vragen of gebruikt externe tools zonder ingebouwde shellopdrachten of bestanden in de werkruimte nodig te hebben.

• Door OpenAI gehoste sandbox: De agent moet scripts uitvoeren of met bestanden werken, en je wilt dat OpenAI de sandbox beheert.

• Zelfgehoste sandbox: Je hebt je eigen infrastructuur, software of privénetwerk nodig. Je applicatie beheert de levenscyclus van de omgeving.

Raadpleeg de architectuur van de Agents API voor meer informatie over de configuratie.

Waar kan ik een sessie bekijken?

Open Logboeken in het Platform-dashboard, selecteer Agents en zoek naar de sessie-ID. Je kunt beurten, toolaanroepen en de activiteit van subagents bekijken.

In de handleiding voor waarneembaarheid lees je ook hoe je het geregistreerde tokengebruik kunt bekijken.

Wat als de verbinding met de gebeurtenisstream wordt verbroken?

Haal de bestaande sessie en de opgeslagen items op voordat je het opnieuw probeert. Zo kun je controleren wat er is gebeurd voordat je meer werk indient.

Een afgeronde beurt betekent niet dat elke tool succesvol is uitgevoerd. Controleer het gerapporteerde resultaat. Dat een sessie niet actief is, betekent op zichzelf niet dat de taak succesvol is afgerond.

Hoe wordt het gebruik in rekening gebracht?

Voor modelverzoeken gelden de API-tarieven van het geselecteerde model. Voor OpenAI-tools en door OpenAI gehoste sandboxes gelden de bijbehorende tool- en containertarieven.

Bekijk de API-prijzen voor de actuele tarieven.

Hoe wordt er omgegaan met sessiegegevens en bestanden?

De Agents API bewaart de sessiestatus, zodat het werk in volgende beurten kan worden voortgezet. Je kunt sessies en gepubliceerde artefacten verwijderen wanneer je ze niet meer nodig hebt. Sla alle bestanden die je nodig hebt op voordat je een sessie verwijdert.

De Agents API ondersteunt momenteel alleen gegevensresidentie in de Verenigde Staten. De instelling "geen gegevensbewaring" wordt niet ondersteund, ook niet als je een zelfgehoste sandbox gebruikt. Raadpleeg de documentatie van de Agents API voor meer informatie over gegevensbeheer.