Hooks de execução
Regras que rodam automaticamente em pontos críticos do trabalho do agente, sem programação.
Painel Admin → Hooks · Para: administradores ·
Pontos de execução
| Ponto | Quando roda |
|---|---|
| Antes do uso de ferramenta | Toda vez que o agente vai usar uma skill, na investigação, no chat e nas rotinas. |
| Depois do uso de ferramenta | Logo após o resultado da skill. |
| Após geração do plano | Quando uma investigação multi-agente gera o plano de etapas. |
| Ao acionar subagente | Quando uma etapa do plano inicia um subagente. |
Criar um hook
Em + Novo hook:
| Campo | O que faz |
|---|---|
| Nome | Identificação da regra. |
| Ponto de execução | Um dos quatro pontos acima. |
| Condição | Quando a regra se aplica: skill, ferramenta, host (aceita curingas, como prod-*), ambiente e nível de risco. Campo vazio vale para qualquer valor. |
| Ação | • Bloquear: a ação não é executada; • Exigir aprovação: a ação espera aprovação humana; • Notificar canal: envia um aviso para o canal escolhido; • Chamar webhook: envia os dados para uma URL sua, com assinatura; • Apenas registrar: grava na timeline, sem interferir. |
| Prioridade | Ordem de avaliação quando várias regras se aplicam. |
| Habilitado | Liga ou desliga a regra. |
Use Testar para simular a regra contra uma ação de exemplo antes de ligá-la.
Regras de funcionamento
- Os hooks só podem deixar o agente mais restrito, nunca mais livre do que a política de risco permite.
- Quando uma regra bloqueia, a ação não roda e o agente recebe o motivo.
- Cada acionamento fica na timeline do incidente: qual regra, em que ponto, qual ação e o resultado.
Exemplos.
- Antes do uso de ferramenta, Terminal em hosts
prod-*: exigir aprovação. - Após geração do plano: notificar o canal do NOC com o plano proposto.
- Antes do uso de ferramenta, qualquer skill de ITSM: chamar o webhook de auditoria.