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 Chat plutôt que l’ancien format de prompt utilisé avec les complétions.
Voici comment cela fonctionne :
Au lieu d’envoyer une seule chaîne de prompt, vous envoyez en entrée une liste d’objets de message.
Chaque message possède un rôle et, généralement, un contenu.
Les rôles courants sont notamment système, utilisateur, assistant, développeur et outil. Les messages d’outil servent à transmettre 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 contenu comprend 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 de complétions élémentaires peuvent être traitées avec les complétions de Chat, comme illustré ci-dessous :
| Avant | Maintenant |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
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.