Aprovação humana em chamadas de ferramentas de IA (Human-in-the-loop)
Você pode exigir que um agente de IA obtenha aprovação humana antes de executar uma ferramenta específica. Quando uma ferramenta configurada para aprovação humana for acionada, o fluxo de trabalho é pausado e aguarda que um revisor autorizado realize uma das seguintes ações:
- Aprovar: a ferramenta é executada com os parâmetros fornecidos pela IA.
- Rejeitar: a operação é cancelada e não é executada.
Essa funcionalidade permite supervisão seletiva sobre as chamadas de ferramentas em fluxos de trabalho de IA, facilitando a aplicação de aprovação humana adicional quando ferramentas forem usadas em operações de alto risco — como enviar mensagens, modificar registros ou excluir dados.
Quando usar aprovação humana
A aprovação humana (HITL – Human-in-the-loop) é especialmente útil nos seguintes cenários:
- Operações irreversíveis: exclusão de dados, envio de comunicações externas ou realização de compras.
- Exigências regulatórias: indústrias regulamentadas podem exigir aprovação humana para certas operações automatizadas.
- Decisões de alto valor: ações com impacto significativo nos negócios se beneficiam da supervisão humana.
- Construção de confiança em fluxos de trabalho de IA: comece com aprovação humana habilitada e reduza gradualmente à medida que a confiança aumenta.
O HITL pode ser aplicado a todas as ferramentas conectadas a um nó AI Agent ou apenas a ferramentas específicas, oferecendo um controle mais granular do que mecanismos gerais de controle de saída.
Como funciona
- O agente de IA determina que precisa usar uma ferramenta com aprovação humana habilitada.
- O fluxo de trabalho é pausado e uma solicitação de aprovação é enviada pelo canal configurado (por exemplo, Slack, Telegram ou interface de chat do n8n).
- O revisor humano recebe a solicitação, que inclui a ferramenta que a IA deseja usar e seus parâmetros.
- O revisor aprova ou rejeita a solicitação.
- Se aprovada, a ferramenta é executada com os parâmetros especificados pela IA; se rejeitada, a operação é cancelada e a IA é informada de que a solicitação foi rejeitada.
Canais de aprovação diferentes
A etapa de aprovação pode ocorrer por um canal diferente da interação principal. Por exemplo, um usuário pode interagir com o agente de IA pela interface de chat do n8n, enquanto a solicitação de aprovação é encaminhada para uma pessoa específica no Slack.
Configurando aprovação humana para ferramentas
Passo 1: Abrir o painel de ferramentas
No seu fluxo de trabalho, clique no conector Tools (Ferramentas) do nó AI Agent para abrir o painel de ferramentas.
Passo 2: Adicionar etapa de aprovação humana
- No painel de ferramentas, localize a seção Human review (Aprovação humana).
- Escolha seu canal de aprovação preferido entre as opções disponíveis.
- Configure o canal com as credenciais e configurações apropriadas.
Passo 3: Conectar ferramentas à etapa de aprovação
- Adicione as ferramentas que exigem aprovação ao conector de ferramentas da etapa de aprovação humana.
- Configure cada ferramenta da forma habitual.
Canais de aprovação disponíveis
Você pode usar qualquer um dos seguintes serviços como canal de aprovação humana:
| Canal | Descrição |
|---|---|
| Chat | Chat interno do n8n |
| Slack | Envia solicitações de aprovação para canais ou mensagens diretas no Slack |
| Discord | Envia solicitações de aprovação para canais no Discord |
| Telegram | Envia solicitações de aprovação via Telegram |
| Microsoft Teams | Envia solicitações de aprovação para canais ou chats no Teams |
| Gmail | Envia solicitações de aprovação por e-mail via Gmail |
| WhatsApp Business Cloud | Envia solicitações de aprovação via WhatsApp |
| Google Chat | Envia solicitações de aprovação para o Google Chat |
| Microsoft Outlook | Envia solicitações de aprovação por e-mail via Outlook |
Usando expressões em ferramentas com aprovação humana
Variável $tool
Ao configurar a etapa de aprovação humana, você pode usar a variável $tool para construir uma mensagem contextualizada para o revisor, explicando o que a IA está tentando fazer. Essa variável possui dois atributos:
| Atributo | Descrição |
|---|---|
$tool.name | Nome da ferramenta que o agente de IA está tentando chamar (ou seja, o nome exibido no canvas do n8n). |
$tool.parameters | Parâmetros que a IA está tentando usar na chamada da ferramenta, incluindo todos os campos definidos no schema de entrada da ferramenta com a expressão $fromAI(). |
Exemplo de configuração de mensagem:
A IA pretende usar {{ $tool.name }} com os seguintes parâmetros:
{{ $tool.parameters }}
Isso ajuda o revisor a entender claramente a ação proposta antes de aprovar ou rejeitar a solicitação.
Usando $fromAI() em ferramentas com aprovação humana
A função $fromAI() funciona normalmente em ferramentas conectadas a uma etapa de aprovação humana. Isso significa que a IA pode especificar dinamicamente os parâmetros da ferramenta, e esses valores determinados pela IA são exatamente os que o revisor humano vê e aprova.
Melhores práticas para prompts do sistema
Para que o agente de IA compreenda e responda corretamente quando uma chamada de ferramenta for rejeitada, inclua informações sobre a configuração de aprovação humana no seu prompt do sistema.
Necessidade de configurar o prompt do sistema
Certifique-se de incluir no prompt do sistema detalhes sobre as ferramentas configuradas e as etapas de aprovação humana. Isso ajuda a IA a entender quais ferramentas exigem aprovação e como responder de forma adequada quando uma chamada é rejeitada.
Recomenda-se incluir:
- Quais ferramentas exigem aprovação humana
- O que acontece quando uma aprovação é rejeitada
- Como a IA deve responder à rejeição (por exemplo, notificar o usuário, sugerir alternativas ou solicitar esclarecimentos)
Chamadas em cadeia e subagentes
Quando um agente de IA é usado como ferramenta de outro agente de IA, as etapas de aprovação humana no subagente funcionam normalmente.
Recursos relacionados
- Nó AI Agent
- Tools Agent
- O que são ferramentas em IA?
- Permitir que a IA especifique parâmetros de ferramentas com
$fromAI()