Vai al contenuto principale
OpenAI

15 aprile 2026

Prodotto

La prossima evoluzione dell'Agents SDK

L’Agents SDK aggiornato aiuta gli sviluppatori a creare agenti in grado di ispezionare file, eseguire comandi, modificare codice e lavorare su attività di lungo periodo in ambienti sandbox controllati.

Caricamento in corso...

Stiamo introducendo nuove funzionalità nell’Agents SDK che forniscono agli sviluppatori un’infrastruttura standardizzata, facile da adottare e progettata per i modelli OpenAI: un'infrastruttura nativa che consente agli agenti di operare tra file e strumenti su un computer, insieme all’esecuzione nativa in sandbox per svolgere il lavoro in sicurezza.

Ad esempio, gli sviluppatori possono fornire a un agente un'area di lavoro controllata, istruzioni esplicite e gli strumenti necessari per esaminare le evidenze:

Python

1
# pip install "openai-agents>=0.14.0"
2

3
import asyncio
4
import tempfile
5
from pathlib import Path
6

7
from agents import Runner
8
from agents.run import RunConfig
9
from agents.sandbox import Manifest, SandboxAgent, SandboxRunConfig
10
from agents.sandbox.entries import LocalDir
11
from agents.sandbox.sandboxes import UnixLocalSandboxClient
12

13

14
async def main() -> None:
15
with tempfile.TemporaryDirectory() as tmp:
16
dataroom = Path(tmp) / "dataroom"
17
dataroom.mkdir()
18
(dataroom / "metrics.md").write_text(
19
"""# Annual metrics
20

21
| Year | Revenue | Operating income | Operating cash flow |
22
| --- | ---: | ---: | ---: |
23
| FY2025 | $124.3M | $18.6M | $24.1M |
24
| FY2024 | $98.7M | $12.4M | $17.9M |
25
""",
26
encoding="utf-8",
27
)
28

29
agent = SandboxAgent(
30
name="Dataroom Analyst",
31
model="gpt-5.4",
32
instructions="Answer using only files in data/. Cite source filenames.",
33
default_manifest=Manifest(entries={"data": LocalDir(src=dataroom)}),
34
)
35

36
result = await Runner.run(
37
agent,
38
"Compare FY2025 revenue, operating income, and operating cash flow with FY2024.",
39
run_config=RunConfig(
40
sandbox=SandboxRunConfig(client=UnixLocalSandboxClient()),
41
),
42
)
43
print(result.final_output)
44

45

46
if __name__ == "__main__":
47
asyncio.run(main())
48

Gli sviluppatori hanno bisogno di più dei migliori modelli per creare agenti utili: servono sistemi che supportino l’ispezione dei file, l’esecuzione di comandi, la scrittura di codice e il lavoro multi-step.

I sistemi attuali comportano compromessi nel passaggio dal prototipo alla produzione. I framework model-agnostic sono flessibili ma non sfruttano appieno le capacità dei modelli di frontiera; gli SDK dei provider sono più vicini al modello ma spesso offrono poca visibilità sull'infrastruttura; le API gestite semplificano il deployment ma limitano esecuzione e accesso ai dati sensibili.

Ecco cosa dicono alcuni dei clienti che hanno testato con noi il nuovo SDK:

"GPT-5.4 stabilisce un nuovo standard per il lavoro legale con molti documenti. Su BigLaw Bench eval, ha ottenuto un punteggio del 91%. Rispetto ad altri modelli, GPT-5.4 è attualmente più efficace nello strutturare analisi transazionali complesse, mantenendo l’accuratezza su contratti molto lunghi e fornendo il livello di dettaglio elevato richiesto dai professionisti legali.”
Niko Grupen: Responsabile della Ricerca Applicata di Harvey

Un’infrastruttura più evoluta per il ciclo agente

Con il rilascio di oggi, l'infrastruttura per gli agenti di Agents SDK diventa più capace per gli agenti che lavorano con documenti, file e sistemi. Ora include memoria configurabile, orchestrazione consapevole della sandbox, strumenti filesystem in stile Codex e integrazioni standard con primitive sempre più diffuse nei sistemi agentici.

Queste primitive includono l'uso degli strumenti tramite MCP(si apre in una nuova finestra), la divulgazione progressiva tramite skills(si apre in una nuova finestra), istruzioni personalizzate tramite AGENTS.md(si apre in una nuova finestra), esecuzione del codice tramite lo strumento shell(si apre in una nuova finestra), modifiche ai file tramite lo strumento apply patch(si apre in una nuova finestra) e altro ancora. L’infrastruttura continuerà a integrare nel tempo nuovi pattern e primitive agentiche, consentendo agli sviluppatori di dedicare meno tempo agli aggiornamenti dell’infrastruttura di base e più tempo alla logica specifica del dominio che rende utili i loro agenti.

Diagramma che mostra come l’Agent SDK collega input utente, modelli e strumenti per creare agenti IA.
Diagramma che mostra come creare agenti IA utilizzando l’Agent SDK con modelli, strumenti e orchestrazione.

L'infrastruttura aiuta inoltre gli sviluppatori a sfruttare appieno le capacità di un modello di frontiera, allineando l’esecuzione alle modalità operative ottimali di tali modelli. Questo mantiene gli agenti più vicini al comportamento operativo naturale del modello, migliorando affidabilità e prestazioni nelle attività complesse, soprattutto quando il lavoro è di lunga durata o coordinato tra un insieme eterogeneo di strumenti e sistemi.

Inoltre, siamo consapevoli che ogni prodotto è unico e raramente si adatta perfettamente a uno schema predefinito. Abbiamo progettato l’Agents SDK per supportare questa diversità. Gli sviluppatori ottengono un’infrastruttura pronta all’uso ma flessibile, facile da adattare al proprio stack, inclusi uso degli strumenti, memoria e ambiente sandbox.

Esecuzione nativa in sandbox

L’Agents SDK aggiornato supporta nativamente l’esecuzione in sandbox, consentendo agli agenti di operare in ambienti controllati con file, strumenti e dipendenze necessari per ogni attività.

Molti agenti utili richiedono un’area di lavoro in cui possano leggere e scrivere file, installare dipendenze, eseguire codice e utilizzare strumenti in modo sicuro. Il supporto nativo alla sandbox fornisce agli sviluppatori questo livello di esecuzione out-of-the-box, evitando di doverlo costruire manualmente.

Gli sviluppatori possono utilizzare la propria sandbox oppure il supporto integrato per Blaxel, Cloudflare, Daytona, E2B, Modal, Runloop e Vercel.

Per rendere questi ambienti portabili tra provider, l’SDK introduce anche un’astrazione Manifest per descrivere l’area di lavoro dell’agente. Gli sviluppatori possono montare file locali, definire directory di output e importare dati da provider di storage come AWS S3, Google Cloud Storage, Azure Blob Storage e Cloudflare R2.

Questo offre un modo coerente per configurare l’ambiente dell’agente, dal prototipo locale alla distribuzione in produzione. Fornisce inoltre al modello un’area di lavoro prevedibile: dove trovare gli input, dove scrivere gli output e come organizzare il lavoro durante attività di lunga durata.

Loghi di Daytona, E2B, Modal, Cloudflare, Vercel, Blaxel, Runloop

Separazione tra infrastruttura e calcolo per sicurezza, resilienza e scalabilità

I sistemi agentici dovrebbero essere progettati assumendo la presenza di tentativi di iniezione di prompt ed esfiltrazione dei dati. Separare infrastruttura e calcolo aiuta a mantenere le credenziali al di fuori degli ambienti in cui viene eseguito codice generato dal modello.

Consente inoltre un’esecuzione resiliente. Quando lo stato dell’agente è esternalizzato, la perdita di un container sandbox non comporta la perdita dell’esecuzione. Grazie a snapshot e reidratazione integrati, l’Agents SDK può ripristinare lo stato dell’agente in un nuovo container e riprendere dall’ultimo checkpoint in caso di errore o scadenza dell’ambiente originale.

Infine, rende gli agenti più scalabili. Le esecuzioni degli agenti possono utilizzare una o più sandbox, attivarle solo quando necessario, instradare i sub-agenti verso ambienti isolati e parallelizzare il lavoro tra container per un’esecuzione più rapida.

Diagramma di flusso che illustra come l’Agent SDK consente agli agenti IA di utilizzare risorse di calcolo aggiuntive per attività più complesse.
Diagramma che illustra come gli agenti IA costruiti con l’Agent SDK possano orchestrare sistemi di calcolo separati, consentendo l’esecuzione indipendente dei carichi di lavoro e supportando attività più avanzate.

Tariffe e disponibilità

Queste nuove funzionalità dell’Agents SDK sono disponibili per tutti i clienti tramite API e seguono il modello di pricing standard basato su token e utilizzo degli strumenti.

Prossimi passi

Continuando a sviluppare l’Agents SDK, amplieremo ulteriormente ciò che gli sviluppatori possono costruire, rendendo più semplice portare in produzione agenti più avanzati con meno infrastruttura personalizzata, mantenendo al contempo flessibilità e controllo per integrarli nei propri ambienti.

Le nuove funzionalità dell'infrastruttura e della sandbox vengono rilasciate inizialmente in Python, con il supporto per TypeScript previsto in una versione successiva. Stiamo inoltre lavorando per introdurre ulteriori capacità agentiche, tra cui la modalità code e i sub-agenti, sia in Python che in TypeScript.

Inoltre, puntiamo a unificare progressivamente l’ecosistema degli agenti, ampliando il supporto per provider di sandbox, integrazioni e modalità di connessione dell’SDK agli strumenti e sistemi già in uso.