For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/automations/ask-ai-agent-step.md.
  • Português

      • Como usar um agente de IA para responder na automação?

      Adicione o passo Perguntar à IA à automação para um agente de IA do seu workspace ler a última mensagem do contato e escrever uma resposta. A resposta fica na variável {{aiReply}}, e é o passo seguinte de mensagem (WhatsApp, e-mail ou SMS) que a envia — a IA não envia nada sozinha. Se a IA falhar ou o contato ainda não tiver escrito nada, a variável fica vazia e a automação segue normalmente.

      Papel: qualquer membro com acesso de edição no workspace.

      Antes de começar

      • Um agente de IA publicado em Configurações → Central de Contas → Meus agentes — veja como criar um agente de IA com a sua chave. A chave do provedor (OpenAI ou Anthropic) e o modelo vêm do agente; o uso é cobrado pelo provedor, na conta da chave — não consome créditos da plataforma.
      • A automação precisa receber uma mensagem do contato para a IA responder: use o passo depois de um passo de WhatsApp com Aguardar resposta ligado, ou em uma automação disparada por mensagem recebida (WhatsApp, Instagram, Telegram).

      Passo a passo

      1. No canvas da automação, clique em + depois do passo que recebe a mensagem do contato e, na seção Integrações, escolha Perguntar à IA.
      2. Em Agente de IA, escolha um agente publicado do workspace. Só agentes Ativos aparecem na lista; se ela estiver vazia, publique um agente em Meus agentes primeiro.
      3. Em Instrução para a IA, escreva como ela deve responder (por exemplo: "Responda como atendente da loja, em até duas frases, e ofereça ajuda"). A persona do agente complementa a instrução, mas a instrução do passo tem prioridade sobre formato e limites.
      4. Adicione depois um passo de mensagem (WhatsApp, e-mail ou SMS) e insira a variável aiReply no texto — ela aparece na lista de variáveis do composer, no grupo Perguntar à IA.
      5. Salve e ative a automação.

      Como funciona na execução

      1. O contato escreve para a automação (resposta a um passo anterior ou mensagem que disparou o gatilho).
      2. O agente recebe a sua instrução e a mensagem do contato, e responde em texto livre.
      3. A resposta é guardada em {{aiReply}} e o passo seguinte a envia como qualquer outra variável.

      Se o agente estiver pausado, em rascunho ou tiver sido excluído, a chave dele for inválida, o provedor não responder a tempo ou não houver mensagem do contato, {{aiReply}} fica vazio e a automação continua. Uma mensagem só com {{aiReply}} sairia em branco nesse caso — combine a variável com um texto fixo, ou use um passo de condição para tratar o vazio.

      Limites e observações

      • Só a última mensagem do contato entra na pergunta; o histórico da conversa não é enviado.
      • Um passo Perguntar à IA por trecho: um segundo passo sobrescreve {{aiReply}} com a resposta nova.
      • Instrução de até 4.000 caracteres; resposta de até algumas centenas de palavras.
      • Pausar ou excluir o agente faz o canvas apontar o passo para você publicar ou trocar o agente; até lá, a variável fica vazia.
      • Você acompanha o valor de {{aiReply}} em cada execução em Dados da execução.

      Páginas relacionadas