A partire dall’11 marzo 2025, abbiamo rilasciato i componenti fondamentali della nostra nuova piattaforma Agents. Per i dettagli, consulta la documentazione API per la nostra Responses API, gli strumenti tra cui Web Search, File Search e Computer Use, nonché il nostro Agents SDK con Tracing. In base al tuo feedback sulla beta dell’API Assistants, abbiamo integrato miglioramenti chiave nella Responses API. Dopo aver raggiunto la piena parità di funzionalità, annunceremo un piano di deprecazione dell’API Assistants più avanti quest’anno, con una data di dismissione prevista nella prima metà del 2026.
Domande frequenti
Che cos'è l'API Assistants?
L'API Assistants consente agli sviluppatori di creare facilmente potenti assistenti IA all'interno delle proprie app. Questa API elimina la necessità di gestire la cronologia delle conversazioni e offre l'accesso a strumenti ospitati da OpenAI, come Code Interpreter e File Search. L'API supporta anche una chiamata di funzioni migliorata per gli strumenti di terze parti.
Posso ancora utilizzare la versione beta v1 dell'API Assistants?
No. Dal 18 dicembre 2024, gli utenti non hanno più accesso alla versione v1 beta dell'API Assistants. Attualmente supportiamo solo la versione v2. Consulta questa guida alla migrazione per convertire le chiamate API dalla versione v1 alla v2.
Come posso accedervi?
L’API Assistants è disponibile per chiunque abbia un account API OpenAI, ma è deprecata e verrà rimossa ad agosto 2026. Per i nuovi progetti, usa invece la Responses API. Se usi già l’API Assistants, pianifica la migrazione alla Responses API. Puoi ancora accedere agli assistenti esistenti nell’Assistants Playground finché l’API rimane disponibile.
Che cos'è un assistente?
Un assistente è un'IA creata per uno scopo specifico che usa i modelli di OpenAI e può accedere ai file, mantenere thread persistenti e chiamare strumenti.
Che cos'è un thread?
Un thread è una sessione di conversazione tra un assistente e un utente. I thread semplificano lo sviluppo delle applicazioni memorizzando la cronologia dei messaggi e troncandola quando la conversazione supera la lunghezza del contesto del modello.
Che cos'è lo strumento File Search?
Lo strumento file_search integra diverse buone pratiche di recupero delle informazioni per aiutarti a estrarre dai file i dati pertinenti con cui arricchire le risposte del modello.
Per impostazione predefinita, lo strumento file_search usa le seguenti impostazioni:
Dimensione dei blocchi: 800 token
Sovrapposizione tra i blocchi: 400 token
Modello di embedding: text-embedding-3-large a 256 dimensioni
Numero massimo di blocchi aggiunti al contesto: 20
Quali sono i limiti per il caricamento dei file?
I limiti per il caricamento dei file sono:
512 MB per file
5 milioni di token per file
10.000 file per archivio vettoriale
1 archivio vettoriale per assistente
1 archivio vettoriale per thread
Il limite complessivo di archiviazione per ogni progetto di un'organizzazione è di 100 GB.
Quali sono i limiti dello strumento File Search?
Ci sono alcuni limiti noti che stiamo lavorando a superare nei prossimi mesi:
Al momento non è possibile modificare le impostazioni di suddivisione in blocchi, embedding o recupero delle informazioni.
L'analisi delle immagini all'interno dei documenti non è supportata.
Il recupero di informazioni da file in formati strutturati (come .csv o .jsonl) non è supportato. Consulta i tipi di file supportati.
Quali sono i limiti di frequenza dell'API Assistants?
I limiti di frequenza dell'API Assistants non dipendono dal livello di utilizzo e dal modello. Sono invece previsti limiti predefiniti per tipo di richiesta, con un paio di eccezioni:
GET: 1000 RPM
POST: 300 RPM
DELETE: 300 richieste al minuto
Quanto costa Code Interpreter nell'API?
Code Interpreter costa 0,03 USD a sessione. Se il tuo assistente chiama Code Interpreter contemporaneamente in due thread diversi, vengono create due sessioni di Code Interpreter (2 × 0,03 USD). Per impostazione predefinita, ogni sessione rimane attiva per un'ora: pagherai quindi questa tariffa una sola volta se il tuo utente continua a dare istruzioni a Code Interpreter nello stesso thread per un massimo di un'ora.
Quanto costa File Search nell'API?
File Search costa 0,10 USD al giorno per GB di spazio occupato nell'archivio vettoriale (il primo GB è gratuito). La dimensione dell'archivio vettoriale viene calcolata dopo che il file è stato analizzato, suddiviso in blocchi e convertito in embedding.
Tutti gli archivi vettoriali creati prima del 17 aprile 2024 saranno gratuiti fino alla fine del 2024, dopodiché saranno:
Fatturati alle tariffe in vigore (attualmente 0,10 USD/GB/giorno) se sono stati usati almeno una volta in un Run creato dopo il 17 aprile 2024.
Eliminati se non sono stati usati in nessun Run tra il 17 aprile 2024 e il 31 dicembre 2024, per evitare addebiti per archivi vettoriali che potresti aver creato prima dell'annuncio di questa modifica dei prezzi ma che non hai mai usato.
Esiste un limite al numero di assistenti che posso creare?
Non esiste un limite al numero di assistenti che un’organizzazione può creare.
Lo streaming è disponibile nell'API?
Sì, lo streaming è disponibile nell'API Assistants.
La modalità JSON è disponibile nell'API Assistants?
Sì, la modalità JSON è disponibile nell'API Assistants tramite il parametro response_format degli oggetti Assistants o Run.
L'API Assistants gestirà anche le richieste di chiamata a funzioni di terze parti?
No. La chiamata di funzioni consente al modello di selezionare strumenti e formattare le relative richieste, ma l'esecuzione delle chiamate a strumenti di terze parti non è gestita da OpenAI.
Come vengono gestiti i dati che invio a OpenAI?
Come nel resto della nostra piattaforma, i dati e i file inviati all'API OpenAI non vengono mai usati per addestrare i nostri modelli e puoi eliminare i tuoi dati in qualsiasi momento. I dati caricati nell'API Assistants vengono conservati a tempo indeterminato finché un utente non li elimina manualmente.
DALL-E è disponibile tramite l'API Assistants?
Al momento, DALL-E non è disponibile.
Esiste un’interfaccia utente per l’API Assistants?
Puoi consultare il Playground per l’API Assistants. Assicurati di essere nella vista Assistants nella barra laterale sinistra e di usare un modello compatibile con gli strumenti che desideri attivare.
Qual è il limite di caratteri per le istruzioni dell'assistente nell'API Assistants?
Il campo delle istruzioni dell'assistente ha una lunghezza massima di 256.000 caratteri.
Ricevo un errore come “Si è verificato un errore sul server durante l'elaborazione della tua richiesta. Ci dispiace! Puoi riprovare a inviare la richiesta o contattarci tramite il nostro Centro assistenza su help.openai.com se l'errore persiste. ” Cosa devo fare?
Se ricevi questo errore, il tuo prompt potrebbe non essere configurato correttamente. Se continui a riprovare a inviare la richiesta senza successo, ecco cosa puoi fare:
ristruttura il prompt in modo che tutti i comandi simili a funzioni vengano trattati come funzioni
aggiungi ogni comando presente nel prompt a tools come funzione
Perché lo strumento File Search non funziona bene?
Quando usi lo strumento File Search, ti consigliamo di impostare max_prompt_tokens su un valore non inferiore a 20.000. Per conversazioni più lunghe o più interazioni con File Search, valuta la possibilità di aumentare questo limite a 50.000 o, idealmente, di rimuovere del tutto i limiti di max_prompt_tokens per ottenere risultati della migliore qualità.
Come posso inviare un feedback?
Ci farebbe piacere ricevere il tuo feedback sul nostro Forum per sviluppatori, tramite il Centro assistenza su help.openai.com o su Twitter all'account @OpenAIDevs.