VolundOS

Aprovações (humano no meio do run)

O agente para, pede autorização e só age depois que uma pessoa decide. Existe para ação de efeito duradouro ou irreversível — o ponto em que autonomia sem freio custa caro.

Atualizado em 12 de agosto de 2026

Aprovações

O agente para, pede autorização e só age depois que uma pessoa decide. Existe para ação de efeito duradouro ou irreversível — o ponto em que autonomia sem freio custa caro.

O que dá para fazer

  • Ver a fila de pedidos pendentes e o contexto de cada um.
  • Aprovar ou recusar; abortar o pedido e o run que ele suspendeu.
  • Decidir também pela API pública, para quem integra com um fluxo próprio de aprovação.
  • Receber um aviso quando um pedido entra na fila.

Fila de aprovações pendentes sendo aberta: o pedido do agente na lista e, ao clicar, o contexto completo da ação que ele quer executar

Do que este módulo cuida

Aprovação e guarda agem no mesmo momento — antes de uma ferramenta rodar —, mas resolvem problemas diferentes: aprovação pausa e pergunta a uma pessoa; guarda nega sozinha, sem perguntar a ninguém. Uma decisão já tomada é reaproveitada por um tempo, para o agente repetir a mesma chamada sem abrir um pedido novo a cada tentativa; a mesma ferramenta com argumentos diferentes conta como um pedido novo, e recusar não impede tentativas futuras — se o agente tentar de novo, a pessoa decide de novo.

O módulo depende do motor de execução conseguir suspender e retomar um run sem perder o que já foi feito. É parente do cofre, que resolve o caso específico de pedir uma credencial sem expor o valor.

Um pedido sem decisão mantém o run suspenso, e hoje não há expiração automática — o ambiente pode ser reciclado antes de alguém decidir. A saída manual é abortar: isso encerra o pedido e o run.

On this page