Prezentare generală

API-ul Agents este disponibil în versiune beta. Le permite dezvoltatorilor să creeze aplicații cu un agent Codex gestionat de OpenAI, care poate lucra în mai mulți pași și poate continua în aceeași sesiune.

Aplicația ta furnizează sarcina, instrumentele și configurația. OpenAI gestionează sesiunea agentului și coordonarea dintre modelul și instrumentele acestuia.

Ce poate face un agent?

În funcție de instrumentele sale și de mediul de execuție, un agent poate rula cod, edita fișiere, folosi conexiuni MCP și crea fișiere pentru aplicația ta. Poți trimite instrucțiuni suplimentare sau poți continua cu o altă sarcină în aceeași sesiune.

Consultă prezentarea generală a API-ului Agents pentru funcționalitățile acceptate și exemple.

Cum încep?

1. Creează o cheie API pentru aplicație în proiectul tău de pe platforma OpenAI. Acordă permisiunile api.agents.read și api.agents.write pentru sesiuni, precum și api.responses.write pentru solicitările către model.

2. Urmează ghidul de pornire rapidă pentru a configura un agent, a crea o sesiune și a trimite o sarcină.

3. Urmărește evenimentele sesiunii pentru a verifica progresul și rezultatele. Salvează ID-ul sesiunii dacă vrei să continui lucrul.

Păstrează cheia API în afara mediului sandbox al agentului. Solicitările necesită antetul OpenAI-Beta: agents=v1. SDK-urile OpenAI adaugă automat acest antet.

Agentul meu are nevoie de un mediu sandbox?

Alege mediul potrivit pentru sarcină:

• Fără mediu: Agentul răspunde la întrebări sau folosește instrumente externe fără a avea nevoie de comenzi shell integrate sau de fișiere din spațiul de lucru.

• Mediu sandbox găzduit de OpenAI: Agentul trebuie să ruleze scripturi sau să lucreze cu fișiere și vrei ca OpenAI să îi gestioneze mediul sandbox.

• Mediu sandbox găzduit pe infrastructura proprie: Ai nevoie de propria infrastructură, de propriul software sau de o rețea privată. Aplicația ta gestionează ciclul de viață al mediului.

Consultă arhitectura API-ului Agents pentru detalii despre configurare.

Unde pot examina o sesiune?

Deschide secțiunea Jurnale din panoul de control al platformei, selectează Agenți și caută ID-ul sesiunii. Poți examina rundele de interacțiune, apelurile către instrumente și activitatea subagenților.

Ghidul de observabilitate explică și cum poți consulta consumul de tokenuri înregistrat.

Ce fac dacă se întrerupe conexiunea la fluxul de evenimente?

Preia sesiunea existentă și elementele salvate ale acesteia înainte de a încerca din nou. Astfel, poți verifica ce s-a întâmplat înainte de a trimite sarcini suplimentare.

Finalizarea unei runde de interacțiune nu înseamnă că fiecare instrument a fost executat cu succes. Verifică rezultatul raportat. Simplul fapt că o sesiune este inactivă nu confirmă că sarcina s-a încheiat cu succes.

Cum se facturează utilizarea?

Solicitările către model sunt facturate la tarifele API ale modelului selectat. Instrumentele OpenAI și mediile sandbox găzduite de OpenAI sunt facturate la tarifele aplicabile pentru instrumente și containere.

Consultă prețurile API pentru tarifele actuale.

Cum sunt gestionate datele sesiunii și fișierele?

API-ul Agents păstrează starea sesiunii, astfel încât lucrul să poată continua de la o rundă de interacțiune la alta. Poți șterge sesiunile și artefactele publicate când nu mai ai nevoie de ele. Salvează toate fișierele de care ai nevoie înainte de a șterge o sesiune.

API-ul Agents acceptă în prezent rezidența datelor doar în Statele Unite. Nu acceptă opțiunea zero date păstrate, nici atunci când folosești un mediu sandbox găzduit pe infrastructura proprie. Consultă documentația API-ului Agents pentru detalii despre controlul datelor.