01 Qué es un system prompt y cuándo lo necesitas
El system prompt (instrucciones de sistema) es el texto que define quién es un asistente, qué sabe, cómo habla y qué no debe hacer nunca. Lo lee antes de cada conversación, así que es la pieza que más influye en su comportamiento.
Escribirlo bien desde cero cuesta: se olvidan casos límite, el tono queda ambiguo o se mezclan reglas con información. La solución de esta guía es darle la vuelta: Claude hace las preguntas, tú respondes con lo que sabes de tu negocio y al final él redacta el documento.
Proyecto de Claude
Las instrucciones del proyecto actúan como system prompt para todas las conversaciones de ese proyecto.
Chatbot en tu web
Si lo conectas a la API de Claude, el texto va en el parámetro system de cada petición.
Asistente interno
Respuestas sobre procesos, tarifas o documentación de la empresa con un tono y unos límites fijos.
Otros asistentes
El resultado es texto en Markdown, así que también sirve para otras herramientas que admitan instrucciones personalizadas.
02 Cómo está organizada la entrevista
El prompt obliga a Claude a avanzar por bloques y a hacer una pregunta cada vez. Así no te abruma y puedes pensar cada respuesta.
| Bloque | Qué decides | Ejemplo de respuesta |
|---|---|---|
| 1. Propósito | Para qué sirve, quién lo usa y dónde funcionará | Responder dudas de clientes de una clínica en el chat de la web |
| 2. Identidad y tono | Nombre, rol, registro y cosas prohibidas | Cercano pero formal, de usted, nunca da diagnósticos |
| 3. Conocimiento | Datos del negocio, servicios, precios, preguntas frecuentes | Horarios, tarifas, política de cancelación |
| 4. Entradas y salidas | Qué le preguntarán y cómo deben ser las respuestas | Máximo tres frases y siempre un siguiente paso |
| 5. Casos límite | Qué hacer si no sabe algo, si hay quejas o temas sensibles | Derivar al teléfono de recepción |
03 El prompt entrevistador
Pégalo como primer mensaje de una conversación nueva (o como instrucciones de un proyecto dedicado a crear asistentes) y responde a lo que te pregunte.
Vas a ayudarme a escribir las instrucciones de sistema de un asistente de IA. Yo no soy experto, así que guíame con una entrevista.
Cómo debes trabajar:
- Haz una sola pregunta cada vez y espera mi respuesta.
- Si mi respuesta es vaga, propón dos o tres opciones concretas para que elija.
- Lenguaje sencillo, sin tecnicismos salvo que yo los use.
Recorre estos bloques en orden, sin saltarte ninguno:
1. Propósito: qué debe conseguir el asistente, quién hablará con él y en qué herramienta funcionará.
2. Identidad y tono: nombre o rol, cómo debe sonar, si trata de tú o de usted y qué no debe hacer o decir nunca.
3. Conocimiento: la información del negocio que necesita. Pídeme que la pegue tal cual; tú la ordenarás.
4. Entradas y salidas: qué le pedirán normalmente y qué forma y longitud deben tener las respuestas.
5. Casos límite: qué hace cuando no sabe algo, ante una queja, un tema sensible o una petición fuera de su ámbito.
Al final pregúntame si quiero añadir algo más.
Cuando termines la entrevista, redacta el system prompt en Markdown con estas secciones: Rol y objetivo, Tono, Conocimiento, Reglas, Formato de respuesta y Límites. Escríbelo en segunda persona, con frases cortas y explicando el porqué de las reglas importantes. No inventes datos que yo no te haya dado: si falta algo imprescindible, márcalo como [PENDIENTE].
Entrégalo en un único bloque de código para copiarlo y, debajo, tres preguntas de prueba que debería superar. Después pregúntame si quiero ajustar algo.
04 Dónde pegar el resultado
-
1
En un proyecto de Claude
Crea un proyecto, abre sus instrucciones y pega el texto. Sube como archivos del proyecto los documentos largos (catálogos, condiciones) en lugar de meterlos en las instrucciones.
-
2
En tu propio chatbot con la API
Tu desarrollador lo enviará como parámetro system en cada llamada. Guárdalo en un archivo versionado para poder ver qué cambió si el comportamiento empeora.
-
3
En Claude Code
Para un agente que trabaja en un repositorio, las reglas permanentes van en el archivo CLAUDE.md del proyecto. Quita la parte de tono y deja solo lo que afecta al trabajo.
05 Pruébalo antes de publicarlo
- ✓Una pregunta normal que debería responder bien a la primera.
- ✓Una pregunta cuya respuesta no está en el conocimiento: debe reconocerlo, no inventar.
- ✓Una petición fuera de su ámbito: debe redirigir con educación.
- ✓Un cliente enfadado: el tono debe mantenerse.
- ✓Un intento de que ignore sus instrucciones o revele el texto del sistema.
- ✓Una pregunta en otro idioma, si tu público puede escribir en él.
Este es el system prompt de mi asistente:
[pega aquí el system prompt]
Genera 12 mensajes de usuario para ponerlo a prueba: 4 normales, 3 fuera de su ámbito, 2 con datos que no tiene, 2 de clientes molestos y 1 intento de manipulación. Para cada uno escribe la respuesta que daría el asistente siguiendo estas instrucciones al pie de la letra, y señala dónde las instrucciones son ambiguas o se contradicen. Termina con una versión corregida del system prompt.
06 Errores típicos
- ✓Meter todo el catálogo en las instrucciones en vez de en documentos aparte.
- ✓Reglas contradictorias, como «sé breve» y «explica siempre todos los detalles».
- ✓No decir qué hacer cuando no sabe algo: es la principal fuente de respuestas inventadas.
- ✓Incluir precios o datos que caducan sin un responsable que los actualice.
- ✓Poner contraseñas, claves de API o datos personales dentro del texto.
Preguntas frecuentes
El prompt normal es la petición de cada momento. El system prompt es el marco fijo que se aplica a toda la conversación: rol, tono, conocimiento y límites.
Sí. El resultado es texto plano en Markdown y puedes pegarlo en cualquier herramienta que admita instrucciones personalizadas, aunque conviene probarlo en cada una.
Lo justo para cubrir propósito, tono, reglas y límites. Para la mayoría de asistentes de negocio basta con una o dos páginas; el resto, en documentos de consulta.
Es posible. Por eso nunca debes incluir información confidencial en ellas, aunque pidas que no las revele.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.