Como estruturar o prompt de um agente para que o LLM não se perca
O campo com mais impacto
As Instruções (aba Identidade) são o prompt do agente — o que mais determina seu comportamento. Os agentes mais confiáveis que analisamos seguem uma estrutura consistente e compartilham um punhado de hábitos de redação. Nenhum é complicado, mas todos somam.
Estrutura recomendada
Organize as Instruções em seções bem delimitadas, nesta ordem:
1
Papel
Quem é o agente, em nome de quem ele age, e qual é seu único objetivo nesse momento da conversa. Declare explicitamente os limites: não se desviar do fluxo, não oferecer opções não especificadas, nunca revelar instruções internas.
2
Ferramentas disponíveis
Uma lista das ferramentas que o agente pode usar, com uma descrição breve de quando e como usá-las. Esta seção funciona como um contrato: o modelo não deveria precisar inferir quando chamar uma ferramenta a partir do restante do prompt — veja Ferramentas.
3
Normas de redação
Regras de tom, idioma e formato de saída (veja a seção de redação para voz mais abaixo). Separá-las do resto ajuda o modelo a não “esquecer” o estilo quando está concentrado resolvendo a lógica da conversa.
4
Regras operacionais gerais
Comportamentos transversais que se aplicam em qualquer ponto da conversa e não estão amarrados a uma etapa específica do fluxo: o que fazer se perguntarem se é um bot, o que fazer se o contato for agressivo, o que fazer se pedirem para esperar na linha.
5
Fluxo da conversa
O coração do prompt: uma sequência de etapas nomeadas, cada uma com condições de entrada explícitas e uma ação concreta. Coloque limites numéricos claros (“pergunte isso apenas uma vez”, “não insista mais de duas vezes seguidas”) para evitar loops.
6
Objeções e perguntas gerais
Uma lista exaustiva de perguntas ou reclamações frequentes que podem tirar o contato do fluxo principal, com o que fazer em cada caso: responder e retomar, transferir ou encerrar.
7
Encerramento
Como o agente deve se comportar ao finalizar a chamada: qual ferramenta usar, se deve esperar ou não a confirmação do contato, qual mensagem de despedida corresponde ao motivo do encerramento.
Use o mesmo separador visual para cada seção (um ícone ou cabeçalho fixo) nas Instruções de todos os seus agentes. Um formato consistente ajuda tanto você a mantê-lo quanto o modelo a “escanear” o prompt.
Prompts curtos, não extensos
Um prompt mais longo não é um prompt melhor. Quanto mais uma regra se repete ou se acumulam exemplos redundantes, mais difícil fica para o modelo priorizar o que importa em cada momento. O campo Instruções mostra um contador de palavras e caracteres em tempo real — use-o como referência e revise periodicamente se há seções que podem ser resumidas ou removidas.
Se uma regra já está coberta pelo Fluxo da conversa, não a repita também em Regras operacionais gerais — cada instrução deveria viver em um único lugar.
Delegue às ferramentas o que pode ser automatizado
Nem tudo precisa ser resolvido pedindo ao modelo que raciocine em texto livre. Se uma tarefa é determinística ou repetível — validar o formato de uma data, calcular um valor, converter um número para sua forma falada — é melhor resolvê-la em uma ferramenta ou no Código Inicial / Pré-Instruções do que descrevê-la como mais uma regra do prompt. O modelo decide quando agir; o código garante como é executado, sem margem para erro de interpretação.
Use sempre o mesmo vocabulário
Se suas Instruções dizem “encerrar a conversa”, não use “desligar a chamada” em outra seção, na Mensagem Inicial ou na documentação de uma ferramenta para se referir à mesma coisa. Os sinônimos somam ambiguidade para o modelo sobre se são a mesma ação ou dois comportamentos distintos. Escolha um termo por conceito e use-o de forma consistente em todo o bot — instruções, ferramentas e regras de mudança de agente incluídas.
Documente bem suas ferramentas
A documentação de cada ferramenta (veja Ferramentas) é tão parte do prompt quanto as próprias Instruções — o modelo a lê da mesma forma para decidir se deve chamá-la e com quais parâmetros. Seja específico sobre quando usá-la, quais efeitos ela tem (por exemplo, se deve ser executada em silêncio, sem gerar uma resposta falada) e o que se espera em cada parâmetro. Um docstring vago se traduz diretamente em chamadas incorretas, ou em momentos em que o agente deveria ter usado a ferramenta e não usou.
Mude de agente quando fizer sentido
Não force um único agente a lidar com toda a conversa por comodidade. Se você perceber que as Instruções precisam se ramificar de acordo com uma etapa diferente do fluxo, é sinal de que uma regra de Mudança de Agente é mais adequada do que mais uma condição dentro do mesmo prompt — veja Princípios de design.
Regras de redação para voz (TTS)
Tudo o que o modelo escreve acaba passando por um motor de texto para voz — então a redação tem restrições que um bot de texto não tem:
Regra
Por quê
Números por extenso (“mil e quinhentos reais”, não “1500”)
Evita que o motor de voz os leia de forma estranha.
Perguntas sem pontuação de abertura incomum
Muitos motores de síntese usam a pontuação para decidir a entonação; pontuação de abertura fora do padrão pode gerar resultados inconsistentes.
Datas faladas, não escritas (“doze de setembro”, não “12/09”)
Soa natural em uma conversa de curta duração; omita o ano a menos que o contexto exija.
Evite vícios de linguagem repetidos (“entendo”, “perfeito”)
Se destacam como um padrão artificial quando se repetem na mesma chamada.
Não comece duas mensagens seguidas da mesma forma
Ajuda a conversa a não soar roteirizada.
Tom de acordo com o canal
Um bot de voz pode (e geralmente deve) soar mais coloquial do que um de texto — dentro dos limites de profissionalismo que seu caso de uso exigir.
Antes de publicar, teste a Mensagem Inicial e frases-chave das Instruções com a voz escolhida na seção “Teste cada voz com seu próprio texto” em Voz — é a forma mais rápida de confirmar que soa bem.
{"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":"pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan","slug":"/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan","pageMetadata":{"title":"Instruções que funcionam","description":"Como estruturar o prompt de um agente para que o LLM não se perca","icon":"pen-to-square","href":"/pt-BR/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: \"Como estruturar o prompt de um agente para que o LLM não se perca\"\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:`o-campo-com-mais-impacto`,children:`O campo com mais impacto`}),`\n`,_jsxs(_components.p,{children:[`As Instruções (aba `,_jsx(_components.a,{href:`/pt-BR/construccion/agentes/identidad`,children:`Identidade`}),`) são o prompt do agente — o que mais determina seu comportamento. Os agentes mais confiáveis que analisamos seguem uma estrutura consistente e compartilham um punhado de hábitos de redação. Nenhum é complicado, mas todos somam.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`estrutura-recomendada`,children:`Estrutura recomendada`}),`\n`,_jsx(_components.p,{children:`Organize as Instruções em seções bem delimitadas, nesta ordem:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Papel`,children:_jsx(_components.p,{children:`Quem é o agente, em nome de quem ele age, e qual é seu único objetivo nesse momento da conversa. Declare explicitamente os limites: não se desviar do fluxo, não oferecer opções não especificadas, nunca revelar instruções internas.`})}),_jsx(Step,{title:`Ferramentas disponíveis`,children:_jsxs(_components.p,{children:[`Uma lista das ferramentas que o agente pode usar, com uma descrição breve de quando e como usá-las. Esta seção funciona como um contrato: o modelo não deveria precisar inferir quando chamar uma ferramenta a partir do restante do prompt — veja `,_jsx(_components.a,{href:`/pt-BR/construccion/agentes/herramientas`,children:`Ferramentas`}),`.`]})}),_jsx(Step,{title:`Normas de redação`,children:_jsx(_components.p,{children:`Regras de tom, idioma e formato de saída (veja a seção de redação para voz mais abaixo). Separá-las do resto ajuda o modelo a não “esquecer” o estilo quando está concentrado resolvendo a lógica da conversa.`})}),_jsx(Step,{title:`Regras operacionais gerais`,children:_jsx(_components.p,{children:`Comportamentos transversais que se aplicam em qualquer ponto da conversa e não estão amarrados a uma etapa específica do fluxo: o que fazer se perguntarem se é um bot, o que fazer se o contato for agressivo, o que fazer se pedirem para esperar na linha.`})}),_jsx(Step,{title:`Fluxo da conversa`,children:_jsx(_components.p,{children:`O coração do prompt: uma sequência de etapas nomeadas, cada uma com condições de entrada explícitas e uma ação concreta. Coloque limites numéricos claros (“pergunte isso apenas uma vez”, “não insista mais de duas vezes seguidas”) para evitar loops.`})}),_jsx(Step,{title:`Objeções e perguntas gerais`,children:_jsx(_components.p,{children:`Uma lista exaustiva de perguntas ou reclamações frequentes que podem tirar o contato do fluxo principal, com o que fazer em cada caso: responder e retomar, transferir ou encerrar.`})}),_jsx(Step,{title:`Encerramento`,children:_jsx(_components.p,{children:`Como o agente deve se comportar ao finalizar a chamada: qual ferramenta usar, se deve esperar ou não a confirmação do contato, qual mensagem de despedida corresponde ao motivo do encerramento.`})})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Use o mesmo separador visual para cada seção (um ícone ou cabeçalho fixo) nas Instruções de todos os seus agentes. Um formato consistente ajuda tanto você a mantê-lo quanto o modelo a “escanear” o prompt.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`prompts-curtos-não-extensos`,children:`Prompts curtos, não extensos`}),`\n`,_jsx(_components.p,{children:`Um prompt mais longo não é um prompt melhor. Quanto mais uma regra se repete ou se acumulam exemplos redundantes, mais difícil fica para o modelo priorizar o que importa em cada momento. O campo Instruções mostra um contador de palavras e caracteres em tempo real — use-o como referência e revise periodicamente se há seções que podem ser resumidas ou removidas.`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Se uma regra já está coberta pelo Fluxo da conversa, não a repita também em Regras operacionais gerais — cada instrução deveria viver em um único lugar.`})}),`\n`,_jsx(Heading,{level:`2`,id:`delegue-às-ferramentas-o-que-pode-ser-automatizado`,children:`Delegue às ferramentas o que pode ser automatizado`}),`\n`,_jsxs(_components.p,{children:[`Nem tudo precisa ser resolvido pedindo ao modelo que raciocine em texto livre. Se uma tarefa é determinística ou repetível — validar o formato de uma data, calcular um valor, converter um número para sua forma falada — é melhor resolvê-la em uma ferramenta ou no `,_jsx(_components.a,{href:`/pt-BR/construccion/agentes/logica`,children:`Código Inicial / Pré-Instruções`}),` do que descrevê-la como mais uma regra do prompt. O modelo decide `,_jsx(_components.em,{children:`quando`}),` agir; o código garante `,_jsx(_components.em,{children:`como`}),` é executado, sem margem para erro de interpretação.`]}),`\n`,_jsx(Heading,{level:`2`,id:`use-sempre-o-mesmo-vocabulário`,children:`Use sempre o mesmo vocabulário`}),`\n`,_jsx(_components.p,{children:`Se suas Instruções dizem “encerrar a conversa”, não use “desligar a chamada” em outra seção, na Mensagem Inicial ou na documentação de uma ferramenta para se referir à mesma coisa. Os sinônimos somam ambiguidade para o modelo sobre se são a mesma ação ou dois comportamentos distintos. Escolha um termo por conceito e use-o de forma consistente em todo o bot — instruções, ferramentas e regras de mudança de agente incluídas.`}),`\n`,_jsx(Heading,{level:`2`,id:`documente-bem-suas-ferramentas`,children:`Documente bem suas ferramentas`}),`\n`,_jsxs(_components.p,{children:[`A documentação de cada ferramenta (veja `,_jsx(_components.a,{href:`/pt-BR/construccion/agentes/herramientas`,children:`Ferramentas`}),`) é tão parte do prompt quanto as próprias Instruções — o modelo a lê da mesma forma para decidir se deve chamá-la e com quais parâmetros. Seja específico sobre quando usá-la, quais efeitos ela tem (por exemplo, se deve ser executada em silêncio, sem gerar uma resposta falada) e o que se espera em cada parâmetro. Um docstring vago se traduz diretamente em chamadas incorretas, ou em momentos em que o agente deveria ter usado a ferramenta e não usou.`]}),`\n`,_jsx(Heading,{level:`2`,id:`mude-de-agente-quando-fizer-sentido`,children:`Mude de agente quando fizer sentido`}),`\n`,_jsxs(_components.p,{children:[`Não force um único agente a lidar com toda a conversa por comodidade. Se você perceber que as Instruções precisam se ramificar de acordo com uma etapa diferente do fluxo, é sinal de que uma regra de `,_jsx(_components.a,{href:`/pt-BR/construccion/agentes/cambio-de-agente`,children:`Mudança de Agente`}),` é mais adequada do que mais uma condição dentro do mesmo prompt — veja `,_jsx(_components.a,{href:`/pt-BR/construccion/buenas-practicas/principios-de-diseno`,children:`Princípios de design`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`regras-de-redação-para-voz-tts`,children:`Regras de redação para voz (TTS)`}),`\n`,_jsx(_components.p,{children:`Tudo o que o modelo escreve acaba passando por um motor de texto para voz — então a redação tem restrições que um bot de texto não tem:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Regra`}),_jsx(_components.th,{children:`Por quê`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Números por extenso`}),` (“mil e quinhentos reais”, não “1500”)`]}),_jsx(_components.td,{children:`Evita que o motor de voz os leia de forma estranha.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Perguntas sem pontuação de abertura incomum`})}),_jsx(_components.td,{children:`Muitos motores de síntese usam a pontuação para decidir a entonação; pontuação de abertura fora do padrão pode gerar resultados inconsistentes.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Datas faladas, não escritas`}),` (“doze de setembro”, não “12/09”)`]}),_jsx(_components.td,{children:`Soa natural em uma conversa de curta duração; omita o ano a menos que o contexto exija.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Evite vícios de linguagem repetidos`}),` (“entendo”, “perfeito”)`]}),_jsx(_components.td,{children:`Se destacam como um padrão artificial quando se repetem na mesma chamada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Não comece duas mensagens seguidas da mesma forma`})}),_jsx(_components.td,{children:`Ajuda a conversa a não soar roteirizada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Tom de acordo com o canal`})}),_jsx(_components.td,{children:`Um bot de voz pode (e geralmente deve) soar mais coloquial do que um de texto — dentro dos limites de profissionalismo que seu caso de uso exigir.`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Antes de publicar, teste a Mensagem Inicial e frases-chave das Instruções com a voz escolhida na seção “Teste cada voz com seu próprio texto” em `,_jsx(_components.a,{href:`/pt-BR/construccion/voz`,children:`Voz`}),` — é a forma mais rápida de confirmar que soa bem.`]})})]})}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":"Instruções que funcionam","description":"Como estruturar o prompt de um agente para que o LLM não se perca","icon":"pen-to-square","href":"/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"O campo com mais impacto","slug":"o-campo-com-mais-impacto","depth":2,"children":[]},{"title":"Estrutura recomendada","slug":"estrutura-recomendada","depth":2,"children":[]},{"title":"Prompts curtos, não extensos","slug":"prompts-curtos-não-extensos","depth":2,"children":[]},{"title":"Delegue às ferramentas o que pode ser automatizado","slug":"delegue-às-ferramentas-o-que-pode-ser-automatizado","depth":2,"children":[]},{"title":"Use sempre o mesmo vocabulário","slug":"use-sempre-o-mesmo-vocabulário","depth":2,"children":[]},{"title":"Documente bem suas ferramentas","slug":"documente-bem-suas-ferramentas","depth":2,"children":[]},{"title":"Mude de agente quando fizer sentido","slug":"mude-de-agente-quando-fizer-sentido","depth":2,"children":[]},{"title":"Regras de redação para voz (TTS)","slug":"regras-de-redação-para-voz-tts","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/inceptia/16ba77125be33004/fix-dev-preview.js"],"subdomain":"inceptia","siteName":"Inceptia","title":"Instruções que funcionam - Inceptia","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"es":{"href":"/construccion/buenas-practicas/instrucciones-que-funcionan","matchLevel":1},"en":{"href":"/en/construccion/buenas-practicas/instrucciones-que-funcionan","matchLevel":1},"pt-BR":{"href":"/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan","matchLevel":0}}},"lastModified":"2026-07-08T18:52:17.936Z","originalFileLocation":"pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan.mdx","locale":"pt-BR"},"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=\"Como estruturar o prompt de um agente para que o LLM não se perca\">\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=\"Instruções que funcionam - Inceptia\">\u003cmeta data-mint-head property=\"og:description\" content=\"Como estruturar o prompt de um agente para que o LLM não se perca\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Inceptia\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.inceptia.ai/pt-BR/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=Boas+pr%C3%A1ticas\u0026amp;title=Instru%C3%A7%C3%B5es+que+funcionam\u0026amp;description=Como+estruturar+o+prompt+de+um+agente+para+que+o+LLM+n%C3%A3o+se+perca\u0026amp;theme=51dfca5cbda408b1ab215588\u0026amp;signature=9629dccc95e6889c907e936791eceb92ecfd89593731b5768949eefc83de0e6e\">\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=\"Instruções que funcionam - Inceptia\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Como estruturar o prompt de um agente para que o LLM não se perca\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://inceptia.mintlify.site/_mintlify/api/og/v2?division=Boas+pr%C3%A1ticas\u0026amp;title=Instru%C3%A7%C3%B5es+que+funcionam\u0026amp;description=Como+estruturar+o+prompt+de+um+agente+para+que+o+LLM+n%C3%A3o+se+perca\u0026amp;theme=51dfca5cbda408b1ab215588\u0026amp;signature=9629dccc95e6889c907e936791eceb92ecfd89593731b5768949eefc83de0e6e\">\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/pt-BR/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=\"/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan.md\">\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=\"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=\"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/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan#webpage\",\"url\":\"https://docs.inceptia.ai/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan\",\"name\":\"Instruções que funcionam\",\"description\":\"Como estruturar o prompt de um agente para que o LLM não se perca\",\"dateModified\":\"2026-07-08T18:52:17.936Z\",\"isPartOf\":{\"@id\":\"https://docs.inceptia.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.inceptia.ai/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.inceptia.ai/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Boas práticas\",\"item\":\"https://docs.inceptia.ai/pt-BR/construccion/buenas-practicas/principios-de-diseno\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Instruções que funcionam\",\"item\":\"https://docs.inceptia.ai/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.inceptia.ai/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan#article\",\"headline\":\"Instruções que funcionam\",\"name\":\"Instruções que funcionam\",\"description\":\"Como estruturar o prompt de um agente para que o LLM não se perca\",\"url\":\"https://docs.inceptia.ai/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan\",\"mainEntityOfPage\":{\"@id\":\"https://docs.inceptia.ai/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan#webpage\"},\"dateModified\":\"2026-07-08T18:52:17.936Z\",\"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":"/pt-BR/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","pages":[{"title":"en","href":"/en/construccion/buenas-practicas/instrucciones-que-funcionan"}]},{"language":"pt-BR","tabs":[{"tab":"Plataforma","groups":[{"group":"Início","pages":[{"title":"Documentação da Inceptia","href":"/pt-BR"}]},{"group":"Primeiros passos","pages":[{"title":"Introdução à Construção","icon":"hammer","href":"/pt-BR/construccion/introduccion"},{"title":"Seu bot atribuído","icon":"box-open","href":"/pt-BR/construccion/primeros-pasos/bot-asignado"},{"title":"Duplicar um bot","icon":"copy","href":"/pt-BR/construccion/primeros-pasos/duplicar-bot"},{"title":"Modo Rascunho e Produção","icon":"toggle-on","href":"/pt-BR/construccion/modo-borrador-produccion"}]},{"group":"Boas práticas","pages":[{"title":"Princípios de design","description":"Os critérios que diferenciam um bot que funciona bem de um que não funciona, aprendidos construindo bots de voz em produção","icon":"compass","href":"/pt-BR/construccion/buenas-practicas/principios-de-diseno"},{"title":"Instruções que funcionam","icon":"pen-to-square","href":"/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan"},{"title":"Erros comuns","description":"Os erros mais frequentes ao construir um bot na Inceptia, e o checklist antes de publicar","icon":"list-check","href":"/pt-BR/construccion/buenas-practicas/errores-comunes"}]},{"group":"Construa seu agente","pages":[{"title":"O canvas de agentes","icon":"diagram-project","href":"/pt-BR/construccion/agentes/canvas"},{"title":"Identidade","icon":"id-card","href":"/pt-BR/construccion/agentes/identidad"},{"title":"Ferramentas","icon":"wrench","href":"/pt-BR/construccion/agentes/herramientas"},{"title":"Lógica","icon":"code","href":"/pt-BR/construccion/agentes/logica"},{"title":"Mudança de Agente","icon":"arrow-right-arrow-left","href":"/pt-BR/construccion/agentes/cambio-de-agente"}]},{"group":"Configure seu bot","pages":[{"title":"Voz","icon":"waveform","href":"/pt-BR/construccion/voz"},{"title":"Ferramentas do bot","icon":"toolbox","href":"/pt-BR/construccion/herramientas"},{"title":"Arquivo de entrada de campanha","icon":"file-excel","href":"/pt-BR/construccion/archivo-entrada-campana"},{"title":"Rótulos","icon":"tag","href":"/pt-BR/construccion/etiquetas"},{"title":"Testar seu bot","icon":"play","href":"/pt-BR/construccion/probar-tu-bot"}]},{"group":"Entrada de Campanha","pages":[{"title":"Entrada de Campanha","icon":"file-import","href":"/pt-BR/parser/overview"},{"title":"Telefonia","href":"/pt-BR/parser/telephony"},{"title":"Parâmetros do Bot","href":"/pt-BR/parser/bot-params"},{"title":"Ações disponíveis","icon":"wand-magic-sparkles","href":"/pt-BR/parser/actions"},{"title":"Construção do número","icon":"diagram-project","href":"/pt-BR/parser/phone-construction"}]}]},{"tab":"Operações","pages":[{"title":"Operações","href":"/pt-BR/operacion/introduccion"}]},{"tab":"Referência da API","pages":[{"title":"Referência da API","href":"/pt-BR/api-reference/introduction"}]}]}]},"basePath":"","title":"Instruções que funcionam - Inceptia","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}