Chat Completions es la API estándar que se usa con los modelos más recientes de OpenAI. Puedes aprender a empezar a usarla con nuestra guía para desarrolladores sobre generación de texto.
Desde el 11 de marzo de 2025, hemos publicado los componentes básicos de nuestra nueva plataforma de agentes. Para obtener más información, consulta nuestra documentación de la API para nuestra API de Responses, herramientas como Web Search, File Search y Computer Use, y nuestro Agents SDK con Tracing.
De prompts a mensajes
Para mantener una conversación más interactiva y dinámica con nuestros modelos, puedes usar mensajes en formato de chat en lugar del antiguo formato de prompt que se empleaba con Completions.
Así funciona:
En lugar de enviar una única cadena de prompt, envías como entrada una lista de objetos de mensaje.
Cada mensaje tiene un role y, por lo general, un content.
Entre los roles habituales se incluyen system, user, assistant, developer y tool. Los mensajes de herramienta se utilizan para los resultados de herramientas o funciones y deben corresponderse con llamadas a herramientas del asistente. Para mantener la compatibilidad con versiones anteriores, es posible que los mensajes de función aún se acepten y se conviertan en mensajes de herramienta durante el procesamiento en el servidor. Los mensajes de desarrollador pueden reasignarse en función de la compatibilidad del modelo.
El campo content contiene el texto del mensaje enviado por el rol.
La instrucción del sistema puede proporcionar directrices generales para la conversación
Los mensajes se procesan en el orden en que aparecen en la lista y el asistente responde en consecuencia.
Incluso las solicitudes básicas de Completions pueden procesarse mediante Chat Completions, como se muestra a continuación:
| Antes | Ahora |
|---|---|
'prompt' : 'tell me a joke' | 'messages': [{'role':'user', 'content':'tell me a joke'}] |
Ahora es más fácil que nunca mantener un diálogo con el modelo: basta con ampliar la lista de mensajes de la conversación.
'messages': [{'role':'user', 'content':'cuéntame un chiste'},
{'role':'assistant', 'content':'por qué cruzó la carretera la gallina'},
{'role':'user', 'content':'No lo sé, ¿por qué cruzó la carretera la gallina?'}]Instrucciones del sistema
También puedes usar una instrucción a nivel de sistema para guiar el comportamiento del modelo durante toda la conversación. Por ejemplo, usando una instrucción del sistema y un mensaje como este
'messages': [{'role':'system', 'content':'Eres un asistente que habla como Shakespeare.'},
{'role':'user', 'content':'cuéntame un chiste'}, dará como resultado algo como
{...
'message': {'role':'assistant',
'content':'¿Por qué cruzó la carretera la gallina? Para llegar al otro lado, pero en verdad, el otro lado estaba lleno de peligros y riesgos, así que regresó rápidamente de donde vino, ¡pardiez!'}
...}Si quieres explorar opciones que no impliquen tener que gestionar tú mismo el historial de mensajes de la conversación, consulta la API de Assistants.