Ir para conteúdo
be-human.ai
← Voltar ao blog

Ferramentas e integrações

Botões de aprovação no Slack para agentes de IA: decida antes de gravar

Envie a ação proposta pelo agente ao Slack com pedido, evidências e prazo de validade, para que uma pessoa decida antes de qualquer escrita no sistema.

Capa tipográfica do Be Human com o título: Botões de aprovação no Slack para agentes de IA: decida antes de gravar
Ilustração conceitual criada com IA · Be Human

Para encaminhar a ação proposta por um agente ao Slack para aprovação, o agente publica um pedido estruturado em um canal dedicado ou em mensagem direta. O pedido informa a ação exata, o sistema de destino, as evidências que sustentam a proposta e um prazo de validade. A gravação só acontece depois que uma pessoa identificada clica no botão de aprovar. Um pedido recusado ou expirado deixa o sistema de negócio intacto, e o agente só recomeça com uma nova proposta.

Este artigo explica como montar esse fluxo, o que o cartão de pedido precisa conter e onde o ponto de aprovação deve ficar na cadeia que vai do agente até o sistema.

Principais pontos

  • O ponto de aprovação fica entre a proposta do agente e a gravação, para que o agente nunca execute a etapa final sozinho.
  • Cada pedido traz o conteúdo exato, as evidências, o nível de risco, um prazo de validade e um identificador armazenado, ao qual os botões se referem.
  • Aprovar executa a proposta armazenada. Nunca pede ao agente que gere a ação de novo depois que uma pessoa já a leu.
  • A autoridade para aprovar é verificada do seu lado, e não presumida pela participação no canal.
  • Pedidos expirados falham de forma segura, e o motivo da recusa volta ao agente como contexto para a próxima proposta.

Por que a aprovação deve vir antes da gravação, e não depois

Muitas equipes primeiro conectam o agente a uma ferramenta e só depois tentam acrescentar a revisão. Nessa altura, o agente já tem permissão de escrita, e cada revisão vira um trabalho de correção. Colocar a aprovação antes da gravação muda a pergunta que a pessoa responde. Em vez de verificar se a alteração foi feita corretamente, quem aprova decide se essa alteração específica deve acontecer.

A mensagem no Slack é apenas a superfície de entrega. O controle real é um registro de pedido guardado no seu próprio sistema, com estados como proposto, aprovado, recusado, expirado ou executado. Os botões no Slack mudam esse estado. A gravação só ocorre quando o estado passa para aprovado e o serviço executor confirma que o conteúdo armazenado continua igual ao que o aprovador viu.

essa distinção importa porque botões de chat são fáceis de clicar rapidamente. Um pedido claro e bem especificado é o que transforma um clique em uma decisão.

O que o cartão de pedido precisa conter

O cartão deve responder às perguntas que um aprovador faria diante da sua mesa. Ele precisa ser curto o bastante para ser lido em poucos segundos, mas completo o suficiente para que ninguém tenha de abrir outras três ferramentas para entendê-lo.

  • A ação em linguagem simples, por exemplo: “Criar um rascunho de pedido de compra para o fornecedor de limpeza, 12 unidades do item 4471.”
  • O sistema de destino e o objeto afetado, para que o aprovador saiba exatamente onde a alteração vai cair.
  • O conteúdo completo da proposta, seja no próprio cartão, seja em um link que abre uma visualização somente leitura do pedido armazenado.
  • As evidências: as mensagens, documentos ou registros de origem em que o agente se apoiou, linkados em vez de colados por inteiro.
  • Uma breve indicação do que o agente não tem certeza, algo que muitas vezes evita os erros mais caros.
  • O nível de risco e o motivo dele, usando categorias que a equipe definiu com antecedência.
  • O prazo de validade, o grupo de aprovadores autorizados a decidir e o identificador do pedido.

A seção de evidências merece atenção. Se o agente resumiu um e-mail de fornecedor, o texto desse fornecedor pode conter instruções dirigidas ao modelo. A orientação da OWASP sobre prevenção de injeção de prompt explica por que conteúdo não confiável deve ser tratado como dado a ser exibido, e não como instrução a ser seguida. No cartão, cite a origem e identifique o trecho como texto externo, para que o aprovador o leia como material a ser avaliado.

Passo a passo: encaminhar uma ação proposta ao Slack

A sequência a seguir funciona para a maioria dos agentes de negócio. Ela pressupõe que o agente pode propor ações, mas não pode executar operações de escrita diretamente.

  • Passo 1: defina as classes de ação que sempre exigem aprovação. Comece por tudo que cria um compromisso financeiro, altera o registro de um cliente, envia mensagem a uma parte externa ou apaga dados.
  • Passo 2: faça o agente emitir um objeto de proposta com campos fixos, em vez de texto livre. Campos fixos tornam o cartão previsível e tornam o conteúdo armazenado testável.
  • Passo 3: guarde a proposta no seu sistema com um identificador único, o estado definido como proposto, o prazo de validade e o grupo de aprovadores.
  • Passo 4: publique o cartão no canal ou na mensagem direta designados no Slack, com botões de aprovar e recusar cujo valor contenha apenas o identificador do pedido e a decisão escolhida.
  • Passo 5: receba a interação do botão em um servidor que você controla, verifique que a requisição veio realmente do Slack usando a checagem de assinatura que o próprio Slack fornece, e carregue o pedido armazenado pelo identificador.
  • Passo 6: confirme que o usuário que clicou está na lista de aprovadores do seu sistema. Estar no canal não basta.
  • Passo 7: se o pedido ainda estiver proposto e não tiver expirado, mude-o para aprovado e envie o conteúdo armazenado ao serviço executor, com uma chave de idempotência. Para entender por que essa chave importa, veja Idempotência em agentes de IA: evite ações duplicadas.
  • Passo 8: registre o resultado, atualize a mensagem no Slack para mostrar a decisão e o desfecho, e envie qualquer motivo de recusa de volta ao agente.

Mantenha os passos 5 a 7 em código que você testa diretamente. Não conte com o cliente do Slack para aplicar as regras. O clique em um botão é apenas um sinal.

Como desenhar os botões e as regras de expiração

Dois botões geralmente bastam: aprovar e recusar. Uma terceira opção, como “pedir ajustes”, pode ser útil quando o aprovador quer que o agente revise a proposta, mas ela deve gerar um novo pedido, e não editar o antigo no lugar. Editar um conteúdo já aprovado é justamente o que transforma, sem que ninguém perceba, uma ação revisada em outra ação.

A expiração precisa de um padrão definido com cuidado. Um pedido que ninguém lê não deve ficar ativo indefinidamente, porque o contexto do negócio pode ter mudado quando alguém finalmente clicar. Escolha uma janela compatível com a urgência de cada classe de ação e faça a expiração falhar de forma segura: o pedido passa para expirado, nada é executado e o agente é informado de que a proposta caducou. Se a ação ainda for necessária, o agente pode propô-la novamente com evidências atualizadas.

A idempotência também é importante aqui. O Slack pode entregar a mesma interação mais de uma vez, e as pessoas clicam duas vezes sem querer. O serviço executor deve tratar o identificador do pedido como chave, de modo que uma segunda aprovação para um pedido já executado devolva o resultado original, e não crie um segundo registro. A documentação da Stripe sobre requisições idempotentes mostra a versão do princípio do lado do provedor, e o mesmo raciocínio vale para as suas operações internas de escrita.

Por fim, defina o que acontece com um pedido quando os dados subjacentes mudam antes da aprovação. Uma regra simples funciona bem: se o registro de destino foi modificado depois da criação da proposta, o pedido é marcado como desatualizado e precisa ser gerado de novo. A aprovação deve sempre se referir a um estado conhecido da realidade.

Cenário ilustrativo: a retenção de um pagamento a fornecedor

O cenário a seguir é ilustrativo e não descreve um cliente real.

Uma pequena distribuidora usa um agente para ler extratos de fornecedores e preparar lotes de pagamento. O agente identifica uma fatura duplicada em um extrato e propõe colocar em retenção uma linha no sistema contábil. O cartão de pedido mostra os dois números de fatura, os valores correspondentes, o extrato de origem anexado como arquivo somente leitura e uma nota de que o agente não consegue confirmar se a segunda fatura foi creditada. O risco está marcado como financeiro, o prazo termina no mesmo dia útil e o grupo de aprovadores é formado pelo responsável financeiro e por um substituto.

O responsável financeiro abre o cartão, vê as evidências e recusa a retenção, com o motivo de que a nota de crédito está pendente. O agente recebe o motivo, registra-o junto ao fornecedor e não propõe a retenção novamente até que a nota de crédito apareça no extrato. Nada no sistema contábil mudou durante a troca, e o histórico de decisões mostra quem decidiu e por quê.

O valor desse fluxo não está em o agente ter acertado ou errado. Está em a pessoa com autoridade ter visto as evidências e tomado a decisão antes que o sistema fosse alterado.

Falhas comuns e como evitá-las

Alguns problemas aparecem repetidamente nessas configurações. Conhecê-los antecipadamente evita retrabalho.

  • Aprovação por participação no canal: qualquer pessoa em um canal movimentado pode clicar. Corrija com uma lista de aprovadores no servidor, ligada a funções definidas.
  • Conteúdo regenerado: o agente reescreve a ação entre o cartão e o clique. Corrija executando apenas a proposta armazenada.
  • Expiração silenciosa: pedidos caducam sem aviso, e o negócio presume que o trabalho foi feito. Corrija notificando quem fez o pedido e atualizando a mensagem no Slack.
  • Canais sobrecarregados: toda tarefa de baixo risco gera um cartão, e os aprovadores passam a clicar sem ler. Corrija encaminhando apenas as classes de ação que realmente precisam de decisão e revisando essa lista com regularidade.
  • Expansão de permissões: o serviço executor recebe acesso amplo de escrita porque isso era mais fácil de configurar. Corrija concedendo ao executor somente as operações de que ele precisa, o que a orientação da OWASP sobre autorização apoia ao exigir verificações aplicadas no servidor. Para os princípios por trás disso, veja Menor privilégio para agentes de IA: limite o acesso inicial.
  • Responsabilidade pouco clara: ninguém sabe quem mantém as regras de aprovação depois do lançamento. Atribua esse papel explicitamente e revise as regras sempre que uma ferramenta ou um processo mudar.

Quem constrói agentes costuma concentrar-se no modelo e subestima a superfície operacional. As diretrizes da Anthropic sobre a construção de agentes eficazes descrevem o valor de pontos de verificação deliberados, nos quais uma pessoa pode intervir. Na prática, esses pontos de verificação são justamente as partes que mais exigem manutenção.

Como a Be Human trata aprovações em operações gerenciadas

A Be Human desenha os fluxos de aprovação como parte do contexto operacional do agente desde o primeiro projeto. A primeira etapa define o papel único do agente, as ferramentas e a memória de que ele precisa, as classes de ação que exigem uma pessoa e um critério de sucesso que possa ser observado ao longo do tempo, como a proporção de propostas aprovadas sem revisão. Os grupos de aprovadores, as regras de expiração e o modelo de pedido armazenado são configurados com a sua equipe e testados com propostas reais antes de qualquer escrita ser habilitada.

Em operações gerenciadas, o trabalho continua depois do lançamento. Revisões de permissão verificam se as listas de aprovadores e os escopos do executor ainda correspondem ao negócio, avaliações recorrentes analisam uma amostra de pedidos aprovados e recusados para ver se os cartões trazem evidências suficientes, e a manutenção das integrações mantém as conexões com o Slack e com os sistemas atualizadas sempre que algum dos lados muda. Quando um caminho de aprovação falha, a resposta a incidentes restaura primeiro o estado de falha segura e só depois investiga a causa.

A abordagem é deliberadamente conservadora. Uma proposta pode ser útil mesmo quando a taxa de aprovação é baixa, porque as recusas mostram onde o contexto do agente está incompleto.

Como escolher a primeira ação a passar pelo Slack

O melhor primeiro fluxo de aprovação costuma ser estreito: uma ação, um grupo de aprovadores, um sistema e um cartão que uma pessoa ocupada consiga ler em menos de um minuto. Escolha uma ação em que uma gravação errada seja custosa, mas as evidências sejam fáceis de mostrar, e em que o negócio já tenha um responsável claro capaz de dizer sim ou não. Quando esse fluxo funcionar de forma confiável, adicionar uma segunda classe de ação é uma questão de estender o mesmo padrão, e não de desenhar outro. Se ainda não estiver claro qual tarefa merece esse primeiro lugar, faça o diagnóstico gratuito de IA da Be Human para identificar a primeira tarefa que vale entregar a um agente. Para decidir o canal, leia também Agente de IA no Slack ou no Microsoft Teams: qual escolher?.

Perguntas frequentes

Um agente de IA pode clicar em aprovar no Slack por conta própria? Não. A aprovação precisa vir de uma pessoa da sua lista de aprovadores, e o agente deve apenas criar a proposta. Seu servidor verifica a interação e confere o usuário que clicou com os seus próprios registros, de modo que o agente não tem caminho para se autoaprovar. Se o agente também publicar o cartão, deve usar uma conta sem nenhum direito de aprovação.

O que acontece se o aprovador estiver de férias e o pedido expirar? O pedido passa para expirado, nada é executado e quem fez o pedido é avisado na mesma conversa. Se a ação ainda for importante, o agente pode criar uma nova proposta com evidências atualizadas, e um grupo de aprovadores substituto pode ser definido antecipadamente para ausências previsíveis. A expiração é um recurso de segurança, por isso deve ser tratada como comportamento correto, e não como erro.

O cartão de aprovação deve incluir todos os dados brutos do sistema de origem? Normalmente não. Inclua os campos necessários para a decisão, o conteúdo exato que será executado e links para visualizações somente leitura das evidências. Colar registros inteiros deixa os cartões difíceis de ler, aumenta a chance de expor dados pessoais em um canal de chat e incentiva o aprovador a apenas passar os olhos.

O Slack é o lugar certo para isso, ou as aprovações devem acontecer dentro do sistema de negócio? O Slack funciona bem quando o aprovador já está ali e a decisão é rápida, enquanto uma fila dentro do sistema combina com grande volume ou com análises detalhadas. Muitas equipes começam pelo Slack e migram depois para uma fila mais completa, mantendo o mesmo modelo de pedido, para que a mudança não altere o comportamento do agente.

Seu próximo passo

Descubra primeiro onde um agente de IA cabe na sua empresa.

Faça o diagnóstico gratuito de IA da Be Human. Algumas perguntas sobre o seu trabalho mostram qual tarefa entregar primeiro a um agente, o que ele precisa saber e onde uma pessoa aprova.

Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.

Menos tarefas. Mais espaço para você.

Traga o trabalho para o qual falta tempo.

Agende uma conversa e teste 7 dias grátis um agente de IA personalizado ↗Ou faça o diagnóstico gratuito de IA →