Chat Completions es la API estándar para usar con los modelos más recientes de OpenAI. Puedes aprender cómo empezar con ella usando nuestra guía para desarrolladores de generación de texto.
A partir del 11 de marzo de 2025, lanzamos los componentes básicos de nuestra nueva plataforma de Agents. Para más detalles, consulta nuestra documentación de la API para nuestra Responses API, las Tools, incluidas Web Search, File Search y Computer Use, y nuestro Agents SDK con Tracing.
De prompts a mensajes
Para tener 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 tu 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 tres valores: 'system', 'user' o 'assistant'
El 'content' contiene el texto del mensaje según el role.
La instrucción del system 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 assistant responde en consecuencia.
Incluso las solicitudes básicas de Completions se pueden realizar mediante 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 tener un ida y vuelta con el modelo extendiendo la lista de mensajes en la conversación.
'messages': [{'role':'user', 'content':'cuéntame un chiste'},
{'role':'assistant', 'content':'por qué cruzó la gallina la calle'},
{'role':'user', 'content':'No lo sé, ¿por qué cruzó la gallina la calle?'}]Instrucciones del system
También puedes usar una instrucción de nivel system para guiar el comportamiento del modelo durante toda la conversación. Por ejemplo, usar una instrucción del system 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 gallina el camino? Para llegar al otro lado; mas, en verdad, el otro lado estaba lleno de peligro y amenaza, así que presto regresó de donde vino, ¡vive Dios!'}
...}Si quieres explorar opciones que no impliquen tener que gestionar por tu cuenta el historial de la conversación de mensajes, revisa la Assistants API.