A diferença para uma automação é o tipo de trabalho. A automação executa ações determinadas — mover, notificar, criar. O assistente produz conteúdo: resume, classifica, redige, extrai informação de um texto solto.
Onde configurar
Dois caminhos levam ao mesmo lugar:- Pelo menu Assistentes de etapa, que lista todos os assistentes da conta com etapa, agente de IA e status.
- Pelo botão Adicionar assistente dentro da configuração de uma etapa, já vinculado a ela.
Como configurar
Ao criar o assistente, você define os campos abaixo.1
Nome
Identifica o assistente nas listas e nos registros de execução.
2
Agente de IA
Qual agente executa a tarefa. O agente traz o modelo e as ferramentas; o assistente traz o momento e a instrução.
3
Etapa
A etapa do funil à qual o assistente pertence.
4
Prompt
A instrução dada ao agente. Aceita sintaxe avançada, então o prompt pode incorporar dados do projeto e da etapa em vez de ser um texto fixo. Veja Sintaxe avançada.
5
Executar quando
O gatilho: ao entrar na etapa, ao sair da etapa ou manualmente.
6
Saída e tratamento de falha
Onde o resultado é gravado e o que acontece se a execução falhar. Detalhado abaixo.
Quando o assistente roda
O campo Executar quando aceita três opções.Entrar na etapa
Dispara quando o projeto é movido para a etapa. É o gatilho mais usado: o item chega e já vem processado.
Sair da etapa
Dispara quando o projeto deixa a etapa. Bom para consolidar o que foi feito ali antes de seguir.
Manual
Só roda quando alguém pede. Para tarefas que dependem de julgamento sobre quando fazer.
Apenas assistentes ativos são executados. Um assistente inativo continua salvo e editável, mas nunca dispara.
Usar no prompt a conversa que disparou a automação
Um assistente pode responder ou classificar a mensagem de um cliente. Para isso, ele precisa ler a conversa em que a mensagem chegou. O prompt recebe esses dados quando a ação Executar assistente de etapa roda em uma automação com o gatilho Conteúdo enviado no projeto. No campo Prompt, abra o menu de variáveis. Em Gatilho, estes itens trazem os dados da mensagem:
Em Consultas, dois itens inserem a consulta
project_medias já preenchida:
Nas demais execuções, os dados do canal ficam vazios. Isso vale para o assistente que roda ao entrar ou sair da etapa, para a execução manual e para a automação com outro gatilho. No menu, um ícone ao lado de Gatilho e de Mensagens do canal do gatilho lembra essa condição.
O que fazer com o resultado
O resultado do assistente pode ser gravado de duas formas, e as duas podem ser usadas ao mesmo tempo.- No conteúdo do projeto
- Em um campo de formulário
O resultado é salvo como conteúdo do projeto, junto do restante do material. É a opção direta, boa para resumos, análises e textos redigidos.
Quando a execução falha
Chamadas de IA falham por motivos variados: o modelo indisponível, um tempo de resposta estourado, saldo insuficiente. Você decide o que acontece com o projeto nesse caso. A opção Mover para a etapa em caso de falha envia o projeto para uma etapa escolhida quando a execução não dá certo. Se nenhuma etapa for indicada, o projeto fica onde está.Acompanhando as execuções
Cada execução gera um registro, acessível pelo botão Execuções do assistente.
O registro guarda o resultado, o momento da execução e o desfecho de cada destino separadamente. Se a gravação no conteúdo do projeto der certo e a gravação no campo de formulário falhar, o registro mostra as duas situações.
A execução é assíncrona. O projeto se move na hora e o assistente roda em seguida, em segundo plano. Resultados aparecem alguns instantes depois da movimentação.
Pela API
Os assistentes de uma etapa ficam em/api/management/steps/{step}/assistants. O campo execute_on aceita moved (ao entrar na etapa), unlinked (ao sair da etapa) e manual.
A edição, em PUT /api/management/steps/{step}/assistants/{assistant}, exige os mesmos campos obrigatórios da criação: name, funnel_step_id, ai_agent_id, prompt, execute_on e o destino (result_as_media ou result_as_dynamic_form). Para mudar um campo só, leia o assistente com GET, altere o campo e envie o corpo inteiro.
Para parar um assistente, envie active: false nessa mesma edição. Novas execuções deixam de acontecer, e as que já estão na fila terminam normalmente.
Custo e limites
Cada execução de um assistente tem custo, e a quantidade de assistentes tem limite. A quantidade de assistentes de etapa também é limitada pelo plano. Ao atingir o teto, a criação de novos assistentes é bloqueada.Arquivar
Assistentes podem ser arquivados e desarquivados. Arquivar preserva a configuração e o histórico de execuções, mas tira o assistente de operação.Próximos passos
Automações
Para ações determinadas, em vez de conteúdo gerado.
Créditos de IA
Como o consumo é medido e recarregado.