OpenAI
Questa pagina è stata tradotta automaticamente. Visualizza l'articolo originale in inglese.

In che modo il lancio di Assistants API v2 influisce sui miei Assistants lanciati con API v1?

Implicazioni per Playground, costi e migrazione

Aggiornato: 2 hours ago

A partire dall’11 marzo 2025, abbiamo rilasciato i componenti di base della nostra nuova piattaforma Agents. Per i dettagli, consulta la nostra documentazione API per la Responses API, gli strumenti tra cui Ricerca web, Ricerca file e Uso del computer, e il nostro Agents SDK con tracciamento.

  • Nessun aggiornamento automatico: gli Assistants, i Threads e i Runs attuali non vengono migrati automaticamente alla v2. Rimangono accessibili e operativi tramite l'API v1, a meno che tu non scelga di migrarli manualmente.

  • Accesso a entrambe le versioni: puoi accedere senza limitazioni sia alla versione v1 sia alla v2 dell'API. Ciò significa che puoi continuare a usare la v1 per gli assistenti esistenti oppure scoprire le nuove funzionalità e i miglioramenti offerti dalla v2.

  • Differenze nell'utilizzo dei token: il consumo di token può variare tra la v1 e la v2, in particolare per strumenti come file_search e retrieval. Sebbene lo strumento file_search della v2 consumi in genere meno token rispetto allo strumento retrieval della v1, se lo desideri puoi continuare a usare il precedente strumento retrieval con l'header di versione v1.

  • Opzioni di migrazione: l'interfaccia di Playground e le versioni aggiornate degli SDK usano la versione v2 dell'API, mentre le richieste all'API Assistants devono includere l'header OpenAI-Beta: assistants=v2. L'API Assistants v1 è deprecata; tutte le integrazioni che usano ancora la v1 devono essere migrate alla v2. Per ulteriori informazioni sulla migrazione da Assistants v1 a v2, consulta questa guida alla migrazione.

Questo articolo è stato utile?