Salt la conținutul principal
Română— Alege o limbă
Meniu

După Agent Builder: Agents SDK, Workspace Agents și Agents API

Lecția 3 din 25 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Ce se închide, ce rămâne
  2. Opțiunea 1: Agents SDK, pentru construirea în cod
  3. Opțiunea 2: ChatGPT Workspace Agents
  4. Opțiunea 3: Agents API, când OpenAI orchestrează pentru dumneavoastră
  5. Cum să alegeți
  6. Puncte cheie

Până acum, această lecție a acoperit Agent Builder, instrumentul vizual fără cod al OpenAI pentru crearea de agenți. OpenAI a anunțat sfârșitul ciclului de viață al acestuia la 3 iunie 2026, cu oprirea programată pentru 30 noiembrie 2026. În loc să învățați un instrument care va dispărea, să analizăm ce îl înlocuiește. Aveți trei opțiuni în funcție de obiectivele dumneavoastră: scrierea de cod, construirea în limbaj natural pentru o echipă sau delegarea orchestrării către OpenAI.

Ce se închide, ce rămâne

Agent Builder se închide; ChatKit, componenta de interfață pe care o veți vedea mai târziu în acest curs, rămâne disponibil. Dacă aveți deja un flux de lucru în Agent Builder, OpenAI vă permite să îl exportați înainte de oprire: deschideți fluxul de lucru, alegeți Code în bara de sus, apoi Agents SDK, selectați TypeScript sau Python și copiați exportul complet. Ghidul de migrare avertizează onest că acest export nu convertește graful fluxului de lucru și nu garantează că fiecare comportament va fi replicat exact: planificați o fază de testare.

Opțiunea 1: Agents SDK, pentru construirea în cod

Aceasta este calea pe care o urmează acest curs începând cu lecția următoare. Agents SDK vă oferă control total: declarați agentul, instrucțiunile sale, modelul și instrumentele sale direct în aplicația dumneavoastră, îl rulați în propriul mediu și îl implementați la fel ca restul codului. Exportul din Agent Builder se integrează direct în el; instalați apoi SDK-ul corespunzător, configurați aplicația și validați comportamentul înainte de implementare.

from agents import Agent, Runner, WebSearchTool

agent = Agent(
    name="Technical Support",
    instructions=(
        "You are a technical support agent for a SaaS company. "
        "Respond in English. Identify the problem before proposing solutions."
    ),
    model="gpt-6.1-sol",
    tools=[WebSearchTool()],
)

result = Runner.run_sync(agent, "My CSV export has been empty since this morning.")
print(result.final_output)

Opțiunea 2: ChatGPT Workspace Agents

Dacă ați folosit Agent Builder pentru a evita codarea, echivalentul său se află acum în ChatGPT. Workspace agents sunt creați în limbaj natural și partajați cu o echipă; aceștia necesită un plan ChatGPT Business, Enterprise sau Edu, acces la workspace agents și permisiunea de a-i crea. Pentru migrare, OpenAI sugerează o metodă simplă: creați un nou agent în ChatGPT și lipiți exportul fluxului de lucru cu promptul „help me convert this workflow into an agent“. Înainte de finalizare, revizuiți instrucțiunile generate, configurați aplicațiile, abilitățile, autentificările și permisiunile necesare, apoi utilizați Preview pentru a replay cazuri reprezentative fluxului de lucru original. O limită de reținut: un flux de lucru al cărui nucleu se bazează pe o secvență strict deterministă s-ar putea să nu se traducă fidel într-un agent.

Opțiunea 3: Agents API, când OpenAI orchestrează pentru dumneavoastră

Începând cu 10 septembrie 2026, există o a treia cale în beta public: Agents API. Aceasta oferă aplicației dumneavoastră acces la infrastructura Codex printr-un API gestionat de OpenAI. Aplicația dumneavoastră furnizează instrumentele și alege mediul de execuție; OpenAI gestionează sesiunile, orchestrarea, compactarea contextului și recuperarea în urma incidentelor. Agentul poate lucra într-un sandbox unde execută cod, modifică fișiere, se conectează la servere MCP și produce documente.

API-ul se articulează în jurul a patru concepte: agentul (model, instrucțiuni, instrumente și servere MCP), mediul (un sandbox sau computer, opțional, găzduit de OpenAI sau de dumneavoastră), sesiunea (o instanță durabilă a agentului care primește sarcini și răspunde la acestea) și evenimentele (ce trimiteți și ce produce agentul). O sesiune se desfășoară în patru etape: o creați, îi atribuiți o sarcină, îi monitorizați progresul prin stream sau webhook, apoi o reporniți sau o redirecționați la jumătatea drumului.

from openai import OpenAI

client = OpenAI()

session = client.beta.agents.sessions.create(
    agent={
        "model": "gpt-6-astra",
        "instructions": "Answer technical questions precisely, relying on web search.",
        "tools": [{"type": "web_search"}],
    },
    input=[{
        "role": "user",
        "content": [{"type": "input_text", "text": "Summarize the recommended steps to connect an MCP server to an OpenAI agent."}],
    }],
)
print(session.id)

Două constrângeri trebuie verificate înainte de a alege această cale pentru date sensibile: Agents API oferă actualmente rezidența datelor doar în Statele Unite și nu este eligibil pentru retenția zero a datelor, chiar și cu un sandbox găzduit de dumneavoastră. Facturarea urmează tariful API pentru modelul ales, tariful pentru instrumentele OpenAI și tariful pentru containerele sandbox-urilor găzduite.

Cum să alegeți

Dacă echipa dumneavoastră știe să dezvolte și dorește să păstreze controlul asupra execuției, alegeți Agents SDK. Dacă obiectivul este să puneți un agent la dispoziția colegilor non-dezvoltatori în cadrul ChatGPT, alegeți workspace agents. Dacă doriți un agent care lucrează pe durate lungi, cu executare de cod și sub-agenți, fără a menține orchestrarea dumneavoastră, analizați Agents API, având în vedere statutul său beta și constrângerile privind datele.

Surse oficiale: Migrate from Agent Builder · Agents API · Deprecations

Puncte cheie

  • Agent Builder se închide la 30 noiembrie 2026; ChatKit rămâne disponibil; exportați fluxurile de lucru în cod Agents SDK înainte de această dată
  • Agents SDK: construiți în cod și implementați în aplicația dumneavoastră – aceasta este calea pentru acest curs
  • Workspace agents: construiți în limbaj natural în ChatGPT (planuri Business, Enterprise, Edu)
  • Agents API (beta public): OpenAI gestionează sesiunile, orchestrarea și compactarea; rezidența datelor doar în Statele Unite, fără retenție zero a datelor