🛠️ Os 3 Pilares da Configuração do seu AI Assistant
Pilar #1: A Mensagem de Boas-Vindas (Welcome Message)
Esta é a primeira interação do usuário com a IA. Uma boa mensagem de boas-vindas é crucial para definir expectativas, apresentar o assistente e esclarecer suas capacidades desde o início. Isso ajuda a guiar o usuário e reduz a chance de perguntas fora de escopo, prevenindo alucinações.
O que fazer: Na configuração do assistente, adicione uma saudação clara e objetiva que explique quem ele é e o que ele faz.
Exemplo de Welcome Message:
Olá! 👋 Seja bem-vindo(a)! Sou o assistente virtual da Pipefy e estou aqui para ajudar você com o que precisar, desde informações sobre nossos produtos e serviços até suporte com dúvidas e processos. Como posso te ajudar hoje?
Pilar #2: O Formulário como Roteiro (Para Criar Cards)
Quando a função do assistente é iniciar um processo (criar um card), o formulário é a base de tudo.
O Formulário (Campos e Condicionais): É o roteiro da conversa. Define O QUE perguntar e em que ordem, usando campos claros e regras condicionais para criar um fluxo lógico.
Para mais informações, leia:
Pilar #3: "Custom Instructions (Prompt)" e as Skills de Conhecimento (Para Responder Dúvidas)
O assistente pode ser treinado para responder perguntas com base em seus documentos (políticas internas, manuais, FAQs).
Para mais informações, leia:
As Instruções Customizadas (Prompt): É a direção de ator. Define COMO o assistente deve se comportar. Seu tom de voz (formal, amigável?), sua personalidade e diretrizes gerais de interação.
O erro mais comum que causa "alucinações" ou comportamentos inesperados é tentar colocar o roteiro dentro da direção de ator.
Para esta função, siga as boas práticas de não replicar a lógica dos campos condicionais no prompt e de usar nomes de campos claros, conforme explicado nas seções anteriores do nosso guia.
❌ O Que NÃO Fazer: Replicando a Lógica no Prompt
Vamos analisar um exemplo real de um prompt que confunde a IA. A intenção é boa, mas a execução gera conflitos.
Exemplo de prompt problemático:
> "_Houve marcas visíveis no imóvel (como queimaduras, manchas ou perfurações) causadas pelo raio?_" > Resposta: Sim | Não
Se SIM:
Após a finalização do processo você receberá um e-mail para envio de imagens das marcas no imóvel.
Se NÃO:
"A companhia elétrica foi acionada?" Resposta: Sim | Não → Se SIM: "Você possui o protocolo de atendimento da companhia elétrica? Se sim, por favor, informe."
Por que isso é um problema?
Redundância: O AI Assistant já lê os campos do seu formulário. Se você tem um campo chamado "A companhia elétrica foi acionada?", você não precisa mandar ele fazer essa pergunta no prompt.
Conflito de Lógica: Toda a estrutura "Se SIM, faça X; Se NÃO, faça Y" deve ser controlada pelas regras de campos condicionais do formulário. Ao colocar essa lógica nas instruções, você cria duas fontes de verdade, e a IA pode se confundir.
✅ O Jeito Certo: Deixe o Formulário Guiar a Conversa
A abordagem correta é simplificar drasticamente o prompt e construir toda a inteligência da coleta de dados diretamente no formulário do seu Pipe.
Passo 1: Estruture seu Formulário Corretamente
No editor do seu formulário, arraste os campos necessários para a área de criação. Use nomes de campo claros e diretos, pois eles servirão como as perguntas que a IA fará.
Para mais informações, leia:
Campo 1:
Houve marcas visíveis no imóvel causadas pelo raio?(Tipo: Seleção Única - Sim/Não)Campo 2:
A companhia elétrica foi acionada?(Tipo: Seleção Única - Sim/Não)Campo 3:
Qual o número do protocolo de atendimento da companhia elétrica?(Tipo: Texto Curto)Campo 4 (Informativo): Use um campo do tipo "Instrução" com a mensagem sobre o envio das fotos.
Passo 2: Aplique as Regras Condicionais
Com os campos criados, use o poder dos condicionais do Pipefy para criar o fluxo lógico. Clique em um campo e depois no ícone de "Condicionais do Campo" para definir suas regras.
Regra 1: SE o campo
Houve marcas visíveis...for respondido comSim, ENTÃO exibir o Campo 4 (com a instrução sobre as fotos).Regra 2: SE o campo
Houve marcas visíveis...for respondido comNão, ENTÃO exibir o campoA companhia elétrica foi acionada?.Regra 3: SE o campo
A companhia elétrica foi acionada?for respondido comSim, ENTÃO exibir o campoQual o número do protocolo....
Passo 3: Escreva um Prompt Limpo e Focado
Agora que toda a lógica está no formulário, suas instruções customizadas podem focar apenas no comportamento da IA.
🏆 Exemplo de Prompt Avançado: Unindo Tarefas e Conhecimento
As "Instruções Customizadas" (o prompt) unem todos os pilares, definindo a personalidade e as regras de comportamento do assistente.
Modelo de Instruções Customizadas (Prompt Mestre):
Você é um assistente virtual da empresa Pipefy, e deve agir como uma extensão profissional e confiável da marca.
Sua comunicação deve ser clara, cortês e eficiente. Use um tom de voz humano, acessível e direto, sempre demonstrando empatia e foco em resolver as necessidades do usuário.
Evite formalidade excessiva, mas mantenha um padrão respeitoso e atencioso em todas as interações.
Seu papel é fornecer informações precisas sobre os produtos, serviços, processos e políticas da empresa, baseado nas habilidades que você tem configuradas, sempre use elas para buscar contexto para suas respostas.
Sempre que possível, antecipe as necessidades do usuário e entregue orientações úteis, bem estruturadas e sem ambiguidade.
Quando não souber a resposta ou quando a solicitação exigir intervenção humana, reconheça isso de forma transparente e encaminhe o usuário com educação e clareza.
Você não deve dar opiniões pessoais, fazer promessas em nome da empresa, nem compartilhar dados confidenciais ou especulativos.
Não se envolva em conversas sobre política, religião, ou qualquer tema fora do escopo da atuação da empresa.
Seu foco deve ser oferecer suporte eficaz, manter a confiança do usuário e representar os valores da organização em todas as respostas.
🔬 Dissecando o Prompt Avançado: Por que Ele Funciona?
Persona e Tom Claros: Define quem a IA é e como ela deve se comunicar.
Diretriz Principal Explícita: A frase em negrito é a chave. Ela instrui o assistente a sempre consultar suas Skills (base de conhecimento) antes de responder.
Guardrails Robustos: As regras de limite ensinam o assistente a agir com segurança: o que fazer quando não sabe algo, o que é proibido dizer e quais assuntos evitar.
Comportamento e Processo
Seu papel é fornecer informações precisas sobre os produtos, serviços, processos e políticas da empresa, baseado nas habilidades que você tem configuradas — sempre use elas para buscar contexto para suas respostas. Sempre que possível, antecipe as necessidades do usuário e entregue orientações úteis, bem estruturadas e sem ambiguidade.
Regras e Limites (Guardrails)
NÃO CRIE INFORMAÇÃO: Jamais prometa prazos, valores, aprovações ou próximos passos que não estejam explicitamente escritos em um campo do tipo "instrução" no formulário.
PERGUNTAS FORA DO ESCOPO: Se o usuário fizer uma pergunta que você não sabe responder (ex: "Quando meu conserto será aprovado?"), responda de forma educada: "Eu não tenho acesso a essa informação, mas a equipe responsável irá analisar sua solicitação e entrará em contato com todos os detalhes."
FOCO NO FORMULÁRIO: Sua única tarefa é preencher os campos do formulário. Não desvie do assunto.
Seguindo essas diretrizes, com um formulário bem estruturado e um prompt limpo, você terá um AI Assistant muito mais previsível, eficiente e livre de alucinações.