L’ANALISI
OpenAI Python 3.35: ultrafast negli Agents e sideband Live tipizzati
Analisi pratica di openai-python 3.35.0: tier ultrafast negli Agents, eventi Live sideband tipizzati, fix websockets 13, compatibilità e checklist di aggiornamento.
In breve: OpenAI Python 3.35.0 consente al codice tipizzato di selezionare `ultrafast` nelle impostazioni modello degli Agents e di gestire come eventi noti sette messaggi Live sideband già esistenti. Per chi usa questi percorsi il vantaggio è evitare enum non riconosciuti e parsing manuale, ma disponibilità del tier e comportamento del servizio devono essere verificati sull’account e sul modello effettivi.
Che cosa cambia nella release 3.35.0
La release pubblicata il 17 ottobre raccoglie due estensioni dei tipi generati e una correzione Realtime. Il pacchetto aggiunge il valore `ultrafast` alle impostazioni modello degli Agents, riconosce sette eventi Live sideband e conserva le ricezioni binarie quando il client usa websockets 13.
Dove compare il tier ultrafast
Il nuovo valore è ammesso nei tipi usati per creare e aggiornare un agente e nelle impostazioni modello della sessione. Il pull request specifica che il cambiamento riguarda l’enum e la descrizione derivati dallo schema OpenAPI, senza rimuovere i tier già disponibili o cambiare le firme pubbliche dei metodi.
Perché il tipo SDK è un delta operativo
Prima di questo aggiornamento un servizio poteva supportare un valore che il client tipizzato non rappresentava ancora. Con la nuova release gli strumenti di type checking, gli IDE e i wrapper costruiti sulle classi del pacchetto possono accettare `ultrafast` senza cast o payload non tipizzati. Resta necessario verificare che il backend autorizzi davvero il tier nella configurazione usata.
Quali eventi Live sideband diventano riconoscibili
Il client aggiunge accesso tipizzato ad audio di input e output riflesso, DTMF e agli stati ringing, answered e failed sulle connessioni Live sideband. Rimangono disponibili la gestione degli eventi sconosciuti e le classi pubbliche precedenti, quindi l’estensione non dovrebbe imporre un parser completamente nuovo.
Il fix per websockets 13
La release corregge il percorso Realtime che poteva non preservare le ricezioni in forma di byte con websockets 13. È un cambiamento distinto dagli eventi sideband, ma va incluso nei test di regressione se l’applicazione riceve frame binari o dipende dalla versione della libreria websocket installata.
Prove disponibili e limiti
Il progetto dichiara test sincroni e asincroni per tutte le sette varianti, per `client_event_id` nullo o omesso, per eventi sconosciuti e per la pulizia della connessione. I test sono stati eseguiti dalla sorgente e da una wheel installata; al momento del merge i test contro il servizio ospitato erano ancora sospesi.
Condizioni e limitazioni
Il rilascio aggiorna tipi e compatibilità del client, non garantisce che il tier ultrafast sia disponibile per ogni account, modello o regione. Il pull request sugli eventi sideband dichiara test sincroni e asincroni su sorgente e wheel, ma segnala che i test sul servizio ospitato restavano sospesi; questo run non ha eseguito una sessione Agents o Live reale.
Checklist pratica
- Registrare la versione corrente di openai-python e bloccare la 3.35.0 in un ambiente di staging.
- Verificare che account, modello e regione accettino realmente `service_tier="ultrafast"` prima di abilitarlo in produzione.
- Confrontare latenza, errori, limiti e costo osservato con il tier già usato, senza dedurli dal solo enum del client.
- Aprire una sessione Live controllata e verificare le sette varianti sideband attese dal proprio flusso.
- Provare `client_event_id` presente, nullo e omesso e mantenere un ramo per eventi sconosciuti.
- Eseguire un test con la versione effettiva di websockets e controllare i frame ricevuti come byte.
- Aggiornare prima un solo servizio, conservare log sanitizzati e predisporre il rollback alla versione precedente.