Un rilascio dichiaratamente didattico
L’11 ottobre 2024 OpenAI pubblica Swarm su GitHub con licenza MIT. La documentazione del progetto specifica esplicitamente che Swarm è “experimental, educational” e non è destinato all’uso in produzione. Il prodotto di riferimento per casi d’uso agentici rimane, alla data del rilascio, l’Assistants API (poi evoluta in Responses API).
Il valore di Swarm non sta quindi in una proposta di runtime industriale, ma nell’esplicitazione di un modello concettuale. Il codice è compatto — poche centinaia di righe in Python puro — e mostra in modo leggibile i pattern ricorrenti nella costruzione di sistemi multi-agent.
Agents, handoffs, routines
Il framework articola quattro primitive. Un Agent è definito da istruzioni (il system prompt) e da un insieme di funzioni tool. Le routines sono il flusso di esecuzione di un agent: richieste al modello, invocazione di tool, iterazione fino al completamento.
Gli handoffs sono il meccanismo distintivo: una funzione tool può restituire un altro Agent come risultato, trasferendo il controllo della conversazione a un nuovo agent con prompt, tool e regole diverse. L’handoff è stateless — il nuovo agent riceve la cronologia dei messaggi — e consente di modellare percorsi decisionali complessi come composizione di agent specializzati, senza introdurre un orchestrator esplicito.
Le context variables sono un dizionario di stato condiviso tra agent, passato come parametro alle funzioni tool. Consentono di mantenere informazioni applicative (ID utente, preferenze, variabili di sessione) fuori dal contesto del modello.
Il paradigma dell’handoff
L’idea centrale è che l’orchestrazione multi-agent non richieda un motore di workflow centralizzato: è il singolo agent a decidere, in base all’input corrente, di delegare il controllo a un collega più adatto. Il risultato è un pattern di programmazione vicino alle state machine decentralizzate, in cui ogni stato (agent) conosce le proprie transizioni possibili (gli altri agent che può invocare).
Questo paradigma influenzerà significativamente l’ecosistema: framework successivi come OpenAI Agents SDK (2025), CrewAI e altri adotteranno varianti del meccanismo di handoff.
Dalla sperimentazione al prodotto
Nel corso del 2025 OpenAI incorpora le lezioni di Swarm nell’OpenAI Agents SDK, il framework production-ready che ne sostituisce il ruolo. Swarm rimane il riferimento canonico per comprendere come l’handoff pattern sia stato formalizzato e rimane un esempio minimalista di valore didattico.
Link: github.com/openai/swarm