Chat Completions est l’API standard à utiliser avec les derniers modèles d’OpenAI. Vous pouvez découvrir comment démarrer avec celle-ci dans notre guide de développement pour la génération de texte.
Depuis le 11 mars 2025, nous avons publié les briques de base de notre nouvelle plateforme Agents. Pour plus de détails, consultez notre documentation d’API pour notre API Responses, les outils, notamment Recherche Web, Recherche de fichiers et Utilisation de l’ordinateur, ainsi que notre SDK Agents avec Traçage.
Des prompts aux messages
Pour avoir une conversation plus interactive et dynamique avec nos modèles, vous pouvez utiliser des messages au format de chat au lieu de l’ancien style de prompt utilisé avec les completions.
Voici comment cela fonctionne :
Au lieu d’envoyer une seule chaîne comme prompt, vous envoyez une liste de messages en entrée.
Chaque message possède 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/fonctions et doivent correspondre aux appels d’outils de l’assistant. Pour 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 développeur peuvent être remappés selon la prise en charge du modèle.Le champ
contentcontient le texte du message associé au rôle.L’instruction système peut fournir des instructions de haut niveau 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 exécutées via Chat Completions, comme vous pouvez le voir ci-dessous :
| Avant | Maintenant | | 'prompt' : 'raconte-moi une blague' | 'messages': <br>[{'role':'user', 'content':'raconte-moi une blague'}] |
Il est désormais plus facile que jamais d’échanger avec le modèle en allongeant la liste des messages de 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 également utiliser une instruction au niveau du système pour guider le comportement du modèle tout au long de la conversation. Par exemple, avec 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'}, donnera quelque chose comme
{...
'message': {'role':'assistant',
'content':'Pourquoi le poulet a-t-il traversé la route ? Pour aller de l’autre côté, mais en vérité, l’autre côté était plein de périls et de dangers ; il revint donc prestement d’où il était venu, ma foi !'}
...}Si vous souhaitez explorer des options qui ne vous obligent pas à gérer vous-même l’historique de conversation des messages, consultez l’API Assistants.