> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liderhub.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# O que é um Prompt?

> Como funciona a lógica do prompt, instruções, variáveis e formatações para agentes de IA

export const IconViável = () => <span style={{
  color: '#2563eb',
  display: 'inline-flex',
  verticalAlign: 'middle'
}}><svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14" /><polyline points="22 4 12 14.01 9 11.01" /></svg></span>;
export const IconNãoViável = () => <span style={{
  color: '#dc2626',
  display: 'inline-flex',
  verticalAlign: 'middle'
}}><svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><circle cx="12" cy="12" r="10" /><line x1="15" y1="9" x2="9" y2="15" /><line x1="9" y1="9" x2="15" y2="15" /></svg></span>;
export const TileIconBg = ({children}) => <div aria-hidden style={{
  display: 'grid',
  placeItems: 'center',
  width: '100%',
  height: '100%',
  minHeight: 0,
  flex: '1 1 auto',
  alignSelf: 'stretch',
  justifySelf: 'stretch',
  color: '#3E78FF',
  boxSizing: 'border-box'
}}>
    <div style={{
  opacity: 0.32,
  lineHeight: 0,
  display: 'block',
  margin: 'auto'
}}>{children}</div>
  </div>;

## Visão geral

O **prompt** (ou instruções) é o coração de cada agente de IA. Ele define como o agente deve se comportar, quais perguntas fazer, como qualificar leads e quais ações tomar automaticamente.

## O que dá pra fazer via prompt

| Funcionalidade                                                                                                                                                                                                                              | Viabilidade       |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- |
| <Tooltip headline="Status" tip="Como configurar e usar os status de conversa na LíderHub." cta="Ver mais" href="/atendimento/status">Alterar status automaticamente</Tooltip>                                                               | <IconViável />    |
| <Tooltip headline="Departamento" tip="Como organizar conversas por departamento na LíderHub." cta="Ver mais" href="/atendimento/departamento">Alterar departamento automaticamente</Tooltip>                                                | <IconViável />    |
| <Tooltip headline="Etiquetas" tip="Como usar etiquetas para categorizar conversas." cta="Ver mais" href="/atendimento/etiquetas">Adicionar etiquetas automaticamente</Tooltip>                                                              | <IconViável />    |
| <Tooltip headline="Origem" tip="Como configurar e utilizar origens de contato." cta="Ver mais" href="/atendimento/origem">Alterar origem automaticamente</Tooltip>                                                                          | <IconViável />    |
| <Tooltip headline="Responsável" tip="Como funciona a propriedade de responsável e transferência de conversas." cta="Ver mais" href="/atendimento/responsavel">Transferir conversa para outro agente de IA ou humano</Tooltip>               | <IconViável />    |
| <Tooltip headline="Variáveis" tip="Como salvar e usar variáveis personalizadas nos contatos." cta="Ver mais" href="/atendimento/variaveis">Salvar CPF, e-mail ou variáveis do cliente</Tooltip>                                             | <IconViável />    |
| <Tooltip headline="Roteiros de Vídeos" tip="Como criar e configurar templates de vídeos de proposta para envio automático." cta="Ver mais" href="/templates/roteiros-videos">Enviar áudio, vídeo ou mídias dependendo do contexto</Tooltip> | <IconViável />    |
| <Tooltip headline="AdvBox" tip="Como configurar a integração com AdvBox para consultar andamento de processos." cta="Ver mais" href="/integracoes/advbox">Consultar dados do andamento do processo</Tooltip>                                | <IconViável />    |
| <Tooltip headline="ZapSign" tip="Como configurar a integração com ZapSign para gerar contratos automaticamente." cta="Ver mais" href="/integracoes/zapsign">Gerar contrato (ZapSign) automaticamente</Tooltip>                              | <IconViável />    |
| <Tooltip headline="Google Calendar" tip="Configure a criação automática de eventos no calendário pelos agentes de IA." cta="Ver mais" href="/integracoes/google-calendar">Criar evento no Google Calendar automaticamente</Tooltip>         | <IconViável />    |
| Enviar áudio se o lead falar que não sabe ler                                                                                                                                                                                               | <IconViável />    |
| Realizar cálculos automaticamente                                                                                                                                                                                                           | <IconViável />    |
| Calcular lead score                                                                                                                                                                                                                         | <IconViável />    |
| Enviar e receber informações de outros sistemas                                                                                                                                                                                             | <IconViável />    |
| Remover etiquetas                                                                                                                                                                                                                           | <IconNãoViável /> |
| <Tooltip headline="Follow Up" tip="Como agendar sequências automáticas de mensagens e regras de cancelamento." cta="Ver mais" href="/follow-up">Follow up — não é via prompt</Tooltip>                                                      | <IconNãoViável /> |

## Como escrever um bom prompt

A diferença entre um prompt ruim e um bom prompt está no **nível de detalhe**. Você deve descrever como fazer, com exemplos, e condicionais do que fazer em cada etapa. Não deve haver "pontas soltas" no prompt — se a conversa da IA for para uma rota em que ela não está treinada, ela pode não performar bem.

* Descreva **o que fazer** com base nas possíveis respostas do lead
* Dê **exemplos** sobre como a pergunta deve ser feita ao lead

Não significa que você precisa descrever tudo e prever todos os cenários precisamente como deveriam acontecer nas conversas, mas quanto mais bem você mapear seu processo, e declarar antes quais as perguntas (com exemplos), e o que deve acontecer em cada caso de resposta, melhor será a performance da IA.

<Callout>
  Fique tranquilo, temos [templates disponíveis](/agentes/criar-agentes#criar-a-partir-de-templates), e você pode [editar seu prompt com nossa IA](/agentes/criar-agentes#editar-agentes-de-ia).
</Callout>

<Warning>
  Instruções genéricas como "Qualifique o lead e repasse para o humano" **não funcionam bem**. A IA não sabe quais perguntas fazer, quais critérios usar, nem o que fazer com cada resposta. Se a IA não performar bem, corre o risco de [alucinação](/agentes/alucinacao).
</Warning>

| Prompt ruim                           | Alternativa mais detalhada — melhor                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "Pergunte pela idade e renda do lead" | "Assim que o lead responder à mensagem de boas-vindas, pergunte pela idade utilizando: 'Legal, quantos anos você tem?' Se a idade for maior ou igual a 65, então envie: 'Legal, você pode qualificar para o BPC Loas por idade!'. Se a idade for menor que 65, então envie: 'Entendi! Mas vamos continuar o processo, porque você ainda pode ter direito ao BPC pelo critério de saúde...'"                    |
| "Repasse para humano"                 | "Se detectado que o cliente quer falar com um humano, ou se mencionar que é muito importante ou urgente, envie: 'Certo, já vou te repassar para um especialista nisso, mas antes, me informa seu nome completo e CPF?' Assim que tiver o nome completo e CPF, envie um breve resumo do caso ao cliente, e peça que ele confirme. Assim que confirmar, então transferir para <Badge color="blue">@joão</Badge>" |
| "Quebre objeções"                     | "Acesse <Badge color="blue">@base de conhecimento</Badge> para checar as objeções mais comuns, e envie ao usuário uma resposta, com uma pergunta, para dar continuidade à conversa."                                                                                                                                                                                                                           |

### A regra de ouro

Quanto mais **demonstrativo** e **exemplificativo** você for, mais fácil será para a IA replicar seu estilo e seu processo. Pense assim:

* **Descreva as perguntas** que o agente deve fazer ao cliente
* **Descreva o que fazer** com base nas respostas
* **Dê exemplos de mensagens** que o agente deve enviar
* **Cubra cenários alternativos** — objeções, dúvidas, respostas inesperadas

<Check>
  Felizmente, na LíderHub você pode adicionar agentes a partir de um **template**, e nós temos milhares de validações e **milhões de mensagens** já transacionadas por esses agentes. Confira os templates em [Criar Agentes de IA](/agentes/criar-agentes#criar-a-partir-de-templates).
</Check>

## Dicas para prompts eficazes

1. **Use citações literais** para mensagens importantes que o agente deve enviar exatamente como escrito
2. **Teste cenários diferentes** — leads qualificados, desqualificados, com objeções
3. **Itere constantemente** — melhore o prompt baseado nas conversas reais

* Você fica bom naquilo que repete. Seu prompt vai ficar tão melhor quanto mais você testá-lo — com sua equipe e com clientes
* Se você tem clientes reais e alguém monitorando e melhorando seus agentes, esse é o cenário perfeito
* A principal dica é **testar MUITO**. Para testar, você precisa saber como ativar seus agentes e como resetar a experiência — confira em [Testar e Ativar Agentes](/agentes/quando-ativar)

## Cuidado com prompts falhos

Prompts mal escritos ou com "pontas soltas" podem levar a IA a inventar informações — o que chamamos de **alucinação**. Sempre que a IA não performar como esperado, revise o prompt e a base de conhecimento.

<Columns cols={2}>
  <Tile href="/agentes/alucinacao" title="Alucinação de Prompt" description="Quando a IA inventa informações e como prevenir esse comportamento.">
    <img src="https://mintcdn.com/liderhub/TEbXkvjgVcmJWt0p/images/elon-musk-ai-hallucination.png?fit=max&auto=format&n=TEbXkvjgVcmJWt0p&q=85&s=d214730b83183777a7d6b21c23fd9afe" alt="Alucinação de Prompt" width="1194" height="810" data-path="images/elon-musk-ai-hallucination.png" />
  </Tile>

  <Tile href="/agentes/conflito-inicial" title="Conflito inicial" description="Quando a primeira mensagem do lead compete com o roteiro e o agente não segue a ordem das instruções.">
    <TileIconBg>
      <svg xmlns="http://www.w3.org/2000/svg" width="92" height="92" fill="none" viewBox="0 0 24 24" stroke="currentColor" strokeWidth={1.25} strokeLinecap="round" strokeLinejoin="round" style={{ display: 'block' }}>
        <path d="M12 9v3.75m-9.303 3.376c-.866 1.5.217 3.374 1.948 3.374h14.71c1.73 0 2.813-1.874 1.948-3.374L13.949 3.378c-.866-1.5-3.032-1.5-3.898 0L2.697 16.126ZM12 15.75h.008v.008H12v-.008Z" />
      </svg>
    </TileIconBg>
  </Tile>
</Columns>

## Deixe uma sugestão

<Accordion title="Feedback de Melhorias sobre O que é um Prompt?">
  Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse [Obtenha suporte](/suporte/obtenha-suporte).

  <iframe src="https://tally.so/embed/682q2k?feature=O%20que%20%C3%A9%20um%20Prompt%3F&alignLeft=1&hideTitle=1&transparentBackground=1" width="100%" height="350" frameBorder="0" title="Enviar feedback de melhorias" />
</Accordion>

## Dúvidas Frequentes

<AccordionGroup>
  <Accordion title="O que são os arrobas vermelhos no prompt?">
    São menções que referenciam itens inexistentes no seu workspace. Clique neles e selecione o item correto para corrigir.
  </Accordion>

  <Accordion title="Posso usar emojis no prompt?">
    Sim. Emojis e formatações do WhatsApp (*negrito*, *itálico*) funcionam normalmente no prompt.
  </Accordion>

  <Accordion title="Como sei se meu prompt está bom?">
    Teste com o comando /restart simulando diferentes cenários: lead qualificado, desqualificado, com objeções e pedindo humano.
  </Accordion>
</AccordionGroup>