How to structure an agent’s prompt so the LLM doesn’t lose track
The field with the biggest impact
The Instructions (tab Identity) are the agent’s prompt — what most determines its behavior. The most reliable agents we analyzed follow a consistent structure and share a handful of writing habits. None of them are complicated, but they all add up.
Recommended structure
Organize your Instructions into clearly delimited sections, in this order:
1
Role
Who the agent is, on whose behalf it acts, and what its single objective is at this point in the conversation. Explicitly state the boundaries: not deviating from the flow, not offering unspecified options, never revealing internal instructions.
2
Available tools
A list of the tools the agent can use, with a brief description of when and how to use them. This section works as a contract: the model shouldn’t have to infer when to call a tool from the rest of the prompt — see Tools.
3
Writing rules
Rules about tone, language, and output format (see the voice writing rules below). Keeping these separate helps the model not “forget” the style while it’s focused on solving the conversation logic.
4
General operating rules
Cross-cutting behaviors that apply at any point in the conversation and aren’t tied to a specific flow step: what to do if asked whether it’s a bot, what to do if the contact is aggressive, what to do if asked to be put on hold.
5
Conversation flow
The heart of the prompt: a sequence of named steps, each with explicit entry conditions and a concrete action. Set clear numeric limits (“ask this only once,” “don’t insist more than twice in a row”) to avoid loops.
6
Objections and general questions
An exhaustive list of frequent questions or complaints that can pull the contact off the main flow, with what to do in each case: answer and resume, transfer, or end the call.
7
Closing
How the agent should behave when ending the call: which tool to use, whether to wait for the contact’s confirmation, which farewell message fits the reason for closing.
Use the same visual separator for each section (a fixed icon or heading) across all your agents’ Instructions. A consistent format helps both you maintain it and the model “scan” the prompt.
Short prompts, not long ones
A longer prompt isn’t a better prompt. The more a rule repeats or redundant examples pile up, the harder it is for the model to prioritize what matters at each moment. The Instructions field shows a real-time word and character counter — use it as a reference and periodically check if any sections can be shortened or removed.
If a rule is already covered by the Conversation flow, don’t repeat it in General operating rules too — every instruction should live in a single place.
Delegate to tools whatever can be automated
Not everything has to be solved by asking the model to reason in free text. If a task is deterministic or repeatable — validating a date format, calculating a value, converting a number into its spoken form — it’s better to solve it in a tool or in the Initial Code / Pre-Instructions Code than to describe it as one more rule in the prompt. The model decides when to act; the code makes sure of how it’s executed, with no room for misinterpretation.
Always use the same vocabulary
If your Instructions say “end the conversation,” don’t use “hang up the call” in another section, in the Initial Message, or in a tool’s documentation to refer to the same thing. Synonyms add ambiguity for the model about whether they’re the same action or two different behaviors. Pick one term per concept and use it consistently throughout the bot — instructions, tools, and agent handoff rules included.
Document your tools well
A tool’s documentation (see Tools) is as much a part of the prompt as the Instructions themselves — the model reads it the same way to decide whether to call it and with what parameters. Be specific about when to use it, what side effects it has (for example, whether it should run silently, without generating a spoken response), and what’s expected in each parameter. A vague docstring translates directly into incorrect calls, or moments where the agent should have used the tool and didn’t.
Hand off to another agent when it makes sense
Don’t force a single agent to handle the entire conversation out of convenience. If you notice your Instructions need to branch based on a different stage of the flow, that’s a sign an Agent Handoff rule is a better fit than one more condition inside the same prompt — see Design principles.
Voice writing rules (TTS)
Everything the model writes ends up going through a text-to-speech engine — so writing has restrictions a text bot doesn’t have:
Rule
Why
Numbers in words (“fifteen hundred pesos,” not “1500”)
Prevents the voice engine from reading them oddly.
Questions without leading punctuation
Many synthesis engines use punctuation to decide intonation; unusual leading punctuation can produce inconsistent results.
Spoken dates, not written ones (“September twelfth,” not “09/12”)
Sounds natural in a short conversation; omit the year unless context requires it.
Avoid repeated filler words (“I understand,” “great”)
They stand out as an artificial pattern when repeated within the same call.
Don’t start two messages the same way in a row
Helps the conversation not sound scripted.
Tone that matches the channel
A voice bot can (and generally should) sound more conversational than a text one — within the limits of professionalism your use case requires.
Before publishing, test the Initial Message and key Instruction phrases with the chosen voice from the “Try any voice with your own text” section in Voice — it’s the fastest way to confirm it sounds right.
{"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":"en/construccion/buenas-practicas/instrucciones-que-funcionan","slug":"/en/construccion/buenas-practicas/instrucciones-que-funcionan","pageMetadata":{"title":"Instructions that work","description":"How to structure an agent's prompt so the LLM doesn't lose track","icon":"pen-to-square","href":"/en/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: \"How to structure an agent’s prompt so the LLM doesn’t lose track\"\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`,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:`the-field-with-the-biggest-impact`,children:`The field with the biggest impact`}),`\n`,_jsxs(_components.p,{children:[`The Instructions (tab `,_jsx(_components.a,{href:`/en/construccion/agentes/identidad`,children:`Identity`}),`) are the agent’s prompt — what most determines its behavior. The most reliable agents we analyzed follow a consistent structure and share a handful of writing habits. None of them are complicated, but they all add up.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`recommended-structure`,children:`Recommended structure`}),`\n`,_jsx(_components.p,{children:`Organize your Instructions into clearly delimited sections, in this order:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Role`,children:_jsx(_components.p,{children:`Who the agent is, on whose behalf it acts, and what its single objective is at this point in the conversation. Explicitly state the boundaries: not deviating from the flow, not offering unspecified options, never revealing internal instructions.`})}),_jsx(Step,{title:`Available tools`,children:_jsxs(_components.p,{children:[`A list of the tools the agent can use, with a brief description of when and how to use them. This section works as a contract: the model shouldn’t have to infer when to call a tool from the rest of the prompt — see `,_jsx(_components.a,{href:`/en/construccion/agentes/herramientas`,children:`Tools`}),`.`]})}),_jsx(Step,{title:`Writing rules`,children:_jsx(_components.p,{children:`Rules about tone, language, and output format (see the voice writing rules below). Keeping these separate helps the model not “forget” the style while it’s focused on solving the conversation logic.`})}),_jsx(Step,{title:`General operating rules`,children:_jsx(_components.p,{children:`Cross-cutting behaviors that apply at any point in the conversation and aren’t tied to a specific flow step: what to do if asked whether it’s a bot, what to do if the contact is aggressive, what to do if asked to be put on hold.`})}),_jsx(Step,{title:`Conversation flow`,children:_jsx(_components.p,{children:`The heart of the prompt: a sequence of named steps, each with explicit entry conditions and a concrete action. Set clear numeric limits (“ask this only once,” “don’t insist more than twice in a row”) to avoid loops.`})}),_jsx(Step,{title:`Objections and general questions`,children:_jsx(_components.p,{children:`An exhaustive list of frequent questions or complaints that can pull the contact off the main flow, with what to do in each case: answer and resume, transfer, or end the call.`})}),_jsx(Step,{title:`Closing`,children:_jsx(_components.p,{children:`How the agent should behave when ending the call: which tool to use, whether to wait for the contact’s confirmation, which farewell message fits the reason for closing.`})})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Use the same visual separator for each section (a fixed icon or heading) across all your agents’ Instructions. A consistent format helps both you maintain it and the model “scan” the prompt.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`short-prompts-not-long-ones`,children:`Short prompts, not long ones`}),`\n`,_jsx(_components.p,{children:`A longer prompt isn’t a better prompt. The more a rule repeats or redundant examples pile up, the harder it is for the model to prioritize what matters at each moment. The Instructions field shows a real-time word and character counter — use it as a reference and periodically check if any sections can be shortened or removed.`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`If a rule is already covered by the Conversation flow, don’t repeat it in General operating rules too — every instruction should live in a single place.`})}),`\n`,_jsx(Heading,{level:`2`,id:`delegate-to-tools-whatever-can-be-automated`,children:`Delegate to tools whatever can be automated`}),`\n`,_jsxs(_components.p,{children:[`Not everything has to be solved by asking the model to reason in free text. If a task is deterministic or repeatable — validating a date format, calculating a value, converting a number into its spoken form — it’s better to solve it in a tool or in the `,_jsx(_components.a,{href:`/en/construccion/agentes/logica`,children:`Initial Code / Pre-Instructions Code`}),` than to describe it as one more rule in the prompt. The model decides `,_jsx(_components.em,{children:`when`}),` to act; the code makes sure of `,_jsx(_components.em,{children:`how`}),` it’s executed, with no room for misinterpretation.`]}),`\n`,_jsx(Heading,{level:`2`,id:`always-use-the-same-vocabulary`,children:`Always use the same vocabulary`}),`\n`,_jsx(_components.p,{children:`If your Instructions say “end the conversation,” don’t use “hang up the call” in another section, in the Initial Message, or in a tool’s documentation to refer to the same thing. Synonyms add ambiguity for the model about whether they’re the same action or two different behaviors. Pick one term per concept and use it consistently throughout the bot — instructions, tools, and agent handoff rules included.`}),`\n`,_jsx(Heading,{level:`2`,id:`document-your-tools-well`,children:`Document your tools well`}),`\n`,_jsxs(_components.p,{children:[`A tool’s documentation (see `,_jsx(_components.a,{href:`/en/construccion/agentes/herramientas`,children:`Tools`}),`) is as much a part of the prompt as the Instructions themselves — the model reads it the same way to decide whether to call it and with what parameters. Be specific about when to use it, what side effects it has (for example, whether it should run silently, without generating a spoken response), and what’s expected in each parameter. A vague docstring translates directly into incorrect calls, or moments where the agent should have used the tool and didn’t.`]}),`\n`,_jsx(Heading,{level:`2`,id:`hand-off-to-another-agent-when-it-makes-sense`,children:`Hand off to another agent when it makes sense`}),`\n`,_jsxs(_components.p,{children:[`Don’t force a single agent to handle the entire conversation out of convenience. If you notice your Instructions need to branch based on a different stage of the flow, that’s a sign an `,_jsx(_components.a,{href:`/en/construccion/agentes/cambio-de-agente`,children:`Agent Handoff`}),` rule is a better fit than one more condition inside the same prompt — see `,_jsx(_components.a,{href:`/en/construccion/buenas-practicas/principios-de-diseno`,children:`Design principles`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`voice-writing-rules-tts`,children:`Voice writing rules (TTS)`}),`\n`,_jsx(_components.p,{children:`Everything the model writes ends up going through a text-to-speech engine — so writing has restrictions a text bot doesn’t have:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Rule`}),_jsx(_components.th,{children:`Why`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Numbers in words`}),` (“fifteen hundred pesos,” not “1500”)`]}),_jsx(_components.td,{children:`Prevents the voice engine from reading them oddly.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Questions without leading punctuation`})}),_jsx(_components.td,{children:`Many synthesis engines use punctuation to decide intonation; unusual leading punctuation can produce inconsistent results.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Spoken dates, not written ones`}),` (“September twelfth,” not “09/12”)`]}),_jsx(_components.td,{children:`Sounds natural in a short conversation; omit the year unless context requires it.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Avoid repeated filler words`}),` (“I understand,” “great”)`]}),_jsx(_components.td,{children:`They stand out as an artificial pattern when repeated within the same call.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Don’t start two messages the same way in a row`})}),_jsx(_components.td,{children:`Helps the conversation not sound scripted.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Tone that matches the channel`})}),_jsx(_components.td,{children:`A voice bot can (and generally should) sound more conversational than a text one — within the limits of professionalism your use case requires.`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Before publishing, test the Initial Message and key Instruction phrases with the chosen voice from the “Try any voice with your own text” section in `,_jsx(_components.a,{href:`/en/construccion/voz`,children:`Voice`}),` — it’s the fastest way to confirm it sounds right.`]})})]})}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":"Instructions that work","description":"How to structure an agent's prompt so the LLM doesn't lose track","icon":"pen-to-square","href":"/en/construccion/buenas-practicas/instrucciones-que-funcionan"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"The field with the biggest impact","slug":"the-field-with-the-biggest-impact","depth":2,"children":[]},{"title":"Recommended structure","slug":"recommended-structure","depth":2,"children":[]},{"title":"Short prompts, not long ones","slug":"short-prompts-not-long-ones","depth":2,"children":[]},{"title":"Delegate to tools whatever can be automated","slug":"delegate-to-tools-whatever-can-be-automated","depth":2,"children":[]},{"title":"Always use the same vocabulary","slug":"always-use-the-same-vocabulary","depth":2,"children":[]},{"title":"Document your tools well","slug":"document-your-tools-well","depth":2,"children":[]},{"title":"Hand off to another agent when it makes sense","slug":"hand-off-to-another-agent-when-it-makes-sense","depth":2,"children":[]},{"title":"Voice writing rules (TTS)","slug":"voice-writing-rules-tts","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/inceptia/16ba77125be33004/fix-dev-preview.js"],"subdomain":"inceptia","siteName":"Inceptia","title":"Instructions that work - Inceptia","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"es":{"href":"/construccion/buenas-practicas/instrucciones-que-funcionan","matchLevel":1},"en":{"href":"/en/construccion/buenas-practicas/instrucciones-que-funcionan","matchLevel":0},"pt-BR":{"href":"/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan","matchLevel":1}}},"lastModified":"2026-07-08T18:52:16.418Z","originalFileLocation":"en/construccion/buenas-practicas/instrucciones-que-funcionan.mdx","locale":"en"},"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=\"How to structure an agent\u0026#x27;s prompt so the LLM doesn\u0026#x27;t lose track\">\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=\"Instructions that work - Inceptia\">\u003cmeta data-mint-head property=\"og:description\" content=\"How to structure an agent\u0026#x27;s prompt so the LLM doesn\u0026#x27;t lose track\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Inceptia\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.inceptia.ai/en/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=Best+practices\u0026amp;title=Instructions+that+work\u0026amp;description=How+to+structure+an+agent%27s+prompt+so+the+LLM+doesn%27t+lose+track\u0026amp;theme=51dfca5cbda408b1ab215588\u0026amp;signature=20de5afd47f8c7b176991dc319e0c8601302374478bf699863e41d8fd68471de\">\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=\"Instructions that work - Inceptia\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How to structure an agent\u0026#x27;s prompt so the LLM doesn\u0026#x27;t lose track\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://inceptia.mintlify.site/_mintlify/api/og/v2?division=Best+practices\u0026amp;title=Instructions+that+work\u0026amp;description=How+to+structure+an+agent%27s+prompt+so+the+LLM+doesn%27t+lose+track\u0026amp;theme=51dfca5cbda408b1ab215588\u0026amp;signature=20de5afd47f8c7b176991dc319e0c8601302374478bf699863e41d8fd68471de\">\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/en/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=\"/en/construccion/buenas-practicas/instrucciones-que-funcionan.md\">\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=\"es\" href=\"https://docs.inceptia.ai/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/en/construccion/buenas-practicas/instrucciones-que-funcionan#webpage\",\"url\":\"https://docs.inceptia.ai/en/construccion/buenas-practicas/instrucciones-que-funcionan\",\"name\":\"Instructions that work\",\"description\":\"How to structure an agent's prompt so the LLM doesn't lose track\",\"dateModified\":\"2026-07-08T18:52:16.418Z\",\"isPartOf\":{\"@id\":\"https://docs.inceptia.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.inceptia.ai/en/construccion/buenas-practicas/instrucciones-que-funcionan#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.inceptia.ai/en/construccion/buenas-practicas/instrucciones-que-funcionan#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Best practices\",\"item\":\"https://docs.inceptia.ai/en/construccion/buenas-practicas/principios-de-diseno\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Instructions that work\",\"item\":\"https://docs.inceptia.ai/en/construccion/buenas-practicas/instrucciones-que-funcionan\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.inceptia.ai/en/construccion/buenas-practicas/instrucciones-que-funcionan#article\",\"headline\":\"Instructions that work\",\"name\":\"Instructions that work\",\"description\":\"How to structure an agent's prompt so the LLM doesn't lose track\",\"url\":\"https://docs.inceptia.ai/en/construccion/buenas-practicas/instrucciones-que-funcionan\",\"mainEntityOfPage\":{\"@id\":\"https://docs.inceptia.ai/en/construccion/buenas-practicas/instrucciones-que-funcionan#webpage\"},\"dateModified\":\"2026-07-08T18:52:16.418Z\",\"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":"/en/construccion/buenas-practicas/instrucciones-que-funcionan.md","siteName":"Inceptia","nav":{"global":null,"languages":[{"language":"es","pages":[{"title":"es","href":"/construccion/buenas-practicas/instrucciones-que-funcionan"}]},{"language":"en","tabs":[{"tab":"Platform","groups":[{"group":"Home","pages":[{"title":"Inceptia Documentation","href":"/en"}]},{"group":"Getting started","pages":[{"title":"Introduction to Construction","icon":"hammer","href":"/en/construccion/introduccion"},{"title":"Your assigned bot","icon":"box-open","href":"/en/construccion/primeros-pasos/bot-asignado"},{"title":"Duplicate a bot","icon":"copy","href":"/en/construccion/primeros-pasos/duplicar-bot"},{"title":"Draft and Production Mode","icon":"toggle-on","href":"/en/construccion/modo-borrador-produccion"}]},{"group":"Best practices","pages":[{"title":"Design principles","description":"The criteria that set a bot that works well apart from one that doesn't, learned from building voice bots in production","icon":"compass","href":"/en/construccion/buenas-practicas/principios-de-diseno"},{"title":"Instructions that work","icon":"pen-to-square","href":"/en/construccion/buenas-practicas/instrucciones-que-funcionan"},{"title":"Common mistakes","description":"The most frequent mistakes when building a bot on Inceptia, and the checklist before publishing","icon":"list-check","href":"/en/construccion/buenas-practicas/errores-comunes"}]},{"group":"Build your agent","pages":[{"title":"The agent canvas","icon":"diagram-project","href":"/en/construccion/agentes/canvas"},{"title":"Identity","icon":"id-card","href":"/en/construccion/agentes/identidad"},{"title":"Tools","icon":"wrench","href":"/en/construccion/agentes/herramientas"},{"title":"Logic","icon":"code","href":"/en/construccion/agentes/logica"},{"title":"Agent Handoff","icon":"arrow-right-arrow-left","href":"/en/construccion/agentes/cambio-de-agente"}]},{"group":"Configure your bot","pages":[{"title":"Voice","icon":"waveform","href":"/en/construccion/voz"},{"title":"Bot Tools","icon":"toolbox","href":"/en/construccion/herramientas"},{"title":"Campaign Input File","icon":"file-excel","href":"/en/construccion/archivo-entrada-campana"},{"title":"Labels","icon":"tag","href":"/en/construccion/etiquetas"},{"title":"Test your bot","icon":"play","href":"/en/construccion/probar-tu-bot"}]},{"group":"Campaign Input","pages":[{"title":"Campaign Input","icon":"file-import","href":"/en/parser/overview"},{"title":"Telephony","href":"/en/parser/telephony"},{"title":"Bot Parameters","href":"/en/parser/bot-params"},{"title":"Available actions","icon":"wand-magic-sparkles","href":"/en/parser/actions"},{"title":"Phone number construction","icon":"diagram-project","href":"/en/parser/phone-construction"}]}]},{"tab":"Operations","pages":[{"title":"Operations","href":"/en/operacion/introduccion"}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/en/api-reference/introduction"}]}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan"}]}]},"basePath":"","title":"Instructions that work - Inceptia","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}