OpenAI ha fissato ufficialmente il 26 agosto 2026 come data di chiusura per la sua Assistants API. Se il tuo software utilizza questa API, dovrai migrare il codice prima di tale scadenza per evitare interruzioni delle funzionalità. L’avviso è apparso per la prima volta nell’elenco delle OpenAI API deprecations il 20 agosto 2025, anche se OpenAI non ha comunicato l’orario esatto dell’interruzione definitiva.
Come funziona la nuova struttura
Per sostituire il vecchio sistema, OpenAI indirizza gli sviluppatori verso la Responses API e la Conversations API. La Assistants migration guide ufficiale illustra nel dettaglio come si traducono i vecchi componenti:
- Assistants diventano prompt.
- Threads si trasformano in
Conversations. - Runs diventano
Responses. - Run steps si trasformano in elementi generici.
Una risposta può utilizzare elementi di input diretto o un oggetto conversation. Questo passaggio comporta più lavoro sul backend. Il codice della tua applicazione dovrà ora gestire l’orchestrazione, inclusa la riduzione della cronologia, i tentativi di richiesta e i cicli di chiamata dei tool.
Due trappole a cui prestare attenzione
In primo luogo, OpenAI non fornisce alcuno strumento automatico per convertire i vecchi Threads nelle nuove Conversations. Dovrai occupartene personalmente. La guida suggerisce di instradare prima le nuove chat attraverso la nuova API, per poi copiare la cronologia delle conversazioni precedenti solo quando necessario.
In secondo luogo, la migrazione dei prompt ha una propria scadenza. La guida menziona gli oggetti prompt, ma OpenAI avverte che anche gli oggetti prompt riutilizzabili sono in fase di deprecazione. È consigliabile verificare tale tempistica prima di finalizzare la propria architettura.
Cosa non dimostra la documentazione
I documenti di OpenAI confermano la data di chiusura e la nuova struttura, ma non garantiscono la parità di velocità o di prezzo. Nessuno al di fuori dell’azienda ha verificato la latenza, i costi dei token o la qualità dell’output tra i due sistemi. Inoltre, i documenti non stabiliscono un’interruzione universale del servizio su tutti gli account o in tutte le aree geografiche.
Come testare la migrazione
Inizia presto la migrazione. Non aspettare la corsa dell’ultimo minuto.
Inizia elencando ogni assistant, thread, run, custom tool e percorso file nel tuo codebase. Successivamente, crea un flusso di test utilizzando la Responses API e la Conversations API. Riproduci le conversazioni salvate e le chiamate di tool a più passaggi attraverso entrambi i sistemi. Confronta fianco a fianco qualità dell’output, utilizzo dei token, latenza e recupero dagli errori. Mantieni monitorati entrambi i percorsi finché non avrai la certezza che la nuova applicazione funzioni in modo affidabile.