Pular para o conteúdo
Abrir o Leadz

Manual para criar o prompt

Um arquivo para colar no ChatGPT, no Claude ou no Gemini, que ensina a outra IA a escrever o prompt do seu agente do jeito que o Leadz entende.

No Leadz:AutomaçãoAgentes IA Abrir esta tela
Nesta página

Se você usa o ChatGPT, o Claude ou o Gemini para escrever o prompt do agente, entregue este manual a eles antes. Essas IAs não conhecem o Leadz e escrevem instruções como «use a ferramenta» ou «após a confirmação, mova o card», que fazem o agente responder o contato e esquecer a ação. Com o manual, a outra IA passa a escrever no formato que funciona aqui.

manual-agente-ia.md

Um arquivo só, pronto para colar no ChatGPT, no Claude ou no Gemini. Ele ensina a outra IA a escrever o prompt do seu agente do jeito que o Leadz entende.

Baixar .md Abrir em nova aba

#Para que serve

O manual é um texto único, escrito para ser lido por uma IA. Ele explica:

  • como o agente do Leadz age de verdade (tudo numa resposta só, sem ferramenta e sem confirmação);
  • o que o agente consegue e o que não consegue fazer;
  • o que ele já sabe sozinho sobre o contato;
  • as regras de escrita que funcionam e as frases que travam o agente;
  • os limites de tamanho, de botões e de links;
  • a estrutura recomendada, um exemplo completo e uma lista de conferência.

Você não precisa ler o manual para usar. Mas vale ler Boas práticas de prompt para entender o que a outra IA vai entregar.

#Antes de começar

Tenha em mãos os nomes exatos, como estão no Leadz:

  • as etapas do CRM para onde o agente pode mover o card;
  • as tags que ele pode pôr e tirar;
  • os campos personalizados que ele pode gravar;
  • os títulos dos materiais que ele pode enviar;
  • os links que ele pode mandar (compra, cadastro, agenda).

A outra IA só acerta os nomes se você informar. Nome diferente do que está no Leadz não funciona.

#Usar o manual em 3 passos

  1. Copie o manual. Clique em Copiar manual, ou em Baixar .md para guardar o arquivo.
  2. Cole no ChatGPT, no Claude ou no Gemini, junto com o seu pedido. Abra uma conversa nova, cole o manual (ou anexe o arquivo) e, logo abaixo, cole o pedido-modelo preenchido.
  3. Cole o resultado no agente e teste. Copie o prompt que a IA escreveu, cole em Instruções base (system prompt), no passo Comportamento do agente, salve e clique em Testar.

#Pedido-modelo

Copie, preencha e envie junto com o manual:

Usando o manual acima, escreva o prompt do meu agente do Sparkle Leadz.

Meu negócio é: ...
Meu público é: ...
O que eu vendo, com preço, garantia e link de compra: ...
As etapas do meu CRM liberadas para o agente são (nomes exatos): ...
As tags liberadas são (nomes exatos): ...
Os campos personalizados liberados são (nomes exatos): ...
Os materiais que ele pode mandar são (títulos exatos): ...
Os eventos do Sparkle Tracker liberados são: ...
O agente pode criar tarefas de retorno? (sim/não): ...
Quero que o agente: ...
Ele deve transferir para um humano quando: ...
Ele nunca deve: ...
Tom de voz: ...

#Depois que a IA entregar o prompt

  1. Libere as ações. O prompt sozinho não dá permissão. No passo Ações no CRM do agente, libere as etapas, as tags e os campos que o prompt usa. Veja Ações no CRM.
  2. Marque os materiais. No passo Conhecimento, marque os materiais que o prompt manda enviar.
  3. Confira o tamanho. O campo Instruções base aceita até 16.000 caracteres. Se o texto colado for cortado, peça à IA uma versão mais curta.
  4. Teste cada regra. Siga o roteiro de Testar o agente e confira se as ações aparecem nas notas de cada resposta.

Se o agente errar no teste, volte à mesma conversa com a outra IA, cole a mensagem que você enviou e a resposta do agente, e peça o ajuste. Ela já tem o manual e corrige mantendo o formato.

#Problemas comuns

A IA devolveu um prompt com «use a ferramenta» ou «após confirmação»

Ela não seguiu o manual. Responda na mesma conversa: «Revise o prompt pelo checklist do manual, item por item, e reescreva.»

A IA inventou nomes de etapas ou de tags

Faltou informar os nomes no pedido. Envie a lista com os nomes exatos e peça para reescrever só com eles.

O prompt ficou longo demais

Peça: «Reduza para menos de 6.000 caracteres, mantendo todas as regras de ação.» Prompts enxutos funcionam melhor, principalmente em modelos menores.

O agente responde bem, mas as ações não acontecem

Confira se cada etapa, tag e campo do prompt está liberado no passo Ações no CRM e escrito com o mesmo nome. Depois, teste de novo.

#Veja também

Este artigo ajudou?

Mais em Agentes IA

Ver os 9 artigos