L’API Chat Completions est l’API standard à utiliser avec les plus récents modèles d’OpenAI. Vous pouvez apprendre à démarrer avec celle-ci en consultant notre guide de développement sur la génération de texte.
En date du 11 mars 2025, nous avons publié les éléments de base de notre nouvelle plateforme Agents. Pour en savoir plus, consultez notre documentation d’API pour notre API Responses, les outils comme Recherche Web, Recherche de fichiers et Utilisation de l’ordinateur, ainsi que notre SDK Agents avec Traçage.
Des invites aux messages
Pour avoir une conversation plus interactive et dynamique avec nos modèles, vous pouvez utiliser des messages sous forme de clavardage au lieu de l’ancien style d’invite utilisé avec les complétions.
Voici comment cela fonctionne :
Au lieu d’envoyer une seule chaîne comme invite, vous envoyez une liste de messages en entrée.
Chaque message a un
roleet uncontent.Les rôles courants incluent
system,user,assistant,developerettool. Les messages d’outil sont utilisés pour les résultats d’outils ou de fonctions et doivent correspondre aux appels d’outils de l’assistant. Pour assurer la rétrocompatibilité, les messages de fonction peuvent encore être acceptés et convertis en messages d’outil lors du traitement côté serveur. Les messages de développeur peuvent être remappés selon la prise en charge du modèle.Le
contentcontient le texte du message provenant du rôle.L’instruction système peut fournir des consignes générales pour la conversation
Les messages sont traités dans l’ordre où ils apparaissent dans la liste, et l’assistant répond en conséquence.
Même les requêtes Completions de base peuvent être effectuées avec Chat Completions, comme vous pouvez le voir ci-dessous :
| Avant | Maintenant | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |
Il est maintenant plus facile que jamais d’échanger avec le modèle en prolongeant la liste des messages dans la conversation.
'messages': [{'role':'user', 'content':'raconte-moi une blague'},
{'role':'assistant', 'content':'pourquoi le poulet a-t-il traversé la route'},
{'role':'user', 'content':'Je ne sais pas, pourquoi le poulet a-t-il traversé la route'}]Instructions système
Vous pouvez aussi utiliser une instruction au niveau du système pour guider le comportement du modèle tout au long de la conversation. Par exemple, en utilisant une instruction système et un message comme celui-ci
'messages': [{'role':'system', 'content':'Vous êtes un assistant qui parle comme Shakespeare.'},
{'role':'user', 'content':'raconte-moi une blague'}, produira quelque chose comme
{...
'message': {'role':'assistant',
'content':'Pourquoi le poulet a-t-il traversé la route? Pour se rendre de l’autre côté, mais en vérité, l’autre côté était plein de périls et de dangers, alors il revint vite d’où il était venu, ma foi!'}
...}Si vous voulez explorer des options qui ne vous obligent pas à gérer vous-même l’historique de conversation des messages, consultez l’API Assistants.