Roles: System, User y Assistant
En esta página
Comprende el sistema de roles
La API de Chat Completions de Mistral estructura cada conversación en torno a roles asignados a los mensajes. Todo mensaje enviado al modelo debe incluir un rol que defina su función en el intercambio: quién habla y con qué autoridad. Este mecanismo puede parecer un detalle técnico, pero en realidad es la columna vertebral de cualquier prompt profesional; es lo que distingue una pregunta sencilla hecha en un chat de una aplicación cuidadosamente construida.
Mistral reconoce cuatro roles distintos, cada uno con una función precisa:
| Rol | Descripción | Ejemplo |
|---|---|---|
| system | Define la personalidad, el comportamiento y el contexto general del modelo | "Eres un experto jurídico francés especializado en derecho laboral." |
| user | Contiene la solicitud o instrucción del usuario | "¿Cuáles son las obligaciones del empleador en caso de despido por causas económicas?" |
| assistant | Representa las respuestas del modelo o te permite prerellenar el inicio de una respuesta | "Estas son las 5 obligaciones principales: 1. ..." |
| tool | Devuelve el resultado de una llamada a función (function calling) | Resultado JSON de una búsqueda en base de datos |
El rol system: la base de tu prompt
El mensaje system es el primero de la lista de mensajes y actúa como una directriz permanente que influye en toda la conversación. Piensa en ello como la descripción del puesto que entregarías a un nuevo miembro del equipo antes de su primer día: define la personalidad esperada (tono, nivel de formalidad, idioma), el área de especialización preferida, las reglas sobre lo que el modelo debe o no debe hacer y el formato predeterminado de sus respuestas. Una vez escrita esta descripción, cada intercambio posterior se enmarca dentro de este contexto sin que tengas que repetirlo.
messages = [
{
"role": "system",
"content": """Eres un redactor técnico senior especializado en documentación de API.
Reglas:
- Usa inglés técnico preciso
- Incluye siempre ejemplos de código en Python
- Estructura tus respuestas con encabezados y listas
- No superes nunca las 500 palabras por respuesta"""
},
{
"role": "user",
"content": "Explica cómo gestionar los errores HTTP en una API REST."
}
]
Ten en cuenta un punto importante para tus futuras aplicaciones: el prompt de sistema lo gestiona el desarrollador, no el usuario final. El usuario de tu aplicación nunca lo ve, pero todas sus interacciones tienen lugar dentro del marco que has establecido allí. Esto lo convierte en tu palanca de control más potente.
El rol user: la solicitud concreta
El mensaje user contiene la solicitud específica. Este es el rol más intuitivo: representa lo que el humano dice al modelo, y cada nueva pregunta o instrucción del usuario se convierte en un mensaje con el rol user. Su aparente simplicidad no debe hacerte olvidar las buenas prácticas: sé preciso en tu solicitud, especifica el formato deseado si difiere del definido en el prompt de sistema y proporciona directamente en el mensaje los datos que el modelo necesita: un texto que resumir, cifras que analizar. El modelo no puede recuperar lo que no le das.
El rol assistant: guiar la respuesta
El rol assistant es el más sutil de los tres porque tiene dos usos distintos. El primero es el historial de conversación: en un intercambio de varios turnos, las respuestas anteriores del modelo se vuelven a insertar con el rol assistant para mantener el contexto. Así es como el modelo «recuerda» lo que ha dicho:
messages = [
{"role": "user", "content": "¿Cuál es la capital de Francia?"},
{"role": "assistant", "content": "La capital de Francia es París."},
{"role": "user", "content": "¿Y su población?"}
]
Sin el mensaje intermedio de assistant, el «su» en la última pregunta no se referiría a nada: la API no mantiene estado y tú reconstruyes la memoria en cada llamada.
El segundo uso es el prellenado (prefix): puedes terminar tu lista de mensajes con un mensaje assistant que contenga el inicio de la respuesta esperada. El modelo continuará desde ese punto, como si las primeras palabras ya hubieran salido de su boca. Esta es una técnica potente para controlar el formato de salida:
messages = [
{"role": "user", "content": "Enumera 3 frameworks de Python para la web."},
{"role": "assistant", "content": "```json\n[", "prefix": True}
]
Observa el campo "prefix": True: la API de Mistral lo requiere en este último mensaje assistant para tratarlo como el inicio de una respuesta.
Aquí, el modelo entiende que está escribiendo JSON y completará el array iniciado, sin preámbulos ni frases introductorias. Donde una instrucción textual «responde en JSON» podría ser ignorada, un inicio de respuesta ya escrito deja poco margen de elección.
El rol tool: resultados de funciones
El rol tool entra en juego durante la llamada a funciones (function calling). Cuando el modelo decide llamar a una función externa (una búsqueda web, una solicitud a una API, un cálculo), el resultado de esa función se le envía de vuelta como un mensaje tool, que luego integra en su respuesta. Este rol es más avanzado y se tratará en cursos dedicados; basta con recordar que existe y que complementa al trío principal.
Construye una conversación completa
Vamos ahora a ensamblar todos estos elementos en un intercambio realista, donde el prompt de sistema enmarca al assistant, donde el historial mantiene el hilo conductor y donde la última pregunta se construye naturalmente sobre lo anterior:
response = client.chat.complete(
model="mistral-large-latest",
messages=[
{
"role": "system",
"content": "Eres un asistente culinario francés. Responde de forma concisa."
},
{
"role": "user",
"content": "¿Cómo hago una vinagreta clásica?"
},
{
"role": "assistant",
"content": "Para una vinagreta clásica, mezcla 1 cucharada de mostaza, 3 cucharadas de aceite de oliva y 1 cucharada de vinagre."
},
{
"role": "user",
"content": "¿Y para una versión más ligera?"
}
]
)
Observa la arquitectura: system primero, luego una alternancia user/assistant que reproduce el flujo de la conversación. Este orden no es decorativo; es lo que permite al modelo interpretar correctamente «una versión más ligera» como una variante de la vinagreta que acaba de discutir.
Puntos clave
- El rol system enmarca el comportamiento general del modelo; es tu palanca más potente
- El rol user transporta la solicitud concreta del usuario
- El rol assistant sirve tanto de historial como de guía para el formato de respuesta
- El rol tool gestiona los resultados de las llamadas a funciones
- El orden de los mensajes es crucial: system primero, luego alternancia user/assistant