Bem-vindo ao manual completo para transformar seu assistente de Inteligência Artificial (IA) em um agente proativo e multifuncional na Zárpon. Se a primeira etapa foi entender os fundamentos, agora vamos mergulhar na execução prática: comandar sua IA para executar funções — desde agendar consultas e enviar arquivos até aplicar tags e interagir com outros blocos de automação.
Este guia detalha não apenas a sintaxe de cada função, mas também a metodologia de testes para refinar o comportamento da IA e as estratégias para construir automações avançadas.
Estrutura de um Prompt de Alta Performance
Todo assistente de alta performance parte de um prompt bem estruturado, preferencialmente escrito em Markdown e organizado no Notion.
Parte 1: A Estrutura de um Prompt de Alta Performance
( Recapitulando)
Como vimos, todo assistente de alta performance parte de um prompt bem estruturado, preferencialmente escrito em Markdown e organizado no Notion. A estrutura base recomendada inclui:
Descrição e Identidade: Quem é a IA
Objetivos: O que ela deve alcançar
Regras de Atendimento: O que ela pode e não pode fazer
Exemplo de Fluxo (Roteiro): Um guia da conversa ideal
Base de Conhecimento: Todas as informações sobre seu negócio
Com essa base sólida, podemos começar a ensinar a IA a executar ações.
Parte 2: O Arsenal de Funções: Como Comandar sua IA na Prática
A chave para a execução de funções é ser explícito e imperativo. A IA segue ordens literais contidas no prompt. Usaremos o prompt da "Barbearia Premium" como nosso exemplo prático.
2.1. Enviando Mídias (Imagens, Vídeos, PDFs)
Para que a IA envie um arquivo, como a foto de um combo de serviços, a instrução no prompt deve ser precisa.
Hospedagem
O arquivo deve estar em um local como o Google Drive.
O Comando
Use a instrução "envie exatamente a mensagem a seguir".
A Sintaxe
O texto que a IA deve gerar precisa seguir o formato `tipo_de_midia: [link_direto_do_arquivo]`.
Exemplos de Sintaxe:
imagem: https1://link.do.drive/imagem.jpg
audio: https://link.do.drive/audio.mp3
video: https://link.do.drive/video.mp4
Importante: O link deve ser o de download direto do arquivo, não o link de compartilhamento de uma pasta. Para obter esse link, existem ferramentas online que convertem links do Google Drive.
2.2 Manipulando Tags e Variáveis
A IA pode organizar e personalizar o atendimento dinamicamente.
Exemplo de Instrução no Prompt:
"Ao identificar que o cliente escolheu o 'Combo Clássico', execute a função manage_tags para inserir a tag 'Combo Clássico' e execute a função update_variables para salvar 'Combo Clássico' na variável 'combo_interessado'."
Configuração na Zárpon: No bloco do Assistente de IA, as funções e as respectivas tags/variáveis devem estar habilitadas para que a IA tenha permissão para usá-las.
2.3. Controlando o Fluxo da Conversa
Estas funções permitem que a IA interaja com o restante do seu Fluxo de Automação.
Função | Descrição | Quando Usar |
`continue_funnel` | Envia um sinal simples para "continuar o funil", seguindo a próxima conexão direta no seu fluxo. | Ideal para ações lineares e diretas, como transferir para um atendente após uma qualificação simples. |
`conditional_step`
| Envia um sinal com um parâmetro específico (ex: atendimento_humano). Isso permite criar múltiplas saídas lógicas no seu bloco de IA. | Perfeito para cenários complexos onde você precisa de diferentes ações com base no resultado da conversa. |
2.4. A Função de Fallback: O Plano de Contingência
Este é um dos fluxos mais importantes. Ele define o que fazer quando a IA não sabe responder.
Exemplo de Regra de Fallback:
"Se o cliente fizer uma pergunta que não se enquadra nos fluxos definidos e cuja resposta não está na Base de Conhecimento, responda com naturalidade: 'Essa é uma ótima pergunta. Vou te encaminhar para um de nossos especialistas'. Em seguida, execute a função conditional_step com o parâmetro atendimento_humano."
Configure o Fluxo na Zárpon:
No bloco Assistente de IA, ative a função "Continuar com base na resposta" e crie uma opção com o parâmetro `
atendimento_humano`
Conecte a saída desta opção a um bloco de Atendimento Manual.
No bloco de Atendimento Manual, configure uma Notificação para ser enviada ao WhatsApp do atendente responsável.
Parte 5: Metodologia de Teste e Refinamento de Prompts
A engenharia de prompt é um processo cíclico. A seguir, a metodologia usada na aula para diagnosticar e corrigir falhas.
Teste Colaborativo
Envolva o cliente final no processo de teste. Ele trará cenários e perguntas que você talvez não tenha previsto.
Estrutura de Feedback
Para cada comportamento inesperado, documente: O que foi perguntado? O que a IA respondeu? Qual era o comportamento esperado?
Refinamento com o "Engenheiro de Prompts"
Use uma IA auxiliar (como o GPT da Zárpon ou o ChatGPT) para analisar os feedbacks.
Passo A (Diagnóstico)
Apresente o seu prompt e o feedback das 3 perguntas, e peça o raciocínio: "Qual erro lógico no meu prompt causou esse comportamento?"
Passo B (Sugestão)
Peça as alterações: "Com base no seu raciocínio, quais alterações você sugere no meu prompt?"
Passo C (Execução)
Se concordar com as sugestões, peça a versão final: "Pode aplicar essas alterações e me fornecer a nova versão completa do prompt?"
Iteração: Copie o novo prompt para a Zárpon, salve o assistente e teste novamente. Repita o ciclo até o comportamento estar polido.
FAQ: Perguntas Frequentes sobre Funções e Fluxos Avançados
1. Minha IA não está executando uma função, como aplicar uma tag. O que verificar?
Clareza do Prompt
Sua instrução pode estar ambígua. Em vez de "aplique a tag", seja explícito: "execute a função manage_tags para inserir a tag..."
Configuração do Fluxo
Verifique se a função e a tag específica estão habilitadas nas configurações do bloco Assistente de IA dentro do seu fluxo.
2. Como configuro uma sequência de lembretes com vários dias de antecedência?
Você deve combinar recursos:
Use um Gatilho de Agenda para iniciar um fluxo (ex: 3 dias antes do compromisso).
Esse gatilho deve ativar uma Sequência (em "Automações").
Dentro da Sequência, o primeiro funil (lembrete 1) é enviado imediatamente. O segundo funil tem um atraso de 2 dias, e assim por diante.
Importante: Se o cliente responder e reagendar, seu fluxo deve conter um passo para "Remover de Sequência" para interromper os lembretes futuros.
3. Para um fluxo de Follow-up, devo usar um assistente de IA ou blocos de automação?
Blocos de Automação (Sequências)
Ideal para follow-ups com mensagens fixas e delays pré-definidos (ex: enviar mensagem X a cada 24 horas).
Assistente de IA
Mais poderoso para follow-ups dinâmicos e conversacionais. Você pode criar um fluxo que, a cada 24 horas, aciona um assistente com um prompt inicial específico.
4. Minha IA não respeita os delays que coloquei no prompt (ex: "espere 24 horas"). Por quê?
O assistente de IA não processa comandos de tempo diretamente no prompt. O controle de tempo (esperar X horas/dias) deve ser sempre configurado através dos blocos do Fluxo de Automação, como o bloco de Delay ou os atrasos nas Sequências.
5. A IA pode iniciar uma conversa ativamente com um contato da minha base que não manda mensagem há muito tempo?
Não. A IA da Zárpon sempre parte de um input inicial (seja uma mensagem do cliente ou um disparo de uma campanha). Ela não pode, por si só, decidir buscar um contato na sua base e iniciar uma conversa. Para reativar uma base, você precisa iniciar a ação através de uma Campanha ou Lista de Transmissão.