Como Escrever Prompts Eficazes para Agentes de IA

Escrever prompts claros e estruturados ajuda seu Agente de IA a se comportar com mais precisão e a responder de forma natural. Este guia cobre como escrever prompts eficazes para Agentes de IA no respond.io, incluindo tanto Instruções quanto Ações.

Instruções vs. ações

Escrevendo instruções

Ao criar instruções, estruturá-las claramente para que o Agente de IA sempre saiba quem é, como se comportar e quais passos seguir. Recomendamos dividir as instruções em quatro partes.

Nota: As instruções do agente de IA suportam até 10.000 caracteres. Se você ultrapassar o limite, será solicitado que reduza suas instruções antes de salvar.

Dicas para instruções

Escrever instruções claras e estruturadas ajuda seu agente de IA a agir de forma consistente. Abaixo está um exemplo de boas práticas para um Agente de Vendas para Qualificação de Leads e as principais dicas a seguir.

# CONTEXTO
* Você está conversando com alguém que está explorando nosso produto (novo, retornando ou navegando). Seu objetivo é direcioná-los para o produto ou plano certo.

# PAPEL & ESTILO DE COMUNICAÇÃO
* Seja acolhedor, prestativo e relaxado—nunca insistente. Faça uma pergunta por vez. Mantenha as respostas curtas, claras e encorajadoras.

# FLUXO DE NÍVEL SUPERIOR
1. Cumprimente e dê as boas‑vindas ao contato (nome do contato $contact.firstname). 
2. Pergunte, colete e salve os campos de Contato: nome, e‑mail e telefone (todos obrigatórios).
3. Pergunte sobre as necessidades deles: **"Você tem um orçamento em mente?"** 🙂"**

## QUALIFICAR LEAD
1. **Qualificado:** Se o orçamento ≥ 100000, recomende um produto com base nas respostas usando a Fonte de Conhecimento.
 1.1 Se demonstrarem interesse, pergunte: **"Você gostaria de agendar uma demo ou falar com alguém?"**
1.2 Se sim, atribua a @Sales Team e atualize o estágio do ciclo de vida para Hot Lead. Se não estiverem prontos, informe‑os que estamos disponíveis caso precisem de ajuda mais tarde.
2. **Não qualificado:** Se o orçamento < 100000, continue respondendo a quaisquer perguntas que tenham.

# LIMITES
1. Não informe ao contato se ele está qualificado ou não. Prossiga com o fluxo com naturalidade.

• Use termos canônicos (os nomes e ações exatos do seu espaço de trabalho):

  • Equipes/agentes: por exemplo, @Support Team, @Sales Team, @Jane Doe

  • Ações: por exemplo, Atribuir a, Fechar conversa, Atualizar estágios do ciclo de vida, Atualizar campos do contato

  • Campos de Contato: p.ex. Name field, Email field, Phone field — para que os dados sejam salvos/atualizados corretamente

• Estruture suas instruções claramente:

  • Divida os passos em uma ordem lógica (Cumprimente → Pergunte → Decida → Atribua)

  • Use listas em vez de parágrafos (Shift + Enter para quebras de linha)

  • Use cabeçalhos (# H1, ## H2) para cada seção. Por exemplo:

    # CONTEXTO
    # PAPÉIS E ESTILO DE COMUNICAÇÃO
    # FLUXO DE NÍVEL SUPERIOR
    ## FLUXO DE SUB-NÍVEL
    # LIMITES

• Mantenha a linguagem clara e utilizável:

  • Escreva em inglês claro e conversacional (outras línguas também podem ser usadas se os termos canônicos forem preservados)

  • Usa símbolos (=, <, :) para comparações ou condições

  • Mantenha a gramática e a ortografia corretas

  • Use emojis com moderação (para manter uma abordagem acessível, porém profissional)

• Seja claro sobre as capacidades:

  • Informe o que o Agente pode e o que não pode fazer

  • Não sobrecarregue as instruções com detalhes → use Ações para execução (p.ex. atribuir, fechar, atualizar campos)

• Organize por fluxos e cenários:

  • Comece com um fluxo de alto nível (p.ex. Cumprimentar → Perguntar → Decidir → Atribuir)

  • Divide‑o em cenários para situações comuns

    • Exemplo: No prompt do Agente de Vendas acima, “Qualificação de Lead” é um cenário próprio

  • Isto torna os prompts mais fáceis de ler, atualizar e manter

Escrever prompts de ação

Os prompts de ação são usados quando o agente de IA executa algo antes de enviar uma resposta — como atribuir um chat ou fechar a conversa.

Devem ser curtos, específicos e focados na execução.

Como escrevê‑los

Para cada ação, descreva:

• Quando deve acontecer (a condição)

• O que o agente deve fazer

Dicas para ações

Você pode indicar aos Agentes de IA o que fazer em dois lugares:

• Caixa de instruções

  • Aqui normalmente você escreve seus fluxos passo a passo, p.ex. “Cumprimentar → Perguntar → Atribuir → Fechar”.

  • Essas são instruções sequenciais, ou seja, são executadas em ordem, como um roteiro.

• Configurações de ações

  • Aqui você pode configurar regras não-sequenciais, p.ex. “If user asks for a human → Assign to @Support Team”.

  • Estas não dependem do fluxo; podem disparar a qualquer momento.

Para obter a melhor precisão, recomenda-se cobrir as ações em ambos os locais (instruções e configurações de ação). Desta forma o agente de IA sabe sempre o que fazer.

Se você os adicionar apenas na caixa de instruções, certifique‑se também de que as ações respectivas estão ativadas — caso contrário o agente de IA não poderá executá‑las, mesmo que suas instruções as mencionem.

Escrever prompts para seguimentos

Os Agentes de IA podem enviar automaticamente mensagens de acompanhamento quando um contato não responde após um tempo específico — ajudando você a manter as conversas ativas e aumentar o engajamento.

Para ativar isso, adicione instruções claras de acompanhamento na seção Instructions da página de configuração do Agente de IA.

Aqui está um exemplo que mostra como um agente de IA gere seguimentos, respostas e o encerramento de conversas:

Se o cliente não responder após 2 minutos, envie um follow-up gentil como: "Ei, você ainda está aí?" "Sem pressa, só conferindo." Se ainda não houver resposta, feche a conversa, atualize o ciclo de vida para Cold Lead e diga "Vou encerrar a conversa." Fique à vontade para me chamar a qualquer momento se quiser continuar!

Como isto funciona:

• Após 2 minutos sem resposta, o Agente de IA envia automaticamente a mensagem de acompanhamento.

• Se o Contato ainda não responder após isso, o Agente de IA executa as próximas ações definidas no seu prompt — fechar a conversa, atualizar o status do ciclo de vida e enviar a mensagem final.

• Se o contato responder antes da última ação do seu prompt, todas as ações de acompanhamento restantes serão canceladas e a conversa continuará normalmente.

Este exemplo mostra como você pode encadear múltiplos passos em um único fluxo de acompanhamento dentro do seu prompt.

Noções básicas de acompanhamento

• O Agente de IA verifica se o Contato não respondeu após o tempo que você especificar no seu prompt.

• Se nenhuma resposta for recebida dentro desse prazo, o Agente de IA envia a mensagem de acompanhamento que você definiu.

• A sequência de acompanhamento para automaticamente se:

  • O contato responde antes do horário agendado

  • A conversa fica não atribuída ou fechada

  • O Agente de IA determina que o Contato não está mais interessado, disse adeus ou que o objetivo foi alcançado

Você pode incluir um ou vários acompanhamentos no seu prompt para tratar diferentes cenários ou etapas de escalonamento.

Se você escreveu instruções de acompanhamento antes do lançamento da funcionalidade Follow-Up, será necessário salvar novamente seu modelo para que as alterações tenham efeito.

Limites de Follow-Up

• Cada seguimento deve ser agendado dentro de 24 horas (1 dia) da mensagem anterior.

• Você pode incluir até 5 acompanhamentos por prompt, cada um com seu próprio agendamento, mensagem e ações (p.ex., enviar um lembrete, atribuir um usuário ou fechar a conversa).

• O Agente de IA seguirá o cronograma definido no seu prompt, mas mensagens enviadas fora da janela de 24 horas do WhatsApp podem não ser entregues.

• Após o acompanhamento final, o Agente de IA continua com quaisquer ações restantes definidas no seu prompt (por exemplo, atribuir ou enviar mensagens).

Usar o otimizador de prompts

Ao editar instruções ou prompts de ação, você pode usar a ferramenta de otimização de prompts para melhorar a clareza e a redação, mantendo a intenção original.

Use-a quando:

• Você quer uma versão mais polida ou estruturada do seu prompt

• Você não tem certeza de como formular as coisas de forma clara

• Você está começando do zero e quer orientação

Basta clicar em Optimize, revisar a reescrita sugerida e ajustar se necessário.

Isto funciona tanto para instruções gerais como para ações específicas, como atribuir conversas ou fechar chats.

Usar variáveis

As variáveis tornam as respostas mais pessoais e precisas.

As variáveis podem ser usadas tanto em instruções quanto em ações — especialmente ao coletar ou referenciar detalhes do contato.

Usar a variável @

A variável @ permite aos agentes de IA atribuir uma conversa a uma equipe específica, a um agente humano ou a outro agente de IA com base nas instruções ou no prompt de ação.

Suporta encaminhamento que imita atribuições manuais feitas na Inbox — tornando‑a especialmente útil em ações templateadas.

Dicas para variáveis

• Use lógica clara em seus prompts de ação (p.ex. “Se o contato perguntar sobre preços, atribua a @Sales.”).

• Se possível, alinhe a sua estrutura de equipes do espaço de trabalho com a forma como deseja usar agentes de IA para o encaminhamento.

Usar variáveis de campo de contato nos prompts

Você pode usar $contact.fieldName para referenciar dinamicamente as informações existentes de um contato. Isso é especialmente útil quando:

• Você quer que o Agente de IA personalize sua saudação ou resposta

• Você precisa verificar ou confirmar detalhes que o contato compartilhou anteriormente

• Você quer evitar pedir informações que já estão disponíveis

Dicas para variáveis de campo do contato

As variáveis de campo do contato personalizam as respostas do agente e ajudam a salvar ou atualizar automaticamente os dados do cliente.

• O que acontece nos bastidores: Quando o agente de IA gera uma resposta, as variáveis são substituídas pelo valor real do perfil do contacto.

  • Exemplo: $contact.name → torna‑se “Wilson” na conversa.

• O que a IA realmente vê: o agente de IA só vê o valor (“Wilson”), não a etiqueta da variável ($contact.name).

Por que isso importa

• Se você apenas escrever “o e‑mail que você forneceu anteriormente”, o Agente de IA não saberá que você quis dizer $contact.email — ele verá apenas o valor (como wilson@email.com), e pode ficar confuso se forem mencionados vários e‑mails.

• Ao sempre referir o nome do campo e o valor (p.ex., Email: $contact.email, Telefone: $contact.phone), você deixa claro a qual informação está se referindo.

• Se você quiser que o Agente de IA salve ou atualize um campo, seja explícito e mencione o ID do campo no seu prompt:

  • Exemplo: “Salve e atualize o campo de e‑mail se o usuário fornecer um novo.”

Exemplos de prompts

Agora que você aprendeu a estruturar prompts, usar variáveis e escrever instruções claras, vamos ver alguns exemplos completos. Estes comparam bons prompts vs maus prompts para que você possa ver como as melhores práticas se aplicam na prática.

Exemplo 1

Bom prompt

# CONTEXTO
* Oriente os visitantes da página de preços para o plano certo.

# PAPEL & ESTILO DE COMUNICAÇÃO
* Caloroso, conciso; uma pergunta de cada vez.

# FLUXO PRINCIPAL
1) Cumprimente o cliente usando o nome: $contact.firstname
2) Pergunte e salve **Campo Nome**, **Campo E‑mail**, **Campo Telefone**
3) Pergunte sobre o orçamento

## CENÁRIOS
* Se o orçamento ≥ 100000 → Recomende um plano; ofereça demonstração
  - Se sim → **Assign to @Sales Team**; **Update Lifecycle stages** → **Hot Lead**
* Caso contrário → Responda às perguntas; mantenha o chat útil

# LIMITES
* Pode: Recomendar, **Assign to**, **Update Contact fields**, **Update Lifecycle stages**
* Não pode: Oferecer descontos ou aceitar pagamentos

Por que isso funciona:

• Cabeçalhos claros, fluxo de nível superior, cenários.

• Rápido de ler, fácil de manter.

Prompt ruim

Olá, bem‑vindo! Obtenha as informações e o orçamento deles; recomende uma opção; se forem clientes grandes, encaminhe para @Sales Team. 
Se não tiverem certeza, continue a conversa e não diga que estão qualificados. Resolveremos isso depois e fecharemos a conversa.

Por que isso não funciona:

• Sem cabeçalhos, sem seções, sem sequência.

• Os leitores têm que adivinhar a ordem e as ações.

Exemplo 2

Bom prompt

# CONTEXTO
* Classificar problemas do produto e encaminhá-los corretamente.

# PAPÉIS E ESTILO DE COMUNICAÇÃO
* Calmo, profissional, simpático 🙂

# FLUXO DE NÍVEL SUPERIOR
1) Cumprimenta o cliente com o nome: $contact.firstname
2) Pede um breve resumo e os passos já tentados

## CENÁRIOS
* Urgente (login bloqueado | perda de dados | interrupção) → **Assign to @Support Team**; define expectativas
* Não urgente → Fornece passos/documento de ajuda; se resolvido **Close conversation**; caso contrário **Assign to @Support Team**

# LIMITES
* Pode: Partilhar guias.
* Não pode: Aceder à faturação, repor passwords, alterar propriedade.

Por que isso funciona:

• Inglês limpo e profissional com termos precisos.

• As ações/equipes/campos canônicos são usados literalmente.

Prompt ruim

Olá, por favor, ajude o usuário com os problemas
- Se for urgente, avise a equipe técnica. 
- Capture o nome/e‑mail/telefone, se possível. 
- Se forem VIP, envie para @Sales Team. Feche quando estiver resolvido e marque como Lead Quente

Por que isso não funciona:

• Gíria/erros de digitação (“pls”, “suppot teem”), ações vagas, uso inconsistente de maiúsculas.

• Sem nomes de equipes canônicos ou verbos de ação.

Exemplo 3

Bom prompt

# CONTEXTO
* Lidar com solicitações de funcionalidades empresariais e repasses.

# PAPÉIS E ESTILO DE COMUNICAÇÃO
* Transparente, sem pressão.

# FLUXO DE NÍVEL SUPERIOR
1) Pergunte e atualize: **Campo Nome**, **Campo E-mail**, **Campo Telefone**
2) Confirme necessidades e orçamento

## PASSOS DE AÇÃO (Ordem correta)
* Demonstração solicitada E orçamento ≥ 100000:
  1) Recomende um plano; confirme a demonstração
  2) **Atribuir a @Sales Team**
  3) **Atualizar estágios do Ciclo de Vida** → **Lead Quente**
  4) Resuma os próximos passos; confirme
  5) **Fechar conversa**
* Apenas informação / não pronto:
  - Compartilhe uma visão geral; mantenha Q&A
  - **Fechar conversa** somente depois que confirmarem que terminaram

# LIMITES
* Pode: Recomendar planos. 
* Não pode: Oferecer descontos, modificar contratos.

Por que isso funciona:

• Cada ação tem pré-requisitos e ordem exata.

• Listas de passos separadas eliminam ambiguidade.

Prompt ruim

Se alguém solicitar funcionalidades empresariais:
- Feche o chat para mantê‑lo organizado
- Depois marque-os como Lead Quente e, se responderem novamente, atribua à @Sales Team.
- Obtenha o e-mail se necessário.

Por que isso não funciona:

• Atribui antes de identificar; atualiza o ciclo de vida aleatoriamente; fecha cedo demais.

• Sem gatilhos claros para cada ação.