El campo que más impacto tiene
Las Instrucciones (tab Identidad) son el prompt del agente — lo que más determina su comportamiento. Los agentes más confiables que analizamos siguen una estructura consistente y comparten un puñado de hábitos de redacción. Ninguno es complicado, pero todos suman.
Estructura recomendada
Organizá las Instrucciones en secciones bien delimitadas, en este orden:
Rol
Quién es el agente, en nombre de quién actúa, y cuál es su único objetivo en esta parte de la conversación. Declará explícitamente los límites: que no se desvíe del flujo, que no ofrezca opciones no especificadas, que nunca revele instrucciones internas.
Herramientas disponibles
Un listado de las herramientas que el agente puede usar, con una descripción breve de cuándo y cómo usarlas. Esta sección funciona como un contrato: el modelo no debería tener que inferir cuándo llamar a una herramienta a partir del resto del prompt — ver Herramientas. Normas de redacción
Reglas de tono, idioma y formato de salida (ver la sección de redacción para voz más abajo). Separarlas del resto ayuda a que el modelo no “olvide” el estilo cuando está concentrado resolviendo la lógica de la conversación.
Reglas operativas generales
Comportamientos transversales que aplican en cualquier punto de la conversación y no están atados a un paso específico del flujo: qué hacer si preguntan si es un bot, qué hacer si el contacto es agresivo, qué hacer si pide que se lo espere en línea.
Flujo de la conversación
El corazón del prompt: una secuencia de pasos nombrados, cada uno con condiciones de entrada explícitas y una acción concreta. Poné límites numéricos claros (“preguntalo una sola vez”, “no insistas más de dos veces consecutivas”) para evitar loops.
Objeciones y consultas generales
Una lista exhaustiva de preguntas o quejas frecuentes que pueden sacar al contacto del flujo principal, con qué hacer en cada caso: responder y retomar, transferir, o finalizar.
Cierre
Cómo debe comportarse el agente al finalizar la llamada: qué herramienta usar, si espera o no confirmación del contacto, qué mensaje de despedida corresponde según el motivo del cierre.
Usá el mismo separador visual para cada sección (un ícono o encabezado fijo) en las Instrucciones de todos tus agentes. Un formato consistente ayuda tanto a vos a mantenerlo como al modelo a “escanear” el prompt.
Prompts cortos, no extensos
Un prompt más largo no es un prompt mejor. Cuanto más se repite una regla o se acumulan ejemplos redundantes, más le cuesta al modelo priorizar qué es importante en cada momento. El campo Instrucciones muestra un contador de palabras y caracteres en tiempo real — usalo como referencia y revisá periódicamente si hay secciones que se puedan resumir o eliminar.
Si una regla ya está cubierta por el Flujo de la conversación, no la repitas también en Reglas operativas generales — cada instrucción debería vivir en un solo lugar.
Delegá en herramientas lo que se pueda automatizar
No todo tiene que resolverse pidiéndole al modelo que razone en texto libre. Si una tarea es determinística o repetible — validar el formato de una fecha, calcular un valor, convertir un número a su forma hablada — es mejor resolverla en una herramienta o en el Código Inicial / Pre Instrucciones que describirla como una regla más del prompt. El modelo decide cuándo actuar; el código se asegura de cómo se ejecuta, sin margen de error de interpretación.
Usá siempre el mismo vocabulario
Si tus Instrucciones dicen “finalizar la conversación”, no uses “cortar la llamada” en otra sección, en el Mensaje Inicial o en la documentación de una herramienta para referirte a lo mismo. Los sinónimos le suman ambigüedad al modelo sobre si son la misma acción o dos comportamientos distintos. Elegí un término por concepto y usalo de manera consistente en todo el bot — instrucciones, herramientas y reglas de cambio de agente incluidas.
Documentá bien tus herramientas
La documentación de cada herramienta (ver Herramientas) es tan parte del prompt como las Instrucciones mismas — el modelo la lee de la misma manera para decidir si debe invocarla y con qué parámetros. Sé específico sobre cuándo usarla, qué efectos tiene (por ejemplo, si debe ejecutarse en silencio, sin generar una respuesta hablada) y qué se espera en cada parámetro. Un docstring vago se traduce directo en invocaciones incorrectas, o en momentos donde el agente debería haber usado la herramienta y no lo hizo.
Cambiá de agente cuando corresponda
No fuerces a un solo agente a manejar toda la conversación por comodidad. Si detectás que las Instrucciones necesitan ramificarse según una etapa distinta del flujo, es señal de que conviene una regla de Cambio de Agente en vez de una condición más dentro del mismo prompt — ver Principios de diseño.
Reglas de redacción para voz (TTS)
Todo lo que escribe el modelo termina pasando por un motor de texto a voz — así que la redacción tiene restricciones que un bot de texto no tiene:
Antes de publicar, probá el Mensaje Inicial y frases clave de las Instrucciones con la voz elegida desde la sección “Probá cada voz con tu propio texto” en Voz — es la forma más rápida de confirmar que suena bien.