Depuis le 11 mars 2025, nous avons publié les composants de base de notre nouvelle plateforme Agents. Pour plus de détails, consultez notre documentation d’API pour notre API Responses, les outils comprenant Web Search, File Search et Computer Use, ainsi que notre SDK Agents avec Tracing. D’après vos commentaires sur la version bêta de l’API Assistants, nous avons intégré des améliorations clés à l’API Responses. Une fois la parité complète des fonctionnalités atteinte, nous annoncerons un plan d’obsolescence de l’API Assistants plus tard cette année, avec une date cible de retrait au cours du premier semestre de 2026.
FAQ
Qu’est-ce que l’API Assistants?
L’API Assistants permet aux développeurs de créer facilement de puissants assistants IA dans leurs applications. Cette API élimine le besoin de gérer l’historique des conversations et donne accès à des outils hébergés par OpenAI, comme l’interpréteur de code et la recherche de fichiers. L’API prend aussi en charge un appel de fonction amélioré pour les outils tiers.
Puis-je encore utiliser la version bêta v1 de l’API Assistants ?
Non. Depuis le 18 décembre 2024, les utilisateurs n’ont plus accès à la version v1 bêta de l’API Assistants. Nous prenons actuellement en charge uniquement la version v2. Consultez ce guide de migration pour convertir vos appels d’API de la version v1 à la version v2.
Comment y accéder ?
L’API Assistants est accessible à toute personne ayant un compte d’API OpenAI, mais elle est obsolète et sera supprimée en août 2026. Pour les nouveaux projets, utilisez plutôt l’API Responses. Si vous utilisez déjà l’API Assistants, planifiez votre migration vers l’API Responses. Vous pouvez toujours accéder aux assistants existants dans le Playground Assistants tant que l’API demeure disponible.
Qu’est-ce qu’un assistant?
Un assistant représente une IA conçue pour un usage précis qui utilise les modèles d’OpenAI et peut accéder à des fichiers, maintenir des fils de discussion persistants et appeler des outils.
Qu’est-ce qu’un fil de discussion?
Un fil de discussion est une session de conversation entre un assistant et un utilisateur. Les fils de discussion simplifient le développement d’applications en stockant l’historique des messages et en le tronquant lorsque la conversation devient trop longue pour la fenêtre de contexte du modèle.
Qu’est-ce que l’outil de recherche de fichiers?
L’outil file_search intègre d’emblée plusieurs pratiques exemplaires de récupération pour vous aider à extraire les données pertinentes de vos fichiers afin d’enrichir les réponses du modèle.
Par défaut, l’outil file_search utilise les paramètres suivants :
Taille des fragments : 800 jetons
Chevauchement des fragments : 400 jetons
Modèle de plongement vectoriel : text-embedding-3-large à 256 dimensions
Nombre maximal de fragments ajoutés au contexte : 20
Quelles sont les restrictions relatives au téléversement de fichiers?
Les restrictions relatives au téléversement d’un fichier sont les suivantes :
512 Mo par fichier
5 millions de jetons par fichier
10 000 fichiers par magasin vectoriel
1 magasin vectoriel par assistant
1 magasin vectoriel par fil de discussion
La limite de stockage totale pour chaque projet d’une organisation est de 100 Go.
Quelles sont les limites de l’outil de recherche de fichiers?
Voici quelques limites connues que nous nous efforçons de lever dans les prochains mois :
Il n’est actuellement pas possible de modifier les paramètres de découpage, de plongement vectoriel ou de récupération.
L’analyse des images dans les documents n’est pas prise en charge.
La récupération dans les formats de fichiers structurés (comme les fichiers .csv ou .jsonl) n’est pas prise en charge. Consultez les types de fichiers pris en charge.
Quelles sont les limites de débit de l’API Assistants?
Les limites de débit de l’API Assistants ne sont pas liées au niveau d’utilisation ni au modèle. Il existe plutôt des limites par défaut selon le type de requête, à quelques exceptions près :
GET : 1 000 requêtes par minute
POST : 300 requêtes par minute
DELETE : 300 requêtes par minute
Quelle est la tarification de l’interpréteur de code dans l’API?
L’interpréteur de code est facturé à 0,03 $ par session. Si votre assistant appelle l’interpréteur de code simultanément dans deux fils de discussion différents, cela crée deux sessions de l’interpréteur de code (2 * 0,03 $). Chaque session est active par défaut pendant une heure. Vous ne payez donc ces frais qu’une seule fois si votre utilisateur continue de donner des instructions à l’interpréteur de code dans le même fil de discussion pendant une heure au maximum.
Quelle est la tarification de la recherche de fichiers dans l’API?
La recherche de fichiers est facturée à 0,10 $/Go de stockage en magasin vectoriel par jour (le premier Go de stockage est gratuit). La taille du magasin vectoriel est calculée une fois votre fichier analysé, découpé et converti en vecteurs.
Tous les magasins vectoriels créés avant le 17 avril 2024 seront gratuits jusqu’à la fin de 2024, après quoi ils seront soit :
Facturés aux tarifs en vigueur (actuellement 0,10 $/Go/jour) s’ils ont été utilisés au moins une fois dans une exécution créée après le 17 avril 2024.
Supprimés s’ils n’ont été utilisés dans aucune exécution entre le 17 avril 2024 et le 31 décembre 2024 — ceci pour éviter de vous facturer des magasins vectoriels que vous auriez créés avant l’annonce de ce changement de tarification, mais jamais utilisés.
Y a-t-il une limite au nombre d’assistants que je peux créer ?
Il n’y a aucune limite au nombre d’assistants qu’une organisation peut créer.
La diffusion en continu est-elle disponible dans l’API?
Oui, la diffusion en continu est disponible dans l’API Assistants.
Le mode JSON est-il disponible dans l’API Assistants?
Oui, le mode JSON est disponible dans l’API Assistants via le paramètre response_format des objets Assistants ou Run.
L’API Assistants gérera-t-elle aussi les requêtes d’appel de fonctions tierces?
Non. Même si l’appel de fonction permet au modèle de sélectionner des outils et de formater les requêtes qui leur sont destinées, l’exécution des appels aux outils tiers n’est pas gérée par OpenAI.
Comment les données que j’envoie à OpenAI sont-elles traitées?
Comme pour le reste de notre plateforme, les données et les fichiers transmis à l’API OpenAI ne sont jamais utilisés pour entraîner nos modèles, et vous pouvez supprimer vos données quand vous le souhaitez. Les données téléversées dans l’API Assistants sont conservées indéfiniment, jusqu’à ce qu’un utilisateur les supprime manuellement.
DALL-E est-il disponible via l’API Assistants?
Pour le moment, DALL-E n’est pas disponible.
Existe-t-il une interface utilisateur pour l’API Assistants ?
Vous pouvez consulter le Playground pour l’API Assistants. Assurez-vous d’être dans la vue Assistants de la barre latérale gauche et d’utiliser un modèle compatible avec les outils que vous souhaitez activer.
Quelle est la limite de caractères pour les instructions de l’assistant dans l’API Assistants?
Le champ des instructions de l’assistant a une longueur maximale de 256 000 caractères.
Je reçois une erreur du type « Le serveur a rencontré une erreur lors du traitement de votre requête. Nous en sommes désolés! Vous pouvez réessayer votre requête ou nous contacter via notre centre d’assistance à help.openai.com si l’erreur persiste. » Que dois-je faire?
Si vous recevez cette erreur, cela peut signifier que votre invite n’est pas configurée correctement. Si vos nouvelles tentatives échouent, voici quelques pistes à essayer :
restructurez votre invite pour traiter comme des fonctions toutes les commandes qui s’y apparentent
ajoutez chaque commande de votre invite en tant que fonction à tools
Pourquoi mon outil de recherche de fichiers ne fonctionne-t-il pas bien?
Lorsque vous utilisez l’outil de recherche de fichiers, nous vous recommandons de définir max_prompt_tokens à au moins 20 000. Pour les conversations plus longues ou les interactions multiples avec la recherche de fichiers, envisagez d’augmenter cette limite à 50 000 ou, idéalement, de supprimer complètement les limites max_prompt_tokens pour obtenir des résultats de la meilleure qualité possible.
Comment puis-je transmettre mes commentaires?
Nous serions ravis de recevoir vos commentaires sur notre forum des développeurs, via le centre d’assistance à help.openai.com ou sur Twitter @OpenAIDevs.