Guia de prompting
Princípios de design de sistemas para IA conversacional pronta para produção
Introdução
Prompts eficazes transformam os ElevenLabs Agents de robóticos em realistas.

Um prompt de sistema é o projeto da personalidade e das políticas do seu agente de IA. No uso empresarial, ele tende a ser elaborado — definindo o papel, os objetivos e as ferramentas permitidas do agente, instruções passo a passo para certas tarefas e diretrizes que descrevem o que o agente não deve fazer. A forma como você estrutura esse prompt afeta diretamente a confiabilidade.
O prompt de sistema controla o comportamento conversacional e o estilo de resposta, mas não controla mecanismos do fluxo de conversa, como a alternância de turnos, nem configurações do agente, como os idiomas que ele pode falar. Esses aspectos são gerenciados no nível da plataforma.
O servidor MCP hospedado permite que Claude e outros clientes MCP leiam e atualizem diretamente o prompt de sistema de um agente, para que você possa criar, revisar e aprimorar prompts de forma conversacional.

Fundamentos de engenharia de prompts
Um prompt de sistema é o projeto da personalidade e das políticas do seu agente de IA. No uso empresarial, ele tende a ser elaborado — definindo o papel, os objetivos e as ferramentas permitidas do agente, instruções passo a passo para certas tarefas e diretrizes que descrevem o que o agente não deve fazer. A forma como você estrutura esse prompt afeta diretamente a confiabilidade.
Os princípios a seguir formam a base da engenharia de prompts pronta para produção:
Separe as instruções em seções claras
Separar as instruções em seções dedicadas com títulos em markdown ajuda o modelo a priorizá-las e interpretá-las corretamente. Use espaços em branco e quebras de linha para separar as instruções.
Por que isso importa para a confiabilidade: os modelos são ajustados para dar atenção extra a determinados títulos (especialmente # Guardrails), e limites claros entre seções evitam o vazamento de instruções, em que regras de um contexto afetam outro.
Seja o mais conciso possível
Mantenha todas as instruções curtas, claras e orientadas à ação. Remova palavras de preenchimento e repita apenas o que for essencial para o modelo agir corretamente.
Por que isso importa para a confiabilidade: instruções concisas reduzem a ambiguidade e o uso de tokens. Cada palavra desnecessária é uma possível fonte de interpretação incorreta.
Se você precisar que o agente mantenha um tom específico, defina-o de forma explícita e concisa na seção # Personality ou # Tone. Evite repetir orientações de tom ao longo do prompt.
Dê ênfase às instruções críticas
Destaque etapas críticas adicionando “Esta etapa é importante” ao final da linha. Repetir duas vezes no prompt as 1 ou 2 instruções mais importantes pode ajudar a reforçá-las.
Por que isso importa para a confiabilidade: em prompts complexos, os modelos podem priorizar o contexto recente em vez de instruções anteriores. A ênfase e a repetição garantem que regras críticas não sejam ignoradas.
Normalização de texto
Os modelos de conversão de texto em fala, especialmente os mais rápidos, têm melhor desempenho ao gerar fala a partir de texto alfabético. Por isso, dígitos e símbolos como ”@” ou ”£” têm maior probabilidade de causar pronúncias incorretas ou alucinações de voz.
Para resolver isso, normalizamos textos não alfabéticos em palavras antes que cheguem ao modelo de TTS (por exemplo, 123 -> one-hundred and twenty three, john@gmail.com -> john at gmail dot com) e permitimos que você escolha entre diferentes estratégias de normalização, com diferentes vantagens e desvantagens.
Estratégias de normalização
Oferecemos duas estratégias de normalização por meio da configuração de agente text_normalisation_type:
system_prompt (padrão) — Adiciona instruções ao prompt de sistema para que o LLM escreva números e símbolos por extenso antes que o texto chegue ao modelo de TTS.
- Sem latência adicional
- Os LLMs podem ocasionalmente não normalizar corretamente
- As transcrições contêm tudo escrito por extenso (por exemplo, “one thousand dollars” em vez de “$1,000”)
Se você não quiser usar o normalizador de TTS e perceber que o LLM ainda responde ocasionalmente com texto não normalizado, considere usar um LLM mais inteligente ou adicionar instruções extras de normalização ao prompt de sistema.
elevenlabs — Usa nosso normalizador de TTS para normalizar o texto após a geração pelo LLM, antes que ele chegue ao modelo de TTS.
- Mais confiável do que a normalização baseada em LLM
- O prompt de sistema não é modificado
- As transcrições mantêm a formatação natural com símbolos e números (por exemplo, “$1,000”)
- Adiciona pouca latência
Se a legibilidade da transcrição for importante para seu caso de uso, considere usar o normalizador elevenlabs. Ele
mantém as transcrições limpas, com símbolos e números naturais, sem deixar de produzir
áudio falado corretamente.
Encontre essa configuração na nossa plataforma, na aba “Agent”, clicando no ícone de engrenagem na seção “Voices” para abrir o painel de configurações comuns de voz e configurá-la na parte inferior.
Dados estruturados para entradas de ferramentas
Ao usar a configuração de normalização system_prompt, o LLM escreve símbolos e números por extenso nas respostas (por exemplo, john at gmail dot com em vez de john@gmail.com). As transcrições do usuário obtidas por conversão de fala em texto também podem chegar em um formato não padrão. Isso significa que, ao usar esses dados como parâmetros em chamadas de ferramenta, o LLM pode usar a versão não estruturada presente no contexto da conversa.
Se um parâmetro de ferramenta espera um valor corretamente formatado (por exemplo, john@gmail.com, e não john at gmail dot com), o LLM precisa saber disso. Inclua o formato esperado diretamente na descrição do parâmetro da ferramenta, com um exemplo.
Dedique uma seção a diretrizes
Liste todas as regras inegociáveis que o modelo deve sempre seguir em uma seção dedicada # Guardrails. Os modelos são ajustados para dar atenção extra a esse título.
Por que isso importa para a confiabilidade: as diretrizes evitam respostas inadequadas e garantem a conformidade com as políticas. Centralizá-las em uma seção dedicada facilita sua auditoria e atualização.
Para saber mais sobre como criar diretrizes eficazes, consulte nosso guia sobre Diretrizes.
Configuração de ferramentas para confiabilidade
Agentes capazes de lidar com workflows transacionais podem ser muito eficazes. Para isso, eles precisam estar equipados com ferramentas que permitam realizar ações em outros sistemas ou buscar dados atualizados nesses sistemas.
Tão importante quanto a estrutura do prompt é a forma como você descreve as ferramentas disponíveis para seu agente. Definições de ferramentas claras e orientadas à ação ajudam o modelo a utilizá-las corretamente e a se recuperar de erros sem problemas.
Descreva as ferramentas com precisão e parâmetros detalhados
Ao criar uma ferramenta, adicione descrições a todos os parâmetros. Isso ajuda o LLM a construir chamadas de ferramenta com precisão.
Descrição da ferramenta: “Busca o status do pedido de um cliente pelo ID do pedido e retorna o status atual, a data estimada de entrega e o número de rastreamento.”
Descrições dos parâmetros:
order_id(obrigatório): “O identificador exclusivo do pedido, formatado com caracteres escritos (por exemplo, ‘ORD123456’)”include_history(opcional): “Se verdadeiro, retorna o histórico completo do pedido, incluindo mudanças de status”
Por que isso importa para a confiabilidade: as descrições dos parâmetros funcionam como documentação embutida para o modelo. Elas esclarecem expectativas de formato, campos obrigatórios versus opcionais e valores aceitos.
Explique quando e como usar cada ferramenta no prompt de sistema
Defina claramente no prompt de sistema quando e como cada ferramenta deve ser usada. Não dependa apenas das descrições das ferramentas — forneça contexto de uso e lógica de sequência.
Especifique os formatos esperados nas descrições dos parâmetros de ferramentas
Quando as ferramentas exigirem identificadores estruturados (e-mails, números de telefone, códigos), deixe explícito o formato esperado na descrição do parâmetro, com um exemplo. Isso é especialmente importante porque a normalização e a transcrição de fala em texto podem produzir valores no formato falado no contexto da conversa. Consulte dados estruturados para entradas de ferramentas para mais contexto.
Lide com falhas de chamadas de ferramenta sem problemas
Às vezes, as ferramentas podem falhar devido a problemas de rede, dados ausentes ou outros erros. Inclua instruções claras de recuperação no prompt de sistema.
Por que isso importa para a confiabilidade: falhas de ferramentas são inevitáveis em produção. Sem instruções explícitas de tratamento, os agentes podem alucinar respostas ou fornecer informações incorretas.
Para orientações detalhadas sobre como criar integrações confiáveis de ferramentas, consulte nossa documentação sobre Ferramentas de cliente, Ferramentas de webhook e Ferramentas MCP.
Padrões de arquitetura para agentes empresariais
Embora prompts e ferramentas robustos formem a base da confiabilidade dos agentes, sistemas de produção exigem um design arquitetural cuidadoso. Agentes empresariais lidam com workflows complexos que muitas vezes excedem o escopo de um único prompt monolítico.
Mantenha os agentes especializados
Instruções excessivamente amplas ou janelas de contexto grandes aumentam a latência e reduzem a precisão. Cada agente deve ter uma base de conhecimento e um conjunto de responsabilidades restritos e claramente definidos.
Por que isso importa para a confiabilidade: agentes especializados têm menos casos extremos para lidar, critérios de sucesso mais claros e tempos de resposta mais rápidos. Eles são mais fáceis de testar, depurar e melhorar.
Um agente genérico que “faz tudo” é mais difícil de manter e tem maior probabilidade de falhar em produção do que uma rede de agentes especializados com transferências claras.
Use padrões de orquestrador e especialistas
Para tarefas complexas, crie workflows com vários agentes que transfiram tarefas entre agentes especializados — e para operadores humanos quando necessário.
Padrão de arquitetura:
- Agente orquestrador: direciona as solicitações recebidas aos agentes especialistas adequados com base na classificação de intenção
- Agentes especialistas: lidam com tarefas específicas de domínio (cobrança, agendamento, suporte técnico etc.)
- Escalonamento para humanos: critérios definidos de transferência para casos complexos ou sensíveis
Benefícios desse padrão:
- Cada especialista tem um prompt focado e contexto reduzido
- É mais fácil atualizar especialistas individuais sem afetar o sistema
- Métricas claras por domínio (taxa de resolução de cobrança, taxa de sucesso de agendamento etc.)
- Latência reduzida por interação (prompts menores, inferência mais rápida)
Defina critérios claros de transferência
Ao criar workflows com vários agentes, especifique exatamente quando e como o controle deve ser transferido entre agentes ou para operadores humanos.
Para orientações detalhadas sobre como criar workflows com vários agentes, consulte nossa documentação sobre Workflows.
Seleção de modelo para confiabilidade empresarial
A escolha do modelo certo depende dos seus requisitos de desempenho — especialmente latência, precisão e confiabilidade nas chamadas de ferramentas. Diferentes modelos oferecem diferentes equilíbrios entre velocidade, capacidade de raciocínio e custo.
Entenda os equilíbrios
Latência: Modelos menores (com menos parâmetros) geralmente respondem mais rápido, sendo adequados para interações frequentes e de baixa complexidade.
Precisão: Modelos maiores oferecem maior capacidade de raciocínio e lidam melhor com tarefas complexas de várias etapas, mas têm maior latência e custo.
Confiabilidade nas chamadas de ferramentas: Nem todos os modelos lidam com chamadas de ferramentas/funções com a mesma precisão. Alguns se destacam em saídas estruturadas, enquanto outros podem exigir prompts mais explícitos.
Recomendações de modelos por caso de uso
Com base em implantações que abrangem milhões de interações de agentes, surgem os seguintes padrões:
-
GPT-4o ou GLM 4.5 Air (ponto de partida recomendado): Ideal para agentes empresariais de uso geral, nos quais latência, precisão e custo precisam estar equilibrados. Oferece latência baixa a moderada, bom desempenho em chamadas de ferramentas e custo razoável por interação. Ideal para suporte ao cliente, agendamento, gestão de pedidos e atendimento de dúvidas gerais.
-
Gemini 2.5 Flash Lite (latência ultrabaixa): Ideal para interações simples e frequentes, em que a velocidade é essencial. Oferece a menor latência com amplo conhecimento geral, embora tenha menor desempenho em chamadas complexas de ferramentas. Tem boa relação custo-benefício em escala para roteamento/triagem inicial, perguntas frequentes simples, confirmações de agendamento e coleta básica de dados.
-
Claude Sonnet 4 ou 4.5 (raciocínio complexo): Ideal para resolução de problemas em várias etapas, julgamentos com nuances e orquestração complexa de ferramentas. Oferece a maior precisão e capacidade de raciocínio, com excelente confiabilidade nas chamadas de ferramentas, embora com maior latência e custo. É ideal para tarefas em que erros têm alto custo, como solução de problemas técnicos, consultoria financeira, workflows sensíveis à conformidade e decisões complexas de reembolso/escalonamento.
Faça benchmark com seus prompts reais
O desempenho do modelo varia significativamente conforme a estrutura do prompt e a complexidade da tarefa. Antes de escolher um modelo:
- Teste 2 a 3 modelos candidatos com seu prompt de sistema real
- Avalie consultas reais de usuários ou casos de teste sintéticos
- Meça a latência, a precisão e a taxa de sucesso nas chamadas de ferramentas
- Otimize para obter o melhor equilíbrio conforme seus requisitos específicos
Para ver opções detalhadas de configuração de modelos, consulte nossa documentação de Modelos.
Iteração e testes
A confiabilidade em produção vem da iteração contínua. Mesmo prompts bem elaborados podem falhar no uso real. O importante é aprender com essas falhas e melhorar por meio de testes disciplinados.
Configure critérios de avaliação
Associe critérios de avaliação concretos a cada agente para monitorar o sucesso ao longo do tempo e verificar regressões.
Principais métricas a acompanhar:
- Taxa de conclusão de tarefas: Porcentagem de intenções dos usuários atendidas com sucesso
- Taxa de escalonamento: Porcentagem de conversas que exigem intervenção humana
Para orientações detalhadas sobre como configurar critérios de avaliação na ElevenLabs, consulte Avaliação de sucesso.
Analise padrões de falha
Quando os agentes têm desempenho abaixo do esperado, identifique padrões nas interações problemáticas:
- Em que situações o agente fornece informações incorretas? → Reforce as instruções em seções específicas
- Quando ele não entende a intenção do usuário? → Adicione exemplos ou simplifique a linguagem
- Quais entradas do usuário fazem com que ele saia do personagem? → Adicione proteções para casos extremos
- Quais ferramentas falham com mais frequência? → Melhore o tratamento de erros ou as descrições dos parâmetros
Revise as transcrições de conversas em que a satisfação do usuário foi baixa ou as tarefas não foram concluídas.
Faça ajustes direcionados
Atualize seções específicas do seu prompt para resolver os problemas identificados:
- Isole o problema: Identifique qual seção do prompt ou definição de ferramenta está causando falhas
- Teste alterações com exemplos específicos: Use como casos de teste conversas que falharam anteriormente
- Faça uma alteração por vez: Isole melhorias para entender o que funciona
- Reavalie com os mesmos casos de teste: Verifique se a alteração resolveu o problema sem criar novos problemas
Evite fazer várias alterações no prompt simultaneamente. Isso torna impossível atribuir melhorias ou regressões a edições específicas.
Configure a coleta de dados
Configure seu agente para resumir os dados de cada conversa. Isso permite analisar padrões de interação, identificar solicitações comuns dos usuários e melhorar continuamente seu prompt com base no uso no mundo real.
Para orientações detalhadas sobre como configurar a coleta de dados na ElevenLabs, consulte Coleta de dados.
Use simulação para testes de regressão
Antes de implantar alterações no prompt em produção, teste um conjunto de cenários conhecidos para identificar regressões.
Para orientações sobre como testar agentes programaticamente, consulte Simular conversas.
Considerações para produção
Agentes empresariais exigem proteções adicionais além da qualidade do prompt. As implantações em produção devem considerar o tratamento de erros, a conformidade e a degradação adequada.
Trate erros em todas as integrações de ferramentas
Cada chamada a uma ferramenta externa é um possível ponto de falha. Garanta que seu prompt inclua tratamento explícito de erros para:
- Falhas de rede: “Estou tendo problemas para me conectar ao nosso sistema. Vou tentar novamente.”
- Dados ausentes: “Não vejo essas informações em nosso sistema. Você pode confirmar os detalhes?”
- Erros de tempo limite: “Isso está demorando mais do que o esperado. Posso encaminhar você a um especialista ou tentar novamente.”
- Erros de permissão: “Não tenho acesso a essas informações. Vou transferir você para alguém que possa ajudar.”
Exemplos de prompts
Os exemplos a seguir demonstram como aplicar os princípios apresentados neste guia a casos de uso empresariais do mundo real. Cada exemplo inclui anotações que destacam os princípios de confiabilidade em uso.
Exemplo 1: Agente de suporte técnico
Princípios demonstrados:
- ✓ Separação clara entre seções (
# Personality,# Goal,# Toolsetc.) - ✓ Uma ação por linha (veja as etapas numeradas de
# Goal) - ✓ Instruções concisas (a seção de tom é breve e clara)
- ✓ Etapas críticas enfatizadas (“This step is important”)
- ✓ Conversão de formato nas descrições dos parâmetros (normalização de e-mail)
- ✓ Seção dedicada a proteções
- ✓ Descrições precisas de ferramentas, com orientações sobre quando/como usar e erros
- ✓ Instruções explícitas de tratamento de erros
Exemplo 2: Agente de atendimento ao cliente para reembolsos
Princípios demonstrados:
- ✓ Escopo especializado do agente (apenas reembolsos, não suporte geral)
- ✓ Etapas claras do workflow na seção
# Goal - ✓ Ênfase repetida em regras críticas (limites de reembolso, verificação)
- ✓ Uso detalhado de ferramentas com “when to use” e “required checks”
- ✓ Conversão de formato nas descrições dos parâmetros (IDs de pedido, e-mails)
- ✓ Tratamento explícito de erros para cada ferramenta
- ✓ Critérios de escalonamento claramente definidos
Práticas recomendadas de formatação
A forma como você formata seu prompt afeta a eficiência com que o modelo de linguagem o interpreta:
- Use títulos em markdown: Estruture as seções com
#para seções principais e##para subseções - Prefira listas com marcadores: Divida as instruções em tópicos fáceis de entender
- Use espaços em branco: Separe seções e grupos de instruções com linhas em branco
- Mantenha os títulos em maiúsculas e minúsculas normais:
# Goal, e não# GOAL - Seja consistente: Use o mesmo padrão de formatação em todo o prompt
Perguntas frequentes
Como manter a consistência entre vários agentes?
Crie modelos de prompt compartilhados para seções comuns, como normalização de caracteres, tratamento de erros e proteções. Armazene-os em um repositório central e faça referência a eles entre os agentes especialistas. Use o padrão de orquestrador para garantir lógica de roteamento e procedimentos de transferência consistentes.
Qual é o prompt mínimo viável para produção?
No mínimo, inclua: (1) definição de personalidade/função, (2) objetivo principal, (3) proteções essenciais e (4) descrições das ferramentas, caso sejam usadas. Mesmo agentes simples se beneficiam de uma estrutura explícita de seções e instruções de tratamento de erros.
Como lidar com a descontinuação de ferramentas sem prejudicar os agentes?
Ao descontinuar uma ferramenta, primeiro adicione uma nova e depois atualize o prompt para priorizar a nova, mantendo a antiga como alternativa. Monitore o uso e remova a ferramenta antiga quando o uso cair para zero. Sempre inclua tratamento de erros para que os agentes possam se recuperar caso uma ferramenta descontinuada seja chamada.
Devo usar prompts diferentes para LLMs diferentes?
Em geral, prompts estruturados com os princípios deste guia funcionam em todos os modelos. No entanto, ajustes específicos para cada modelo podem melhorar o desempenho — especialmente no formato de chamadas de ferramentas e nas etapas de raciocínio. Teste seu prompt com vários modelos e ajuste-o se necessário.
Qual deve ser o tamanho do meu prompt de sistema?
Não existe um limite universal, mas prompts com mais de 2.000 tokens aumentam a latência e o custo. Priorize a concisão: cada linha deve ter um propósito claro. Se seu prompt ultrapassar 2.000 tokens, considere dividi-lo em vários agentes especializados ou extrair o material de referência para uma base de conhecimento.
Como equilibrar consistência e adaptabilidade?
Defina com firmeza os traços centrais de personalidade, objetivos e proteções, permitindo flexibilidade no tom e no nível de detalhamento conforme o estilo de comunicação do usuário. Use instruções condicionais: “If the user is frustrated, acknowledge their concerns before proceeding.”
Posso atualizar prompts após a implantação?
Sim. Os prompts de sistema podem ser modificados a qualquer momento para ajustar o comportamento. Isso é especialmente útil para lidar com problemas emergentes ou refinar capacidades à medida que você aprende com as interações dos usuários. Sempre teste as alterações em um ambiente de homologação antes de implantá-las em produção.
Como evitar que os agentes alucinem quando as ferramentas falham?
Inclua instruções explícitas de tratamento de erros para todas as ferramentas. Enfatize “never guess or make up information” na seção de proteções. Repita essa instrução nas seções de tratamento de erros específicas de cada ferramenta. Teste cenários de falha de ferramentas durante o desenvolvimento para garantir que os agentes sigam as instruções de recuperação.
Próximas etapas
Este guia estabelece a base para um comportamento confiável dos agentes por meio de engenharia de prompts, configuração de ferramentas e padrões arquiteturais. Para criar sistemas prontos para produção, continue com:
- Workflows: Projete a orquestração de vários agentes e transferências entre especialistas
- Avaliação de sucesso: Configure métricas e critérios de avaliação
- Coleta de dados: Capture insights estruturados das conversas
- Testes: Implemente testes de regressão e simulação
- Proteções: Configure a moderação de conteúdo para respostas seguras dos agentes
- Privacidade: Garanta conformidade e proteção de dados
- Nosso Agente de Documentação: Veja um estudo de caso completo desses princípios em ação
Para receber suporte para implantação empresarial, entre em contato com nossa equipe.