Código del widget de chat con instrucciones privadas: cómo escribir un system prompt que funcione
El código para insertar es el mismo para todos los widgets de chat. Lo que hace útil al tuyo son sus instrucciones privadas. Así se escriben para lograr respuestas precisas y fieles a tu marca.
Publicado:
Dos widgets de chat pueden compartir la misma línea de código para insertar y comportarse de forma totalmente distinta. La diferencia está en las instrucciones privadas, a menudo llamadas system prompt. Se guardan en el servidor junto con tu widget, se envían con cada conversación y nunca se muestran a los visitantes.
Dónde están las instrucciones
Abre un widget de chat en Widgets y baja hasta Comportamiento. El campo de instrucciones admite hasta 4.000 caracteres. Como permanecen en el servidor, un visitante que inspeccione tu página solo verá el id del widget en la etiqueta script:
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
Los cambios en las instrucciones se aplican desde el siguiente mensaje. Nunca necesitas actualizar el código de tu web.
Una estructura que funciona
Unas buenas instrucciones responden a cuatro preguntas para el modelo.
- ¿Quién eres? "Eres el asistente de Northwind, una tienda online de material de montaña."
- ¿Qué sabes? Pega los datos que importan: plazos de envío, política de devoluciones, horarios, líneas de producto. El modelo solo puede ser tan preciso como los datos que le das.
- ¿Qué debes evitar? "No prometas descuentos. No des consejos médicos ni legales. Si no estás seguro, dilo y remite a la página de contacto."
- ¿Cómo debes sonar? "Responde en dos o tres frases cortas. Usa el idioma del visitante."
Mantén cada regla breve y concreta. A un modelo le cuesta más seguir párrafos largos y vagos que una lista corta.
Pruébalo como un visitante
La vista previa del editor envía solicitudes reales con tus instrucciones sin guardar, así que puedes iterar rápido:
- Haz las cinco preguntas que más llegan a tu bandeja de soporte.
- Pregunta algo que tus instrucciones no cubran y comprueba que el widget reconoce que no lo sabe.
- Intenta que rompa una regla, por ejemplo pidiéndole un código de descuento.
Ajusta las instrucciones después de cada ronda. Pequeños cambios de redacción suelen resolver la mayoría de los problemas.
Mantén la coherencia de marca
El widget de chat es de marca blanca: no lleva logotipo ni línea "powered by". Define el título, el mensaje de bienvenida, el texto del campo, el texto del botón y el mensaje de error con tus propias palabras, y adapta el color de acento, el radio de las esquinas y el tema a tu web. Los textos que dejes vacíos usan valores predeterminados en el idioma de tu cuenta.
Combina las instrucciones con límites
Las instrucciones dan forma a las respuestas, pero no son un presupuesto. Fija una longitud máxima de respuesta (tokens) para que las respuestas sean breves, y elige la clave API con la que funciona el widget. El límite de gasto diario y los modelos permitidos de esa clave se aplican a cada solicitud de los visitantes, lo que te da una segunda red de seguridad independiente.
Empieza con un borrador en la página de widgets y afínalo después en tu panel.