Aprenda a adicionar uma etapa de revisão humana a um agente de IA, para que uma pessoa confira o output do agente antes de ele seguir adiante.
👤 Para super admins e company admins
🔐 Disponível em todos os planos
🎯 Para quem quer manter uma pessoa no controle do que o agente de IA produz
O que isso resolve:
Coloca uma conferência humana sobre o output da IA
Direciona a revisão para uma pessoa específica, com o SLA da fase aplicado automaticamente
Procurando por validação humana em automações, e não em agentes de IA? Acesse Implementando human-in-the-loop em automações críticas.
Antes de começar
⚠️ Importante: Estes triggers não estão disponíveis para a validação humana:
Uma atividade for recorrente
Um alerta for acionado
Um card sair de uma fase
Se um deles estiver selecionado, a ação de validação humana aparece desabilitada. Se você adicionar a validação humana antes de escolher um trigger, esses triggers aparecem desabilitados na lista.
Passo a passo: Como configurar a Validação Humana
1. Vá até o seu agente de IA e abra o behavior ao qual você quer adicionar a revisão.
2. Nas instruções do behavior, digite / para abrir o dropdown.
3. Em Actions, escolha “Solicitar validação humana”.
4. No modal, preencha o campo Título. Ele nomeia a validação que a pessoa revisora recebe.
4.1. Clique no botão "+” e escolha um campo ou atributo do card para montar o título automaticamente.
4.2. Ou digite o título manualmente.
5. Em Enviar para,, selecione ou digite o email da pessoa que deve fazer a revisão.
⚠️ Importante: Se a pessoa revisora estiver fora do pipe, da empresa ou do Pipefy, ative o compartilhamento do formulário de fase ligada a esta validação. Sem isso, ela não consegue abrir a task.
6. Clique em Save. O chip de validação humana é adicionado às instruções do behavior.
Como a pessoa revisora recebe a validação
Toda vez que este behavior roda, a pessoa que você atribuiu recebe a revisão como uma tarefa.
1. Na página inicial do Pipefy, acesse a área de Tarefas e Solicitações.
2. Ao abrir, as tarefas pendentes aparecem listadas, por exemplo: Validação de relatório de despesas.
3. A pessoa revisora também recebe um email, com um botão que leva direto até a tarefa.
Ao clicar na tarefa, a pessoa revisora vê o formulário, adiciona a decisão e clica no botão de envio.
A tarefa abre o formulário da fase ligada ao seu trigger e segue o SLA da fase.
ℹ️ Dica: A pessoa revisora decide com base no que está no formulário da fase, então dê contexto suficiente ali. Adicione um campo de dynamic content no topo desse formulário para mostrar instruções, links ou dados puxados do card.
Veja como em Como usar o campo de conteúdo dinâmico em um formulário.
Qual formulário a pessoa revisora vê
A tarefa sempre abre um formulário de fase. Qual fase ela usa depende do gatilho do comportamento:
Trigger | Formulário de fase que a pessoa revisora vê |
Um card for criado | A primeira fase do pipe |
Um card entrar em uma fase | A fase em que o card entra |
Um campo for atualizado | A fase onde esse campo está |
Um email for recebido | A fase onde o email chega |
Todos os cards conectados forem movidos para uma fase | A fase de destino |
Como encadear comportamentos após uma validação
Se o seu agente tem mais de um behavior, você pode fazer o próximo behavior esperar a validação humana ser concluída.
💡 A ideia: usar o campo que a pessoa revisora preenche para trigar o behavior seguinte.
Exemplo:
O Behavior 1 solicita validação humana. A fase de validação tem um campo de radio button chamado Decisão final, com as opções Aprovar e Rejeitar
Para o Behavior 2 rodar somente após a revisão:
No Behavior 2, defina o trigger como Um campo for atualizado
Escolha Decisão final como o campo a ser observado.
Siga com o setup normal do behavior.
Agora o Behavior 2 roda somente quando a pessoa revisora preenche o campo Decisão final, o que acontece assim que a validação é concluída.