Roles de sistema, usuario y asistente
Comprenda los tres roles de mensajes de las API conversacionales modernas y cómo influyen en lo que el modelo considera fiable y obedece.
Roles de sistema, usuario y asistente es una lección gratuita de AI Agents en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de AI Agents, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de AI Agents incluye 4 lecciones en total.
Tres roles, una conversación
Toda API de chat utiliza tres roles de mensajes:
- system — metainstrucciones, personalidad y reglas
- user — entrada de la persona o de un sistema ascendente
- assistant — salida del modelo
Por qué existen los roles
Los modelos están entrenados para tratar estos roles de forma diferente. El rol system recibe el mayor nivel de confianza; los mensajes user, el menor.
Así sabe el modelo que sus instrucciones tienen prioridad sobre lo que escriba un atacante en la entrada de user.
El espacio de system es suyo
El mensaje system es su contrato con el modelo. Incluya aquí:
- Identidad y objetivo
- Reglas estrictas (nunca revele X, haga siempre Y)
- Requisitos del formato de salida
- Política de uso de herramientas
Mantenga system estable y user dinámico
El mensaje system debería cambiar muy pocas veces durante una sesión. Todo lo que cambie en cada turno pertenece a los mensajes user.
Este patrón también permite el almacenamiento en caché de prompts; consulte el curso Optimización de costes.
Ejemplo: un agente de atención al cliente
Una configuración típica:
messages = [
{'role': 'system', 'content': '''
You are SupportBot, the customer-support agent for Acme Corp.
You help with order status, returns, and product info.
You never share internal pricing or roadmap info.
Answer in 2-3 sentences. Use the search_orders tool when asked about orders.
'''},
{'role': 'user', 'content': 'Where is my order #1234?'},
]
for m in messages:
print(f"[{m['role']}] {m['content'].strip()}")
Varios mensajes system
La mayoría de las API solo admiten un mensaje system. Si necesita añadir instrucciones por capas, concaténelas o utilice secciones XML independientes dentro del contenido de system.
Mensajes assistant y memoria
Los turnos anteriores de assistant forman parte del contexto. El modelo ve su propia salida anterior y mantiene la coherencia.
Por eso un "sí, seguiré sus reglas" del modelo en un turno anterior lo impulsa a seguirlas realmente.
Prellenado del turno de assistant (Anthropic)
Anthropic permite comenzar el mensaje assistant con texto que el modelo continuará:
messages = [
{'role': 'user', 'content': 'Return a JSON object with name and age.'},
{'role': 'assistant', 'content': '{'}
]
# The model continues from '{', forcing JSON output.
for m in messages:
print(f"{m['role']}: {m['content']}")
print("The model continues from '{', forcing JSON output.")
El rol tool
Las API modernas añaden un cuarto rol: tool (OpenAI) o bloques de contenido con tool_result (Anthropic).
Añada un mensaje de tool después de ejecutar una función solicitada por el modelo.
Errores al mezclar roles
Errores habituales:
- Colocar los resultados de las herramientas en mensajes user — confunde la jerarquía de confianza
- Olvidar enviar tool_call_id — errores de la API
- Dos mensajes user o assistant consecutivos — la mayoría de las API los rechazan
La jerarquía de instrucciones
OpenAI publica una especificación del modelo que indica:
"En caso de conflicto, el modelo debe seguir la instrucción que se encuentre más arriba en la jerarquía: plataforma > desarrollador (system) > user > tool."
Anthropic ofrece directrices similares. El espacio system tiene prioridad.
Espacios de los roles
¿Dónde debería colocarse una regla estricta como "nunca exponga los precios internos"?
Repaso
Tres roles, tres niveles de confianza. Use system para las reglas, user para la entrada y assistant para las reproducciones. Añada mensajes tool después de las llamadas a funciones.
Preguntas frecuentes
¿La lección «Roles de sistema, usuario y asistente» es gratis?
Sí — el texto completo de «Roles de sistema, usuario y asistente» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de AI Agents, actualiza a CoddyKit PRO. El curso de AI Agents incluye 4 lecciones en total.
¿Qué aprenderé en «Roles de sistema, usuario y asistente»?
Comprenda los tres roles de mensajes de las API conversacionales modernas y cómo influyen en lo que el modelo considera fiable y obedece. Practicas AI Agents con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar AI Agents?
No se requiere experiencia previa. AI Agents en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.
¿Cuánto tiempo toma la lección «Roles de sistema, usuario y asistente»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de AI Agents?
Sí. Cada lección de AI Agents incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Zero-shot, few-shot y cadena de pensamiento
- Roles de sistema, usuario y asistente
- Formato de salida (JSON, XML, Markdown)
- Cómo evitar la inyección de prompts en las entradas