Roles: system, developer, user y assistant
En esta página
Los cuatro roles de mensaje
Cada mensaje enviado al punto final (endpoint) de Chat Completions incluye un campo role que determina cómo el modelo Grok lo interpreta. Comprender estos roles es esencial para estructurar tus conversaciones y obtener respuestas de calidad.
La API de xAI reconoce cuatro roles: system, developer, user y assistant. Cada uno tiene una posición y un uso específicos dentro del array de mensajes.
El rol system (o developer)
El mensaje system ocupa la primera posición en el array de mensajes. Define el comportamiento global del modelo para toda la conversación: tono, formato de respuesta, límites, personalidad, idioma, etc.
{
"role": "system",
"content": "Eres un experto en ciberseguridad. Responde siempre en inglés, de forma concisa y técnica. Si no sabes la respuesta, indícalo claramente."
}
El rol developer es un alias de system. Ambos son intercambiables en la API de xAI. OpenAI introdujo developer para reflejar mejor la intención: estas son las instrucciones del desarrollador, no las del «sistema».
Mejores prácticas para el mensaje system
- Sé específico: «Responde en un máximo de 3 frases» es más eficaz que «Sé conciso».
- Define el formato: especifica si esperas JSON, Markdown o listas con viñetas.
- Establece límites: indica qué no debe hacer el modelo.
- Proporciona contexto: aporta contexto empresarial («Eres un asistente para una clínica veterinaria»).
El rol user
Los mensajes user representan la entrada del usuario final. Son las preguntas, solicitudes o instrucciones enviadas por la persona que interactúa con tu aplicación.
{
"role": "user",
"content": "¿Cuáles son las 3 vulnerabilidades web más comunes?"
}
Un mensaje user puede aparecer en cualquier lugar de la conversación después del mensaje system. En una conversación de varios turnos, normalmente alternarás entre mensajes user y assistant.
El rol assistant
Los mensajes assistant representan las respuestas anteriores del modelo. Cuando envías un historial de conversación, cada respuesta de Grok se etiqueta con este rol.
{
"role": "assistant",
"content": "Las tres vulnerabilidades web más comunes son:\n1. Inyección SQL\n2. Cross-Site Scripting (XSS)\n3. Autenticación rota"
}
También puedes usar el rol assistant para el prompting con pocos ejemplos (few-shot prompting): inyectar ejemplos de respuestas deseadas antes del mensaje real del usuario.
{
"messages": [
{"role": "system", "content": "Clasifica el sentimiento: positivo, negativo o neutro."},
{"role": "user", "content": "¡Me encanta este producto!"},
{"role": "assistant", "content": "positivo"},
{"role": "user", "content": "El servicio de atención al cliente es deplorable."},
{"role": "assistant", "content": "negativo"},
{"role": "user", "content": "La entrega llegó ayer."}
]
}
En este ejemplo, los dos primeros intercambios user/assistant sirven de demostración. El modelo entiende el formato esperado y aplicará la misma lógica al tercer mensaje.
Estructura completa de la solicitud
Aquí tienes una solicitud típica que combina los tres roles en una conversación de varios turnos:
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{
"role": "system",
"content": "Eres un asistente docente especializado en matemáticas. Explica los conceptos paso a paso."
},
{
"role": "user",
"content": "¿Qué es una derivada?"
},
{
"role": "assistant",
"content": "Una derivada mide la tasa de cambio instantánea de una función..."
},
{
"role": "user",
"content": "Dame un ejemplo concreto."
}
]
}
El orden es siempre el mismo: system primero, luego alternancia user/assistant, siendo el último mensaje obligatoriamente user (esta es la pregunta que el modelo debe responder).
Puntos clave
- system/developer: instrucciones del desarrollador, siempre en primer lugar, definen el comportamiento global.
- user: mensajes del usuario final, desencadenan la generación de respuestas.
- assistant: respuestas anteriores del modelo, útiles para el historial y el prompting con pocos ejemplos.
- Los roles
systemydeveloperson intercambiables en la API de xAI. - El último mensaje del array debe ser un mensaje
user.