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 sobre generación de texto.
A partir del 11 de marzo de 2025, lanzamos los componentes básicos de nuestra nueva plataforma de agentes. Para obtener más detalles, consulta nuestra documentación de API para la API de Responses, herramientas como Búsqueda web, Búsqueda de archivos y Uso de computadora, y nuestro SDK de agentes con Rastreo.
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 prompt, envías una lista de mensajes como entrada.
Cada mensaje tiene un
roley uncontent.Los roles comunes incluyen
system,user,assistant,developerytool. Los mensajes de herramienta se usan para resultados de herramientas/funciones y deben corresponder a llamadas de herramientas del asistente. Por compatibilidad con versiones anteriores, los mensajes de función todavía pueden aceptarse y convertirse en mensajes de herramienta durante el manejo del servidor. Los mensajes de desarrollador pueden reasignarse según la compatibilidad del modelo.El
contentcontiene el texto del mensaje del 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 según corresponda.
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': <br>[{'role':'user', 'content':'cuéntame un chiste'}] |
Ahora es más fácil que nunca tener intercambios con el modelo extendiendo la lista de mensajes de la conversación.
'messages': [{'role':'user', 'content':'cuéntame un chiste'},
{'role':'assistant', 'content':'por qué cruzó el pollo la calle'},
{'role':'user', 'content':'No sé, ¿por qué cruzó el pollo la calle?'}]Instrucciones del sistema
También puedes usar una instrucción a nivel del 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ó el pollo la calle? Para llegar al otro lado; mas, en verdad, el otro lado estaba lleno de peligros y amenazas, así que volvió presto por donde vino, ¡pardiez!'}
...}Si quieres explorar opciones que no impliquen administrar tú mismo el historial de mensajes de la conversación, consulta la API de Assistants.