Prompt OpenAI: stop il 30 novembre, stessi pmpt_ con versioni

Il 30 novembre 2026 OpenAI disattiverà gli oggetti prompt riutilizzabili e l’API v1/prompts, insieme alla dashboard e all’API di Evals. OpenAI ne annuncia la disattivazione, ma non specifica cosa restituirà dopo quella data una chiamata alla Responses API con prompt={"id": "pmpt_..."}. Il testo dei prompt va quindi trasferito altrove prima della chiusura. Abbiamo ricreato un prompt con il suo id pmpt_ nella libreria di prompt di Synthorai e indirizzato una chiamata dell’SDK OpenAI al gateway Synthorai, un proxy API tra l’applicazione e i fornitori dei modelli. Abbiamo cambiato solo URL di base e chiave: la richiesta ha usato la versione 2 della libreria quando specificava la versione "2", e la versione di produzione quando non ne specificava nessuna.

TL;DR

• Gli oggetti prompt e l’API v1/prompts di OpenAI verranno disattivati il 30 novembre 2026; le valutazioni di OpenAI passeranno in sola lettura il 31 ottobre.
• Una chiamata Responses con prompt={"id": "pmpt_...", "version": "2"} ha usato la versione 2 di un prompt con lo stesso id nella libreria Synthorai; è cambiato solo l’URL di base.
• Con traffico costante, lo spostamento dell’etichetta di produzione di un prompt della libreria si è riflesso sulle chiamate in 8-9 s.
• Un test definito prima dell’esecuzione ha rilevato una modifica che violava una regola nel 16% delle risposte; una precedente esecuzione su 40 righe l’aveva promossa.

Questo articolo presenta una serie di tre guide sulla libreria di prompt. Ogni sezione riassume una guida, riporta le misurazioni e rimanda al testo completo per il codice e gli screenshot della console. Tutte le esecuzioni risalgono al 19 e 20 ottobre 2026. Il codice si trova su github.com/synthorai-io/use-cases, nella directory prompt-library/.

Cosa disattiva OpenAI e quando?

La pagina delle dismissioni di OpenAI elenca due chiusure previste per lo stesso giorno:

Un oggetto prompt è un prompt salvato nella dashboard OpenAI e richiamato tramite il suo id pmpt_, con versioni e variabili opzionali. La guida alla migrazione di OpenAI consiglia di spostare il testo del prompt nel codice applicativo, passarlo come input alla Responses API e gestirne le versioni con git, revisioni del codice e test. La guida non specifica cosa restituirà una richiesta con un id pmpt_ dopo la disattivazione.

Come mantenere le chiamate pmpt_ senza cambiare codice?

Basta ricreare il prompt in una libreria con lo stesso id e indirizzare il client a un gateway che lo risolva. Il gateway Synthorai legge il campo prompt delle richieste a /v1/responses: se l’id corrisponde a un prompt della libreria, usa quel prompt; un valore numerico di version seleziona la versione corrispondente. Questa è la chiamata della nostra demo. A parte URL di base e chiave, è la stessa richiesta che invia un’applicazione scritta per OpenAI:

import os
from openai import OpenAI

# The only change: the base URL and the key.
client = OpenAI(base_url="https://synthorai.io/v1", api_key=os.environ["SYNTHORAI_API_KEY"])

raw = client.responses.with_raw_response.create(
    model="gpt-6-luna",
    prompt={"id": "pmpt_68f2a1c09d4e4b7a8c3f5e21d0b97a64", "version": "2"},
    input="Where is order A-50977? It has been a week.",
)
print(raw.headers["x-synthorai-prompt-version"])   # 2
print(raw.parse().output_text)

Entrambe le risposte sono arrivate da GPT-6 Luna, il modello salvato nelle versioni della libreria. L’id pmpt_ della demo è inventato; durante la migrazione si usa il proprio. Altre tre verifiche del 20 ottobre coprono i dati inviati da un’applicazione migrata:

L’ultima riga è facile da trascurare. Un numero di versione OpenAI corrisponde alla versione della libreria con lo stesso numero: una chiamata che fissa "version": "7" richiede quindi una v7 nella libreria. Ricreate in ordine le versioni fissate nel codice, in modo che i numeri coincidano, oppure aggiornate le chiamate alla versione ricreata.

La documentazione OpenAI non descrive un’API per leggere un oggetto prompt e non abbiamo trovato una funzione di esportazione. Copiate quindi testo e impostazioni di ogni prompt dalla dashboard OpenAI finché è disponibile. Nella console, costruite un corpo di richiesta Responses a partire dal testo copiato e incollatelo nella funzione di importazione di un nuovo prompt: messaggi, modello, parametri, strumenti e schema di output verranno caricati nella prima versione. In alternativa, scrivete la versione nell’editor.

Meglio tenere i prompt nel codice o in una libreria?

OpenAI consiglia il codice. Una libreria permette di modificare un prompt senza deploy, ma aggiunge un servizio al percorso della richiesta:

L’ultima riga è il costo operativo della libreria. Se non riesce a leggerla, il gateway Synthorai usa l’ultima copia del prompt letta per un massimo di 24 ore. Restituisce 503 solo per i prompt di cui non ha una copia recente. Chi vuole entrambe le soluzioni può esportare nel proprio repository un prompt della libreria con tutte le sue versioni in formato JSON.

Quanto costa richiamare un prompt per id?

La chiamata per id non ha costi aggiuntivi: su 20 coppie di richieste, le chiamate tramite prompt_id hanno inviato una mediana di 114.5 token di prompt, identica a quella delle stesse richieste scritte per esteso nel codice. Il gateway inserisce messaggi, modello e parametri della versione e invia al fornitore una normale richiesta. Le chiamate che non possono essere eseguite, per esempio per una variabile mancante o un id sconosciuto, falliscono con un 400 o 404 prima di invocare qualsiasi modello e non vengono addebitate. Un’etichetta è un riferimento con un nome, come production o staging, che indica una versione alla volta. Con una chiamata ogni mezzo secondo, lo spostamento dell’etichetta production si è riflesso sulle chiamate dopo una mediana di 8.0-8.5 s; dopo 15 s senza traffico, già alla prima chiamata. La guida al versionamento dei prompt contiene il codice, i cinque casi di errore e il metodo di misurazione dei tempi.

Come provare una nuova versione su parte del traffico di produzione?

Si assegna all’etichetta production una seconda versione e una quota di traffico. Il gateway distribuisce le chiamate in base all’id di sessione, passato nell’header X-Session-Id, che raggruppa le chiamate di una conversazione. Così una conversazione non cambia versione a metà. Nel rollout al 10%, 16 sessioni su 200 (8.0%) sono state assegnate alla candidata, e tutte le 400 sessioni delle prove al 10% e al 50% hanno mantenuto la stessa versione. Anche gli utenti finali identificati da un’etichetta _user, dal campo user della richiesta o da safety_identifier sono rimasti sulla stessa versione. La candidata usava lo stesso prompt, passato da GPT-6 Luna a DeepSeek V4.1 Flash. Rispondeva più velocemente, con una mediana di 3.1 s contro 4.9 s, ma nella sola prova con quota al 10% le sue 71 chiamate sono costate per chiamata 1.92 volte quelle di produzione. La guida al test A/B di una modifica al prompt mostra come i totali per versione abbiano fatto emergere la differenza.

Come testare una versione prima del rilascio?

Si eseguono la nuova versione e quella corrente su un set di test fisso e si valuta ogni risposta con controlli definiti per iscritto: pattern, schemi JSON, limiti di latenza e costo, oppure un modello usato come giudice. La nostra v2 accorciava il testo di sistema ed eliminava la regola «indicare sempre il numero d’ordine». Su 110 messaggi mai usati nelle esecuzioni precedenti, v2 ha omesso il numero d’ordine in 18 risposte (16%), mentre v1 non lo ha mai omesso. Il test esatto di Fisher, che calcola la probabilità di osservare per caso una differenza così grande, ha dato p = 3.6 × 10⁻⁶ in un test definito prima dell’esecuzione. Una precedente esecuzione su 40 righe aveva promosso v2 su tutte le righe. Il giudice, Claude Sonnet 5.5, ha rappresentato la maggior parte del costo del test: circa un decimo di centesimo per riga. La guida ai test dei prompt prima del rilascio descrive la regola di dimensionamento che ne deriva.

Per i team che lasciano OpenAI Evals, questa è l’alternativa integrata nella libreria di prompt, con una differenza da prevedere: un test avviato tramite API viene eseguito dal chiamante, che invoca entrambe le versioni, valuta le risposte e salva i risultati nella libreria. La console esegue gli stessi test dal browser.

Cosa fare prima del 30 novembre?

La migrazione si articola in cinque passi:

• Elencare tutti gli id pmpt_ chiamati dal codice, con le versioni fissate.
• Copiare testo e impostazioni di ogni prompt dalla dashboard OpenAI finché è disponibile.
• Decidere per ogni prompt se spostarlo nel codice, come consiglia OpenAI, o in una libreria con lo stesso id.
• Ricreare i prompt nella libreria con i rispettivi id pmpt_, mantenendo il numero originale di ogni versione fissata, e indirizzare l’URL di base del client al gateway; verificare l’header X-Synthorai-Prompt-Version alla prima chiamata.
• Migrare le valutazioni da cui dipendete prima del 31 ottobre, quando quelle di OpenAI passeranno in sola lettura.

Domande frequenti

Cosa succede ai prompt salvati su OpenAI il 30 novembre 2026?

La pagina delle dismissioni di OpenAI indica che gli oggetti prompt riutilizzabili e l’API v1/prompts verranno disattivati il 30 novembre 2026. La guida alla migrazione consiglia di spostare il testo dei prompt nel codice applicativo; non specifica cosa restituirà una richiesta con un id pmpt_ dopo quella data.

Posso continuare a chiamare un id pmpt_ dopo la disattivazione?

Sì, se un gateway risolve quell’id tramite la propria libreria di prompt. Nel nostro test, una chiamata dell’SDK OpenAI con prompt={"id": "pmpt_...", "version": "2"} inviata al gateway Synthorai ha usato la versione 2 della libreria; sono cambiati solo URL di base e chiave. La versione fissata deve esistere nella libreria con lo stesso numero, altrimenti la chiamata restituisce 404.

Cosa può sostituire OpenAI Evals?

Qualsiasi test runner che invoca due versioni di un prompt con input fissi e valuta le risposte. In una libreria di prompt, i set di test e le esecuzioni di valutazione sono accanto al prompt, e la finestra di spostamento dell’etichetta mostra l’ultima esecuzione della versione prima del rilascio.

Altre letture

• Versionamento dei prompt: richiamare un prompt per id e rilasciarlo spostando un’etichetta.
• Test A/B di una modifica al prompt: rollout al 10% e confronto tra versioni.
• Test dei prompt prima del rilascio: set di test, controlli e numero di righe necessario.
• Guida alla libreria di prompt: tutti i campi, incluso l’oggetto prompt di OpenAI.
• OpenAI: migrazione dagli oggetti prompt: la raccomandazione di OpenAI.

← Torna al blog