Chat Completions es la API estándar para usar con los modelos más recientes de OpenAI. Puedes aprender a empezar a usarla con nuestra guía para desarrolladores de generación de texto.
A fecha de 11 de marzo de 2025, hemos lanzado los componentes básicos de nuestra nueva plataforma de agentes. Para más detalles, consulta nuestra documentación de la API para nuestra API de Responses, herramientas como Búsqueda web, Búsqueda de archivos y Uso del ordenador, y nuestro SDK de Agents 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 estilo de prompt heredado que se usaba con completions.
Así es como funciona:
En lugar de enviar una sola cadena como prompt, envías una lista de mensajes como entrada.
Cada mensaje de la lista tiene dos propiedades: role y content.
El 'role' puede tomar uno de estos tres valores: 'system', 'user' o 'assistant'
El 'content' contiene el texto del mensaje de ese rol.
La instrucción del sistema puede dar instrucciones de alto nivel 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 se pueden completar a través de Chat Completions, como puedes ver a continuación:
| Antes | Ahora |
'prompt' : 'cuéntame un chiste' | 'messages': [{'role':'user', 'content':'cuéntame un chiste'}] |
Ahora es más fácil que nunca mantener intercambios con el modelo ampliando 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, usar 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 conversaciones de mensajes, consulta la API de Assistants.