Construye tu agente
Instrucciones
Escribe las reglas que le dicen a tu agente cómo comportarse, qué decir y cuándo dar un paso atrás
Escribir las instrucciones de tu agente es como entregarle a un nuevo integrante del equipo una descripción del puesto: cuanto más claro seas sobre el rol, el tono y las reglas, mejor hace el trabajo. Las instrucciones son la parte más importante de la configuración de tu agente. Deciden cómo se comporta — su personalidad, tono, reglas, límites y cómo toma decisiones. Cuanto más específico seas, mejor se desempeña tu agente.
Qué controlan las instrucciones
| Aspecto | Qué defines |
|---|---|
| Personalidad | El tono, estilo y carácter 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 | Cómo manejar situaciones específicas ("si alguien pregunta sobre precios, siempre incluye el enlace a nuestra página de precios") |
| Formato de respuesta | Cómo deben verse las respuestas ("usa viñetas", "mantén las respuestas en menos de tres oraciones") |
| Uso de herramientas | Cuándo y cómo usar una herramienta específica ("siempre revisa el calendario antes de sugerir una hora de reunión") |
| Escalamiento | Cuándo derivar a una persona ("si alguien pide cancelar su cuenta, dile que lo conectarás con soporte") |
Antes de empezar
- Guarda primero la sección Perfil. Las Instrucciones Mágicas (más abajo) usan el nombre y la descripción de tu agente para escribir mejores instrucciones.
- Ten una idea aproximada de lo que tu agente debe y no debe hacer — incluso unas pocas viñetas ayudan.
Instrucciones Mágicas
¿No quieres escribir instrucciones desde cero? Haz clic en el botón Instrucciones Mágicas y describe en lenguaje natural lo que quieres que haga tu agente. Nirvai escribe un conjunto completo de instrucciones para ti — tono, reglas, alcance, cuándo derivar a una persona y cómo usar las herramientas.
Puedes dejar las instrucciones generadas tal como están o ajustarlas. Las Instrucciones Mágicas son la forma más rápida de tener un agente funcionando.
Las Instrucciones Mágicas funcionan mejor cuando tu agente ya tiene un nombre y una descripción claros en su Perfil. Nirvai usa eso para escribir instrucciones más relevantes.
Escribir instrucciones manualmente
En el constructor, elige Instrucciones en el menú de la izquierda. Verás un cuadro de texto grande donde escribes tus instrucciones en lenguaje natural, con un conteo de palabras encima.
Instrucciones
Qué debe hacer este agente, cómo debe responder y todo lo que nunca debe hacer.
Una estructura que funciona
Un buen conjunto de instrucciones sigue este patrón:
QUIÉN eres:
Tu rol y propósito
CÓMO respondes:
Tono, estilo, reglas de formato
QUÉ haces:
Las tareas que manejas y cómo
QUÉ NO haces:
Límites y restricciones
REGLAS ESPECIALES:
Comportamientos específicos 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: Sé amigable, servicial y paciente. Usa lenguaje sencillo — evita la jerga técnica.
Reglas:
- Siempre saluda al usuario y pregunta en qué puedes ayudar
- Cuando pregunten sobre un pedido, usa la herramienta de búsqueda de pedidos para encontrar el estado
- Para solicitudes de devolución, explica nuestra política de devolución de 30 días y proporciona el enlace al formulario de devolución
- Si no sabes la respuesta, dilo honestamente — no inventes cosas
- Nunca compartas precios internos, códigos de descuento ni información de empleados
- Si el usuario está frustrado, reconoce su preocupación antes de resolver el problema
Escalamiento: Si el cliente pide hablar con un humano, o si el problema involucra disputas de facturación, di: "Te conectaré con nuestro equipo de soporte de inmediato" y termina la conversación de manera cordial.
Ejemplo: agente de investigación
Eres un asistente de investigación que ayuda a los usuarios a encontrar y resumir información sobre temas específicos.
Cómo trabajar:
- Siempre usa la búsqueda web para encontrar información 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
Límites:
- No des consejos médicos, legales ni 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 "sé útil" | El agente no sabe qué significa "útil" en tu situación | "Responde preguntas sobre productos usando los documentos de tu proyecto. Mantén las respuestas en menos de tres oraciones." |
| Sin límites | El agente intenta responder todo, incluyendo cosas que no debería | "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 | Mantén las instrucciones enfocadas. Pon el material de referencia en un proyecto. |
| Sin forma de escalar | La gente se queda atascada cuando el agente no puede ayudar | Siempre indica cuándo y cómo derivar a una persona |
Usar valores de pasos anteriores
Si tu agente funciona dentro de una automatización (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. Clasifícalos como positivos, negativos o neutrales. Califica la urgencia del 1 al 5.
La automatización le entrega el resultado del paso anterior a tu agente como su entrada, así que tus instrucciones deben describir qué hacer con esa entrada.
Probar tus instrucciones
La mejor manera de revisar tus instrucciones es chatear con tu agente después de crearlo:
- Haz el tipo de preguntas que harán tus usuarios.
- Prueba casos límite — 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.
Activa Aprende de tus correcciones y cuéntale al agente en el chat qué salió mal — propone el arreglo a sus instrucciones y tú lo apruebas.
Solución de problemas
| Problema | Solución |
|---|---|
| El agente ignora una regla que escribí | Haz la regla más corta y específica, y ponla cerca del inicio. Las instrucciones largas pueden enterrar reglas importantes. |
| El agente responde preguntas que no debería | Agrega un alcance y un límite claros ("solo responde preguntas sobre X; para cualquier otra cosa, di…"). |
| Las Instrucciones Mágicas dan resultados genéricos | Completa primero un nombre y una descripción claros en la sección Perfil, y luego genera de nuevo. |
| Las respuestas son demasiado largas o con un tono inadecuado | Detalla el formato y el tono ("mantén las respuestas en menos de tres oraciones", "sé cálido e informal") y prueba de nuevo. |
Qué sigue
Una vez que tiene un perfil e instrucciones, tu agente está Listo. Luego, dale acciones con Herramientas.