Dopo Agent Builder: Agents SDK, Workspace Agents e Agents API
In questa pagina
Finora, questa lezione ha trattato Agent Builder, lo strumento visivo no-code di OpenAI per creare agenti. OpenAI ne ha annunciato la fine del ciclo di vita il 3 giugno 2026, con lo spegnimento previsto per il 30 novembre 2026. Invece di imparare uno strumento destinato a scomparire, esaminiamo cosa lo sostituisce. Hai tre percorsi possibili a seconda dei tuoi obiettivi: scrivere codice, costruire in linguaggio naturale per un team o affidare l’orchestrazione a OpenAI.
Cosa chiude, cosa rimane
Agent Builder sta chiudendo; ChatKit, il componente di interfaccia che vedrai più avanti in questo corso, rimane disponibile. Se hai già un flusso di lavoro in Agent Builder, OpenAI ti permette di esportarlo prima dello spegnimento: apri il flusso di lavoro, scegli Code nella barra superiore, poi Agents SDK, seleziona TypeScript o Python e copia l’esportazione completa. La guida alla migrazione avverte onestamente che questa esportazione non converte il grafico del flusso di lavoro e non garantisce che ogni comportamento venga replicato esattamente: pianifica una fase di test.
Percorso 1: Agents SDK, per costruire nel codice
Questo è il percorso che questo corso intraprende a partire dalla prossima lezione. L’Agents SDK ti offre il pieno controllo: dichiari l’agente, le sue istruzioni, il suo modello e i suoi strumenti all’interno della tua applicazione, lo esegui nel tuo ambiente e lo distribuisci come il resto del tuo codice. L’esportazione di Agent Builder si integra direttamente con esso; installi quindi l’SDK corrispondente, configuri l’applicazione e convalidi il comportamento prima della distribuzione.
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)
Percorso 2: ChatGPT Workspace Agents
Se utilizzavi Agent Builder per evitare di scrivere codice, l’equivalente risiede ora in ChatGPT. Gli Workspace agents vengono creati in linguaggio naturale e condivisi con un team; richiedono un piano ChatGPT Business, Enterprise o Edu, l’accesso agli workspace agents e il permesso di crearli. Per migrare, OpenAI suggerisce un metodo semplice: crea un nuovo agente in ChatGPT e incolla l’esportazione del tuo flusso di lavoro con il prompt «aiutami a convertire questo flusso di lavoro in un agente». Prima di finalizzare, rivedi le istruzioni generate, configura le app, le competenze, le autenticazioni e i permessi necessari, quindi usa Preview per riprodurre casi rappresentativi del flusso di lavoro originale. Da notare una limitazione: un flusso di lavoro il cui nucleo si basa su una sequenza strettamente deterministica potrebbe non tradursi fedelmente in un agente.
Percorso 3: Agents API, quando OpenAI orchestra per te
Dal 10 settembre 2026 esiste un terzo percorso in beta pubblica: l’Agents API. Fornisce alla tua applicazione l’accesso all’infrastruttura Codex tramite un’API gestita da OpenAI. La tua applicazione fornisce gli strumenti e sceglie l’ambiente di esecuzione; OpenAI gestisce sessioni, orchestrazione, compattazione del contesto e recupero dagli incidenti. L’agente può lavorare in una sandbox dove esegue codice, modifica file, si connette a server MCP e produce documenti.
L’API ruota attorno a quattro concetti: l’agent (modello, istruzioni, strumenti e server MCP), l’environment (una sandbox o un computer, opzionale, ospitato da OpenAI o da te), la session (un’istanza durevole dell’agente che riceve compiti e risponde ad essi) e gli events (ciò che invii e ciò che l’agente produce). Una sessione si svolge in quattro fasi: la crei, le assegni un compito, ne monitori i progressi tramite stream o webhook, e infine la riavvii o la reindirizzi a metà percorso.
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)
Due vincoli devono essere verificati prima di scegliere questo percorso per dati sensibili: l’Agents API offre attualmente la residenza dei dati solo negli Stati Uniti e non è idonea per la conservazione zero dei dati, anche con una sandbox ospitata da te. La fatturazione segue la tariffa API per il modello scelto, la tariffa per gli strumenti OpenAI e la tariffa per i container per le sandbox ospitate.
Come scegliere
Se il tuo team sa sviluppare e vuole mantenere il controllo sull’esecuzione, scegli l’Agents SDK. Se l’obiettivo è mettere un agente nelle mani di colleghi non sviluppatori all’interno di ChatGPT, scegli gli workspace agents. Se desideri un agente che lavori per lunghe durate, con esecuzione di codice e sotto-agenti, senza mantenere tu stesso l’orchestrazione, esamina l’Agents API, tenendo presente il suo stato beta e i vincoli sui dati.
Fonti ufficiali: Migrate from Agent Builder · Agents API · Deprecations
Punti chiave
- Agent Builder chiude il 30 novembre 2026; ChatKit rimane disponibile; esporta i tuoi flussi di lavoro nel codice Agents SDK prima di tale data
- Agents SDK: costruisci nel codice e distribuisci nella tua applicazione: questo è il percorso di questo corso
- Workspace agents: costruisci in linguaggio naturale in ChatGPT (piani Business, Enterprise, Edu)
- Agents API (beta pubblica): OpenAI gestisce sessioni, orchestrazione e compattazione; residenza dei dati solo negli Stati Uniti, nessuna conservazione zero dei dati