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) 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
Organiza las Instrucciones en secciones bien delimitadas, en este orden:
1
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. Declara explícitamente los límites: que no se desvíe del flujo, que no ofrezca opciones no especificadas, que nunca revele instrucciones internas.
2
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.
3
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.
4
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.
5
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 (“pregúntalo una sola vez”, “no insistas más de dos veces consecutivas”) para evitar loops.
6
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.
7
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.
Usa 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 ti 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 — úsalo como referencia y revisa 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.
Delega 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.
Usa 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. Elige un término por concepto y úsalo de manera consistente en todo el bot — instrucciones, herramientas y reglas de cambio de agente incluidas.
Documenta 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.
Cambia de agente cuando corresponda
No fuerces a un solo agente a manejar toda la conversación por comodidad. Si detectas 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:
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; omite el año salvo que el contexto lo requiera.
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, prueba el Mensaje Inicial y frases clave de las Instrucciones con la voz elegida desde la sección “Prueba cada voz con tu propio texto” en Voz — es la forma más rápida de confirmar que suena bien.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Inceptia","colors":{"primary":"#1976d2","light":"#42a5f5","dark":"#1565c0"},"logo":{"light":"https://mintcdn.com/inceptia/vb2nIh4BcXW1gbdW/logo/logo-inceptia-blue.svg?fit=max\u0026auto=format\u0026n=vb2nIh4BcXW1gbdW\u0026q=85\u0026s=68b54688c53a1316aa5bcdc87827fa59","dark":"https://mintcdn.com/inceptia/vb2nIh4BcXW1gbdW/logo/logo-inceptia-white.svg?fit=max\u0026auto=format\u0026n=vb2nIh4BcXW1gbdW\u0026q=85\u0026s=ee65b7875d7d4f1fa625fbba7927a68e"},"favicon":"https://mintcdn.com/inceptia/vb2nIh4BcXW1gbdW/logo/favicon.ico?fit=max\u0026auto=format\u0026n=vb2nIh4BcXW1gbdW\u0026q=85\u0026s=c68dba084f4a58891fb1998638f72983","api":{"playground":{}},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://ts.inceptia.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/inceptia-ai","website":"https://inceptia.ai"}},"search":{"prompt":"Buscar..."},"seo":{"metatags":{"google-site-verification":"eAvuxA4L-c4RDw6I4mRGA_hxlJU4WwDIwQFVbgngsTs"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"es","href":""},{"language":"en","href":"en"},{"language":"pt-BR","href":"pt-BR"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"inceptia","hasAudioNarration":false,"actualSubdomain":"inceptia","customDomains":["docs.inceptia.ai"],"gitSource":{"type":"github","owner":"inceptia","repo":"docs","deployBranch":"master","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"entitlements":{},"buildId":"6af4a177f8db9a78751ff6f4","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"es","tag":"Plataforma","count":23},{"language":"en","tag":"Platform","count":23},{"language":"pt-BR","tag":"Plataforma","count":23},{"language":"es","tag":"API reference","count":18},{"language":"en","tag":"API reference","count":18},{"language":"pt-BR","tag":"Referência da API","count":18},{"language":"es","tag":"Operaciones","count":11},{"language":"en","tag":"Operations","count":11},{"language":"pt-BR","tag":"Operações","count":11},{"language":"es","tag":"Campañas","count":6},{"language":"en","tag":"Campaigns","count":6},{"language":"pt-BR","tag":"Campanhas","count":6},{"language":"es","tag":"Construye tu agente","count":5},{"language":"es","tag":"Configura tu bot","count":5},{"language":"es","tag":"Entrada de Campaña","count":5},{"language":"en","tag":"Build your agent","count":5},{"language":"en","tag":"Configure your bot","count":5},{"language":"en","tag":"Campaign Input","count":5},{"language":"pt-BR","tag":"Construa seu agente","count":5},{"language":"pt-BR","tag":"Configure seu bot","count":5},{"language":"pt-BR","tag":"Entrada de Campanha","count":5},{"language":"es","tag":"Inicio","count":4},{"language":"es","tag":"Primeros pasos","count":4},{"language":"en","tag":"Getting started","count":4},{"language":"pt-BR","tag":"Início","count":4},{"language":"pt-BR","tag":"Primeiros passos","count":4},{"language":"es","tag":"Autenticación","count":3},{"language":"en","tag":"Authentication","count":3},{"language":"en","tag":"Campaign cases","count":3},{"language":"pt-BR","tag":"Autenticação","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".nav-logo{height:2.5rem!important}"}],"page":{"pagePath":"construccion/buenas-practicas/instrucciones-que-funcionan","slug":"/construccion/buenas-practicas/instrucciones-que-funcionan","pageMetadata":{"title":"Instrucciones que funcionan","description":"Cómo estructurar el prompt de un agente para que el LLM no se pierda","icon":"pen-to-square","href":"/construccion/buenas-practicas/instrucciones-que-funcionan"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Cómo estructurar el prompt de un agente para que el LLM no se pierda\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,hr:`hr`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Step,Steps,Table,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`el-campo-que-más-impacto-tiene`,children:`El campo que más impacto tiene`}),`\n`,_jsxs(_components.p,{children:[`Las Instrucciones (tab `,_jsx(_components.a,{href:`/construccion/agentes/identidad`,children:`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.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`estructura-recomendada`,children:`Estructura recomendada`}),`\n`,_jsx(_components.p,{children:`Organiza las Instrucciones en secciones bien delimitadas, en este orden:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Rol`,children:_jsx(_components.p,{children:`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. Declara explícitamente los límites: que no se desvíe del flujo, que no ofrezca opciones no especificadas, que nunca revele instrucciones internas.`})}),_jsx(Step,{title:`Herramientas disponibles`,children:_jsxs(_components.p,{children:[`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 `,_jsx(_components.a,{href:`/construccion/agentes/herramientas`,children:`Herramientas`}),`.`]})}),_jsx(Step,{title:`Normas de redacción`,children:_jsx(_components.p,{children:`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.`})}),_jsx(Step,{title:`Reglas operativas generales`,children:_jsx(_components.p,{children:`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.`})}),_jsx(Step,{title:`Flujo de la conversación`,children:_jsx(_components.p,{children:`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 (“pregúntalo una sola vez”, “no insistas más de dos veces consecutivas”) para evitar loops.`})}),_jsx(Step,{title:`Objeciones y consultas generales`,children:_jsx(_components.p,{children:`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.`})}),_jsx(Step,{title:`Cierre`,children:_jsx(_components.p,{children:`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.`})})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Usa 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 ti a mantenerlo como al modelo a “escanear” el prompt.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`prompts-cortos-no-extensos`,children:`Prompts cortos, no extensos`}),`\n`,_jsx(_components.p,{children:`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 — úsalo como referencia y revisa periódicamente si hay secciones que se puedan resumir o eliminar.`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`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.`})}),`\n`,_jsx(Heading,{level:`2`,id:`delega-en-herramientas-lo-que-se-pueda-automatizar`,children:`Delega en herramientas lo que se pueda automatizar`}),`\n`,_jsxs(_components.p,{children:[`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 `,_jsx(_components.a,{href:`/construccion/agentes/logica`,children:`Código Inicial / Pre Instrucciones`}),` que describirla como una regla más del prompt. El modelo decide `,_jsx(_components.em,{children:`cuándo`}),` actuar; el código se asegura de `,_jsx(_components.em,{children:`cómo`}),` se ejecuta, sin margen de error de interpretación.`]}),`\n`,_jsx(Heading,{level:`2`,id:`usa-siempre-el-mismo-vocabulario`,children:`Usa siempre el mismo vocabulario`}),`\n`,_jsx(_components.p,{children:`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. Elige un término por concepto y úsalo de manera consistente en todo el bot — instrucciones, herramientas y reglas de cambio de agente incluidas.`}),`\n`,_jsx(Heading,{level:`2`,id:`documenta-bien-tus-herramientas`,children:`Documenta bien tus herramientas`}),`\n`,_jsxs(_components.p,{children:[`La documentación de cada herramienta (ver `,_jsx(_components.a,{href:`/construccion/agentes/herramientas`,children:`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.`]}),`\n`,_jsx(Heading,{level:`2`,id:`cambia-de-agente-cuando-corresponda`,children:`Cambia de agente cuando corresponda`}),`\n`,_jsxs(_components.p,{children:[`No fuerces a un solo agente a manejar toda la conversación por comodidad. Si detectas que las Instrucciones necesitan ramificarse según una etapa distinta del flujo, es señal de que conviene una regla de `,_jsx(_components.a,{href:`/construccion/agentes/cambio-de-agente`,children:`Cambio de Agente`}),` en vez de una condición más dentro del mismo prompt — ver `,_jsx(_components.a,{href:`/construccion/buenas-practicas/principios-de-diseno`,children:`Principios de diseño`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`reglas-de-redacción-para-voz-tts`,children:`Reglas de redacción para voz (TTS)`}),`\n`,_jsx(_components.p,{children:`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:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Regla`}),_jsx(_components.th,{children:`Por qué`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Números en palabras`}),` (“mil quinientos pesos”, no “1500”)`]}),_jsx(_components.td,{children:`Evita que el motor de voz los lea de forma extraña.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Preguntas sin apertura`}),` (sin `,_jsx(_components.code,{children:`¿`}),`, solo `,_jsx(_components.code,{children:`?`}),` de cierre)`]}),_jsx(_components.td,{children:`Muchos motores de síntesis usan la puntuación para decidir la entonación; el signo de apertura puede generar resultados inconsistentes.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Fechas habladas, no escritas`}),` (“doce de septiembre”, no “12/09”)`]}),_jsx(_components.td,{children:`Suena natural en una conversación de corta duración; omite el año salvo que el contexto lo requiera.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Evitar muletillas repetidas`}),` (“entiendo”, “perfecto”)`]}),_jsx(_components.td,{children:`Se notan como un patrón artificial cuando se repiten en la misma llamada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`No arrancar dos mensajes seguidos igual`})}),_jsx(_components.td,{children:`Ayuda a que la conversación no suene guionada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Tono acorde al canal`})}),_jsx(_components.td,{children:`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.`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Antes de publicar, prueba el Mensaje Inicial y frases clave de las Instrucciones con la voz elegida desde la sección “Prueba cada voz con tu propio texto” en `,_jsx(_components.a,{href:`/construccion/voz`,children:`Voz`}),` — es la forma más rápida de confirmar que suena bien.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Instrucciones que funcionan","description":"Cómo estructurar el prompt de un agente para que el LLM no se pierda","icon":"pen-to-square","href":"/construccion/buenas-practicas/instrucciones-que-funcionan"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"El campo que más impacto tiene","slug":"el-campo-que-más-impacto-tiene","depth":2,"children":[]},{"title":"Estructura recomendada","slug":"estructura-recomendada","depth":2,"children":[]},{"title":"Prompts cortos, no extensos","slug":"prompts-cortos-no-extensos","depth":2,"children":[]},{"title":"Delega en herramientas lo que se pueda automatizar","slug":"delega-en-herramientas-lo-que-se-pueda-automatizar","depth":2,"children":[]},{"title":"Usa siempre el mismo vocabulario","slug":"usa-siempre-el-mismo-vocabulario","depth":2,"children":[]},{"title":"Documenta bien tus herramientas","slug":"documenta-bien-tus-herramientas","depth":2,"children":[]},{"title":"Cambia de agente cuando corresponda","slug":"cambia-de-agente-cuando-corresponda","depth":2,"children":[]},{"title":"Reglas de redacción para voz (TTS)","slug":"reglas-de-redacción-para-voz-tts","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/inceptia/16ba77125be33004/fix-dev-preview.js"],"subdomain":"inceptia","siteName":"Inceptia","title":"Instrucciones que funcionan - Inceptia","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"es":{"href":"/construccion/buenas-practicas/instrucciones-que-funcionan","matchLevel":0},"en":{"href":"/en/construccion/buenas-practicas/instrucciones-que-funcionan","matchLevel":1},"pt-BR":{"href":"/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan","matchLevel":1}}},"lastModified":"2026-07-22T15:12:49.124Z","originalFileLocation":"construccion/buenas-practicas/instrucciones-que-funcionan.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Cómo estructurar el prompt de un agente para que el LLM no se pierda\">\u003cmeta data-mint-head name=\"application-name\" content=\"Inceptia\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/inceptia/1xVSpj1Hb3wXcv_z/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/inceptia/1xVSpj1Hb3wXcv_z/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/inceptia/1xVSpj1Hb3wXcv_z/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/inceptia/1xVSpj1Hb3wXcv_z/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/inceptia/1xVSpj1Hb3wXcv_z/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/inceptia/1xVSpj1Hb3wXcv_z/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/inceptia/1xVSpj1Hb3wXcv_z/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/inceptia/1xVSpj1Hb3wXcv_z/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/inceptia/1xVSpj1Hb3wXcv_z/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Instrucciones que funcionan - Inceptia\">\u003cmeta data-mint-head property=\"og:description\" content=\"Cómo estructurar el prompt de un agente para que el LLM no se pierda\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Inceptia\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.inceptia.ai/construccion/buenas-practicas/instrucciones-que-funcionan\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://inceptia.mintlify.site/_mintlify/api/og/v2?division=Buenas+pr%C3%A1cticas\u0026amp;title=Instrucciones+que+funcionan\u0026amp;description=C%C3%B3mo+estructurar+el+prompt+de+un+agente+para+que+el+LLM+no+se+pierda\u0026amp;theme=51dfca5cbda408b1ab215588\u0026amp;signature=e682d71b6878f53527173100787d4f3c3ba3e665e88b6e2b35500ae2cdcde4f5\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Instrucciones que funcionan - Inceptia\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Cómo estructurar el prompt de un agente para que el LLM no se pierda\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://inceptia.mintlify.site/_mintlify/api/og/v2?division=Buenas+pr%C3%A1cticas\u0026amp;title=Instrucciones+que+funcionan\u0026amp;description=C%C3%B3mo+estructurar+el+prompt+de+un+agente+para+que+el+LLM+no+se+pierda\u0026amp;theme=51dfca5cbda408b1ab215588\u0026amp;signature=e682d71b6878f53527173100787d4f3c3ba3e665e88b6e2b35500ae2cdcde4f5\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/inceptia/1xVSpj1Hb3wXcv_z/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Inceptia\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1976d2\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"eAvuxA4L-c4RDw6I4mRGA_hxlJU4WwDIwQFVbgngsTs\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.inceptia.ai/construccion/buenas-practicas/instrucciones-que-funcionan\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/construccion/buenas-practicas/instrucciones-que-funcionan.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.inceptia.ai/construccion/buenas-practicas/instrucciones-que-funcionan\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.inceptia.ai/en/construccion/buenas-practicas/instrucciones-que-funcionan\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.inceptia.ai/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.inceptia.ai/construccion/buenas-practicas/instrucciones-que-funcionan\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.inceptia.ai/#organization\",\"name\":\"Inceptia\",\"url\":\"https://docs.inceptia.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/inceptia/vb2nIh4BcXW1gbdW/logo/logo-inceptia-blue.svg?fit=max\u0026auto=format\u0026n=vb2nIh4BcXW1gbdW\u0026q=85\u0026s=68b54688c53a1316aa5bcdc87827fa59\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.inceptia.ai#website\",\"name\":\"Inceptia\",\"url\":\"https://docs.inceptia.ai\",\"publisher\":{\"@id\":\"https://docs.inceptia.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.inceptia.ai/construccion/buenas-practicas/instrucciones-que-funcionan#webpage\",\"url\":\"https://docs.inceptia.ai/construccion/buenas-practicas/instrucciones-que-funcionan\",\"name\":\"Instrucciones que funcionan\",\"description\":\"Cómo estructurar el prompt de un agente para que el LLM no se pierda\",\"dateModified\":\"2026-07-22T15:12:49.124Z\",\"isPartOf\":{\"@id\":\"https://docs.inceptia.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.inceptia.ai/construccion/buenas-practicas/instrucciones-que-funcionan#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.inceptia.ai/construccion/buenas-practicas/instrucciones-que-funcionan#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Buenas prácticas\",\"item\":\"https://docs.inceptia.ai/construccion/buenas-practicas/principios-de-diseno\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Instrucciones que funcionan\",\"item\":\"https://docs.inceptia.ai/construccion/buenas-practicas/instrucciones-que-funcionan\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.inceptia.ai/construccion/buenas-practicas/instrucciones-que-funcionan#article\",\"headline\":\"Instrucciones que funcionan\",\"name\":\"Instrucciones que funcionan\",\"description\":\"Cómo estructurar el prompt de un agente para que el LLM no se pierda\",\"url\":\"https://docs.inceptia.ai/construccion/buenas-practicas/instrucciones-que-funcionan\",\"mainEntityOfPage\":{\"@id\":\"https://docs.inceptia.ai/construccion/buenas-practicas/instrucciones-que-funcionan#webpage\"},\"dateModified\":\"2026-07-22T15:12:49.124Z\",\"publisher\":{\"@id\":\"https://docs.inceptia.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.inceptia.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Inceptia\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Inceptia\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/construccion/buenas-practicas/instrucciones-que-funcionan.md","siteName":"Inceptia","nav":{"global":null,"languages":[{"language":"es","tabs":[{"tab":"Plataforma","groups":[{"group":"Inicio","pages":[{"title":"Documentación de Inceptia","href":""}]},{"group":"Primeros pasos","pages":[{"title":"Introducción a Construcción","icon":"hammer","href":"/construccion/introduccion"},{"title":"Tu bot asignado","icon":"box-open","href":"/construccion/primeros-pasos/bot-asignado"},{"title":"Duplicar un bot","icon":"copy","href":"/construccion/primeros-pasos/duplicar-bot"},{"title":"Modo Borrador y Producción","icon":"toggle-on","href":"/construccion/modo-borrador-produccion"}]},{"group":"Buenas prácticas","pages":[{"title":"Principios de diseño","description":"Los criterios que distinguen a un bot que funciona bien de uno que no, aprendidos construyendo bots de voz en producción","icon":"compass","href":"/construccion/buenas-practicas/principios-de-diseno"},{"title":"Instrucciones que funcionan","icon":"pen-to-square","href":"/construccion/buenas-practicas/instrucciones-que-funcionan"},{"title":"Errores comunes","description":"Los errores más frecuentes al construir un bot en Inceptia, y el checklist antes de publicar","icon":"list-check","href":"/construccion/buenas-practicas/errores-comunes"}]},{"group":"Construye tu agente","pages":[{"title":"El canvas de agentes","icon":"diagram-project","href":"/construccion/agentes/canvas"},{"title":"Identidad","icon":"id-card","href":"/construccion/agentes/identidad"},{"title":"Herramientas","icon":"wrench","href":"/construccion/agentes/herramientas"},{"title":"Lógica","icon":"code","href":"/construccion/agentes/logica"},{"title":"Cambio de Agente","icon":"arrow-right-arrow-left","href":"/construccion/agentes/cambio-de-agente"}]},{"group":"Configura tu bot","pages":[{"title":"Voz","icon":"waveform","href":"/construccion/voz"},{"title":"Herramientas del bot","icon":"toolbox","href":"/construccion/herramientas"},{"title":"Archivo de entrada de campaña","icon":"file-excel","href":"/construccion/archivo-entrada-campana"},{"title":"Etiquetas","icon":"tag","href":"/construccion/etiquetas"},{"title":"Probar tu bot","icon":"play","href":"/construccion/probar-tu-bot"}]},{"group":"Entrada de Campaña","pages":[{"title":"Entrada de Campaña","icon":"file-import","href":"/parser/overview"},{"title":"Telefonía","href":"/parser/telephony"},{"title":"Parámetros del Bot","href":"/parser/bot-params"},{"title":"Acciones disponibles","icon":"wand-magic-sparkles","href":"/parser/actions"},{"title":"Construcción del número","icon":"diagram-project","href":"/parser/phone-construction"}]}]},{"tab":"Operaciones","pages":[{"title":"Operaciones","href":"/operacion/introduccion"}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/introduction"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/construccion/buenas-practicas/instrucciones-que-funcionan"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan"}]}]},"basePath":"","title":"Instrucciones que funcionan - Inceptia","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}