Fila de Aprovação de Ferramentas
Aprove ou rejeite ações de ferramentas de alto risco antes da execução.
O que é a Fila de Aprovação?
É o ponto de controle humano para ações de alto risco: quando uma integração está marcada como tal, a execução não acontece na hora — ela fica pendente até alguém do workspace aprovar ou rejeitar no painel.
Níveis de risco de uma ferramenta
Ao criar ou editar uma custom tool, você escolhe entre dois níveis:
auto (automático)
A ferramenta executa imediatamente quando o agente decide usá-la. Indicado para leitura: consultar pedido, buscar produto, checar disponibilidade.
confirm (confirmação do visitante)
Antes de executar, o agente mostra a ação e os parâmetros no próprio chat e espera o visitante confirmar. Indicado para ações que criam algo em nome dele: agendar reunião, abrir chamado, enviar e-mail.
A confirmação do visitante acontece dentro da conversa e não passa pela fila. A fila de aprovação é o caminho separado, para ações que exigem decisão de alguém do seu time.
Hoje o formulário de custom tools oferece apenas auto e confirm. Ferramentas que exigem aprovação no painel são marcadas como alto risco na configuração da integração — se o seu workspace não tem nenhuma, a fila fica vazia, e é esse o comportamento esperado.
O que aparece na fila
| Campo | Descrição |
|---|---|
| Agente | Agente que solicitou a execução |
| Ferramenta | Nome e título da função |
| Argumentos | Parâmetros que serão enviados, em JSON |
| Tempo restante | Contagem regressiva até a expiração |
| Status | Pendente, Expirado, Aprovado ou Rejeitado |
Expiração automática
Cada solicitação tem prazo de validade (minutos). Sem decisão dentro do prazo, ela expira e a ferramenta não é executada — o agente segue a conversa informando que não conseguiu concluir a ação.
Ações disponíveis
- Aprovar — Executa a ferramenta com os argumentos exibidos e devolve o resultado ao agente
- Rejeitar — Bloqueia a execução; o agente é avisado e segue por um caminho alternativo
Revise os argumentos antes de aprovar. É neles que aparece um valor errado, um e-mail trocado ou um pedido que não bate com a conversa.
A página se atualiza sozinha a cada 10 segundos — basta deixá-la aberta.
Boas práticas
- Mantenha a fila monitorada — Uma solicitação pendente é uma conversa parada
- Defina responsáveis por turno — Combine quem olha a fila em cada horário
- Use aprovação com parcimônia — Exigir aprovação para muita coisa cria gargalo; reserve para o que é irreversível
- Se muita coisa expira — Ou o prazo é curto demais, ou falta cobertura da equipe