Chat Completions és l'API estàndard per fer servir els models més recents d'OpenAI. Pots aprendre a començar a fer-la servir amb la nostra guia per a desenvolupadors sobre generació de text.
A data de l'11 de març de 2025, hem llançat els components bàsics de la nostra nova plataforma d'agents. Per obtenir més detalls, consulta la nostra documentació de l'API per a l'API de Responses, les eines, com ara Cerca web, Cerca de fitxers i Ús de l'ordinador, i el nostre SDK d'agents amb traçat.
D'indicacions a missatges
Per mantenir una conversa més interactiva i dinàmica amb els nostres models, podeu utilitzar missatges en format de xat en lloc de l'antic format d'indicacions utilitzat amb les completions.
Així és com funciona:
En lloc d'enviar una única cadena d'indicació, envieu com a entrada una llista d'objectes de missatge.
Cada missatge té un role i, normalment, un content.
Els rols habituals inclouen system, user, assistant, developer i tool. Els missatges d'eina s'utilitzen per als resultats d'eines o funcions i han de correspondre a crides d'eina de l'assistent. Per compatibilitat amb versions anteriors, els missatges de funció encara es poden acceptar i convertir en missatges d'eina durant el processament al servidor. Els missatges de desenvolupador es poden reassignar en funció de la compatibilitat del model.
El content conté el text del missatge enviat pel rol.
La instrucció del sistema pot proporcionar instruccions generals per a la conversa
Els missatges es processen en l'ordre en què apareixen a la llista i l'assistent respon en conseqüència.
Fins i tot les sol·licituds bàsiques de Completions es poden completar mitjançant Chat Completions, com podeu veure a continuació:
| Abans | Ara |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Ara és més fàcil que mai mantenir un diàleg amb el model: només cal ampliar la llista de missatges de la conversa.
'messages': [{'role':'user', 'content':'explica'm un acudit'},
{'role':'assistant', 'content':'per què va creuar el pollastre la carretera'},
{'role':'user', 'content':'No ho sé, per què va creuar el pollastre la carretera'}]Instruccions del sistema
També pots fer servir una instrucció de nivell de sistema per guiar el comportament del model durant tota la conversa. Per exemple, fent servir una instrucció de sistema i un missatge com aquest
'messages': [{'role':'system', 'content':'Ets un assistent que parla com Shakespeare.'},
{'role':'user', 'content':'explica'm un acudit'}, donarà com a resultat una cosa com ara
{...
'message': {'role':'assistant',
'content':'Per què va creuar el pollastre la carretera? Per arribar a l'altra banda, però, en veritat, l'altra banda era plena de perills i riscos, així que va tornar ràpidament d'on havia vingut, certament!'}
...}Si vols explorar opcions que no impliquin haver de gestionar tu mateix l'historial de la conversa de missatges, consulta l'API d'Assistants.