> ## Documentation Index > Fetch the complete documentation index at: https://docs.inceptia.ai/llms.txt > Use this file to discover all available pages before exploring further. # Instrucciones que funcionan > Cómo estructurar el prompt de un agente para que el LLM no se pierda ## El campo que más impacto tiene Las Instrucciones (tab [Identidad](/construccion/agentes/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: 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. 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](/construccion/agentes/herramientas). 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. 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. 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. 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. 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](/construccion/agentes/logica) 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](/construccion/agentes/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](/construccion/agentes/cambio-de-agente) en vez de una condición más dentro del mismo prompt — ver [Principios de diseño](/construccion/buenas-practicas/principios-de-diseno). *** ## 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: | Regla | Por qué | | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | **Números en palabras** ("mil quinientos pesos", no "1500") | Evita que el motor de voz los lea de forma extraña. | | **Preguntas sin apertura** (sin `¿`, solo `?` de cierre) | Muchos motores de síntesis usan la puntuación para decidir la entonación; el signo de apertura puede generar resultados inconsistentes. | | **Fechas habladas, no escritas** ("doce de septiembre", no "12/09") | Suena natural en una conversación de corta duración; omití el año salvo que el contexto lo requiera. | | **Evitar muletillas repetidas** ("entiendo", "perfecto") | Se notan como un patrón artificial cuando se repiten en la misma llamada. | | **No arrancar dos mensajes seguidos igual** | Ayuda a que la conversación no suene guionada. | | **Tono acorde al canal** | Un bot de voz puede (y en general debe) sonar más coloquial que uno de texto — dentro de los límites de profesionalismo que tu caso de uso requiera. | 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](/construccion/voz) — es la forma más rápida de confirmar que suena bien.