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 tenir una conversa més interactiva i dinàmica amb els nostres models, podeu fer servir missatges en format de xat en lloc de l’estil heretat basat en indicacions que s’utilitzava amb les complecions.
Així és com funciona:
En lloc d’enviar una única cadena d’indicació, envieu una llista d’objectes de missatge com a entrada.
Cada missatge té un
rolei, normalment, uncontent.Els rols habituals inclouen
system,user,assistant,developeritool. Els missatges d’eina s’utilitzen per als resultats d’eines/funcions i han de correspondre a crides a eines de l’assistent. Per compatibilitat amb versions anteriors, els missatges de funció encara es poden acceptar i convertir en missatges d’eina en el processament del servidor. Els missatges de desenvolupador es poden reassignar segons el suport del model.El
contentconté el text del missatge enviat pel rol.La instrucció del sistema pot proporcionar instruccions d’alt nivell 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': <br>[{'role':'user', 'content':'tell me a joke'}] |
Ara és més fàcil que mai mantenir intercanvis amb el model ampliant 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.