Paso 3: Instrucciones
Escribir las instrucciones de tu agente es como entregarle a un nuevo integrante del equipo una descripcion del puesto: cuanto mas claro seas sobre el rol, el tono y las reglas, mejor hace el trabajo. Las instrucciones son la parte mas importante de la configuracion de tu agente. Deciden como se comporta — su personalidad, tono, reglas, limites y como toma decisiones. Cuanto mas especifico seas, mejor se desempena tu agente.
Que controlan las instrucciones
| Aspecto | Que defines |
|---|---|
| Personalidad | El tono, estilo y caracter del agente ("amigable e informal" vs. "formal y profesional") |
| Alcance | Lo que el agente debe y no debe hacer ("solo responde preguntas sobre nuestros productos") |
| Reglas de comportamiento | Como manejar situaciones especificas ("si alguien pregunta sobre precios, siempre incluye el enlace a nuestra pagina de precios") |
| Formato de respuesta | Como deben verse las respuestas ("usa vinetas", "manten las respuestas en menos de tres oraciones") |
| Uso de herramientas | Cuando y como usar una herramienta especifica ("siempre revisa el calendario antes de sugerir una hora de reunion") |
| Escalamiento | Cuando derivar a una persona ("si alguien pide cancelar su cuenta, dile que lo conectaras con soporte") |
Antes de empezar
- Completa primero el paso de Perfil. Las Instrucciones Magicas (mas abajo) usan el nombre y la descripcion de tu agente para escribir mejores instrucciones.
- Ten una idea aproximada de lo que tu agente debe y no debe hacer — incluso unas pocas vinetas ayudan.
Instrucciones Magicas
No quieres escribir instrucciones desde cero? Haz clic en el boton Magic Instructions y describe lo que quieres que haga tu agente en lenguaje natural. Nirvai escribe un conjunto completo de instrucciones para ti — tono, reglas, alcance, cuando derivar a una persona y como usar las herramientas.
Puedes dejar las instrucciones generadas tal como estan o ajustarlas. Magic Instructions es la forma mas rapida de tener un agente funcional listo.
Magic Instructions funciona mejor cuando tu agente ya tiene un nombre y una descripcion claros del paso de Perfil. Nirvai usa eso para escribir instrucciones mas relevantes.
Escribir instrucciones manualmente
Haz clic en el nodo Instrucciones en el lienzo de creacion. Veras un cuadro de texto donde escribes tus instrucciones en lenguaje natural.
Image: El panel de instrucciones con un editor de texto e instrucciones de ejemplo
Una estructura que funciona
Un buen conjunto de instrucciones sigue este patron:
QUIEN eres:
Tu rol y proposito
COMO respondes:
Tono, estilo, reglas de formato
QUE haces:
Las tareas que manejas y como
QUE NO haces:
Limites y restricciones
REGLAS ESPECIALES:
Comportamientos especificos si/entonces
Ejemplo: agente de soporte al cliente
Eres un agente de soporte al cliente para Acme Corp. Ayudas a los clientes con preguntas sobre productos, seguimiento de pedidos y devoluciones.
Tono: Se amigable, servicial y paciente. Usa lenguaje sencillo — evita la jerga tecnica.
Reglas:
- Siempre saluda al usuario y pregunta en que puedes ayudar
- Cuando pregunten sobre un pedido, usa la herramienta de busqueda de pedidos para encontrar el estado
- Para solicitudes de devolucion, explica nuestra politica de devolucion de 30 dias y proporciona el enlace al formulario de devolucion
- Si no sabes la respuesta, dilo honestamente — no inventes cosas
- Nunca compartas precios internos, codigos de descuento o informacion de empleados
- Si el usuario esta frustrado, reconoce su preocupacion antes de resolver el problema
Escalamiento: Si el cliente pide hablar con un humano, o si el problema involucra disputas de facturacion, di: "Te conectare con nuestro equipo de soporte de inmediato" y termina la conversacion de manera cordial.
Ejemplo: agente de investigacion
Eres un asistente de investigacion que ayuda a los usuarios a encontrar y resumir informacion sobre temas especificos.
Como trabajar:
- Siempre usa la busqueda web para encontrar informacion actual — no te bases en conocimiento antiguo
- Cita tus fuentes con enlaces cuando sea posible
- Presenta los hallazgos en un orden claro: resumen primero, luego detalles
- Si te piden comparar temas, usa una tabla
Limites:
- No des consejos medicos, legales o financieros
- Si un tema es demasiado amplio, pide al usuario que lo acote antes de investigar
Errores comunes
| Error | Problema | Mejor enfoque |
|---|---|---|
| Instrucciones vagas como "se util" | El agente no sabe que significa "util" en tu situacion | "Responde preguntas sobre productos usando la base de conocimiento. Manten las respuestas en menos de tres oraciones." |
| Sin limites | El agente intenta responder todo, incluyendo cosas que no deberia | "Solo responde preguntas sobre nuestros productos. Para cualquier otra cosa, di: Solo puedo ayudar con preguntas sobre productos." |
| Reglas contradictorias | El agente se confunde y se comporta de manera inconsistente | Lee tus instrucciones en busca de conflictos antes de guardar |
| Instrucciones demasiado largas | Las reglas importantes se pierden en el ruido | Manten las instrucciones enfocadas. Pon el material de referencia en la base de conocimiento. |
| Sin forma de escalar | La gente se queda atascada cuando el agente no puede ayudar | Siempre indica cuando y como derivar a una persona |
Usar valores de pasos anteriores
Si tu agente funciona dentro de una automatizacion (una cadena de pasos que se ejecutan uno tras otro), puede usar el resultado de un paso anterior como su entrada. Por ejemplo:
Analiza los comentarios del cliente proporcionados en la entrada. Clasificalos como positivos, negativos o neutrales. Califica la urgencia del 1 al 5.
La automatizacion le entrega el resultado del paso anterior a tu agente como su entrada, asi que tus instrucciones deben describir que hacer con esa entrada.
Probar tus instrucciones
La mejor manera de revisar tus instrucciones es chatear con tu agente despues de crearlo:
- Haz las preguntas que tus usuarios haran.
- Prueba casos limite — preguntas fuera de lo que el agente debe manejar.
- Verifica que el tono y el formato coincidan con lo que describiste.
- Confirma que el agente use las herramientas como dicen tus reglas.
Si el agente no se comporta como esperabas, edita las instrucciones y prueba de nuevo. A menudo toma dos o tres rondas para que queden bien.
Usa el Developer Mode para profundizar en los problemas de las instrucciones. El ayudante integrado optimize_instructions revisa tus instrucciones y sugiere mejoras.
Solucion de problemas
| Problema | Solucion |
|---|---|
| El agente ignora una regla que escribi | Haz la regla mas corta y especifica, y ponla cerca del inicio. Las instrucciones largas pueden enterrar reglas importantes. |
| El agente responde preguntas que no deberia | Agrega un alcance y un limite claros ("solo responde preguntas sobre X; para cualquier otra cosa, di…"). |
| Magic Instructions da resultados genericos | Completa primero un nombre y una descripcion claros en el paso de Perfil, y luego genera de nuevo. |
| Las respuestas son demasiado largas o con un tono inadecuado | Detalla el formato y el tono ("manten las respuestas en menos de tres oraciones", "se calido e informal") y prueba de nuevo. |
Que sigue
Despues de escribir tus instrucciones, haz clic en el nodo Herramientas para continuar al Paso 4: Herramientas.