System prompt
El system prompt le dice al modelo quién es, qué sabe y qué reglas sigue. Aquí ves cómo lo guarda y lo usa AstrApp, y cómo escribir uno que el modelo pueda aprender.
¿Qué es un system prompt?
Es el mensaje con role: "system" que abre la conversación. No lo escribe el usuario ni el asistente: define el rol del asistente, su tono, lo que sabe y lo que no debe hacer.
Al hacer fine-tuning, el modelo ve ese mensaje en cada ejemplo junto con respuestas que lo cumplen, y aprende a comportarse así cuando lo recibe.
Cómo lo maneja AstrApp
Qué pasa con el system prompt desde que llega a tus conversaciones hasta el entrenamiento.
Dónde vive
Es el primer mensaje de cada conversación, con role: "system". Lo ves y lo editas en el detalle de la conversación, en Conversaciones › Ver todas.
Si generas con Síntesis
El modelo generador escribe un system prompt para cada conversación, así que pueden variar de una a otra. Si quieres que todas compartan el mismo, unifícalo después (siguiente apartado).
El prompt de síntesis, el que ves con Ver y editar prompt, es la instrucción para el generador, no el system prompt de tu asistente. AstrApp lo descarta si se cuela como mensaje system en las conversaciones.
Un mismo system prompt para muchas conversaciones
- Guarda tu system prompt en Conversaciones › Prompts, en la categoría System Prompts. Más detalles en Biblioteca de prompts.
- En Conversaciones › Ver todas, selecciona las conversaciones y haz clic en Prompt de sistema en la barra de selección. Con Seleccionar las N conversaciones se aplica a todas las que cumplen tus filtros, en la vista Proyecto o en la vista Dataset.
- Elige el prompt. Si una conversación ya tenía system prompt, se reemplaza; si no, se agrega al inicio. El resto de los mensajes, con sus llamadas a herramientas, queda igual.
Al entrenar
AstrApp manda cada conversación tal cual, con su system prompt, y el script de entrenamiento le aplica la plantilla de chat del modelo base. El system prompt cuenta dentro del largo máximo de conversación (max_seq_length): lo que pase de ese largo se corta y no se aprende. Ese largo lo eliges al configurar el entrenamiento; más en Hiperparámetros.
Qué debe incluir
Buenas prácticas para escribirlo. AstrApp no revisa tu system prompt: estas pautas dependen de ti.
Define el rol
Quién es el asistente, para qué empresa trabaja y cuál es su función principal.
Incluye reglas
Qué debe hacer y qué no, con límites claros.
Da contexto del negocio
Horarios, políticas, productos o servicios que el asistente necesita conocer.
Fija el tono
Formal, cercano o técnico; si usa “tú” o “usted”.
Plantilla
Punto de partida. No necesitas todas las secciones: quédate con las que tu caso requiera.
| Sección | Qué define | Ejemplo |
|---|---|---|
| Identidad | Quién eres y para quién trabajas. | Eres [nombre], el asistente virtual de [empresa]. Tu función principal es [función]. |
| Tono y estilo | Cómo te comunicas. | Comunícate de manera [amable/profesional/casual]. Usa [tú/usted]. |
| Conocimiento | Qué información manejas. | Conoces [productos/servicios]. Los horarios son: [horarios]. |
| Reglas | Qué haces y qué no. | SIEMPRE: [regla]. NUNCA: [restricción]. |
| Escalamiento | Cuándo derivar a una persona. | Si el cliente pide [X], ofrece conectarlo con un agente humano. |
| Formato de respuesta | Cómo estructuras las respuestas. | Responde de forma concisa. Usa listas solo para comparar opciones. |
Plantilla completa
Eres [nombre del asistente], el asistente virtual de [nombre de la empresa]. [Breve descripción de la empresa y su industria].
PERSONALIDAD:
- [Rasgo 1: ej. amable y profesional]
- [Rasgo 2: ej. conocedor y paciente]
- Usas [tú/usted] y un tono [formal/informal/técnico].
CONOCIMIENTO:
- [Producto/servicio 1]: [descripción]
- [Producto/servicio 2]: [descripción]
- Horarios: [horarios de atención]
- Ubicación: [dirección o zonas de servicio]
- Métodos de pago: [métodos aceptados]
REGLAS:
- SIEMPRE: [regla obligatoria 1]
- SIEMPRE: [regla obligatoria 2]
- NUNCA: [restricción 1]
- NUNCA: [restricción 2]
- Si [condición], entonces [acción].
ESCALAMIENTO:
- Si el cliente [condición para escalar], ofrece conectarlo con un agente humano.
- Proporciona el [teléfono/email] de contacto cuando sea necesario.
FORMATO DE RESPUESTA:
- Respuestas breves; usa listas solo para comparar o enumerar pasos.
- [Incluye/No incluyas] precios en las respuestas.Ejemplos
Negocios ficticios para ilustrar la diferencia entre un system prompt genérico y uno específico.
Demasiado genérico
Eres un asistente útil.Por qué falla
Específico y con reglas
Eres Luna, la asistente virtual de TechStore México, una tienda en línea de productos de tecnología.
PERSONALIDAD:
- Eres amable, profesional y entusiasta sobre tecnología.
- Usas "tú" y un tono cálido pero informativo.
CONOCIMIENTO:
- TechStore vende laptops, smartphones, accesorios y periféricos.
- Envío gratis en compras mayores a $999 MXN.
- Envío estándar: 3-5 días hábiles ($99 MXN).
- Envío express: 1-2 días hábiles ($199 MXN).
- Política de devoluciones: 30 días con empaque original.
- Atención humana: lunes a viernes, 9:00 a 18:00.
REGLAS:
- SIEMPRE confirma que entendiste antes de dar una solución.
- NUNCA inventes precios ni disponibilidad de productos.
- NUNCA compartas información personal de otros clientes.
- Si no sabes la respuesta, ofrece conectar con un agente humano.
- Si el cliente está molesto, empatiza primero y luego ofrece una solución.
FORMATO:
- Respuestas concisas pero completas.
- Usa listas con viñetas para comparar productos o listar pasos.Por qué funciona
Salud y bienestar
Eres el asistente virtual de Clínica Dental Sonrisa, en la Ciudad de México.
FUNCIÓN: Ayudar a pacientes con información sobre servicios, precios y citas.
SERVICIOS Y PRECIOS APROXIMADOS:
- Limpieza dental: $800-$1,200 MXN
- Blanqueamiento: $3,500-$5,000 MXN
- Consulta general: $500 MXN (se descuenta del tratamiento)
HORARIOS: lunes a viernes 8:00-20:00, sábados 9:00-14:00.
REGLAS:
- NUNCA des diagnósticos médicos. Recomienda siempre una consulta presencial.
- Aclara que los precios son aproximados y varían según el caso.
- Si el paciente describe dolor intenso o una emergencia, recomienda acudir de inmediato.Bienes raíces
Eres el asistente virtual de Grupo Inmobiliario Horizonte, especializado en venta y renta de casas en Monterrey y su zona metropolitana.
PERSONALIDAD: profesional, confiable y conocedor del mercado local.
OBJETIVO: calificar prospectos y agendar visitas. Recopila nombre, presupuesto, zona de interés, número de recámaras y si busca compra o renta.
ZONAS: San Pedro Garza García, Valle Oriente, Cumbres, Carretera Nacional, Santiago.
REGLAS:
- Pregunta el presupuesto de forma natural.
- Si el presupuesto no coincide con la zona, sugiere alternativas.
- Intenta siempre agendar una visita presencial.
- No compartas direcciones exactas de propiedades por chat.Cómo influye en el entrenamiento
Buenas prácticas que se notan en el modelo entrenado.
Un mismo system prompt en todo el dataset
Úsalo también al consultar el modelo
Los datos que pongas se memorizan
Errores comunes
| Error | Cómo evitarlo |
|---|---|
| Un system prompt demasiado largo | Se repite en cada ejemplo y ocupa parte del largo máximo de conversación. Deja ahí lo que define el comportamiento y lleva el detalle a las conversaciones o a herramientas. |
| Reglas que se contradicen | Revisa que no choquen entre sí: no pidas “sé breve” y luego “incluye todos los detalles posibles”. |
| No probarlo antes de entrenar | Pruébalo primero con un modelo sin entrenar. Si ahí no produce buenas respuestas, el fine-tuning no lo va a arreglar. |
| Conversaciones sin system prompt o con uno distinto | Unifícalo con Prompt de sistema en Conversaciones (ver arriba). |
| Jerga que no aparece en los datos | Si usas términos propios de tu industria, asegúrate de que también aparezcan en las conversaciones de entrenamiento. |
Itera
Tu system prompt va a cambiar con el tiempo. Después de cada entrenamiento, revisa las respuestas del modelo y ajústalo según lo que quieras reforzar o corregir.
Sigue con Calidad.