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

Ferramentas e integrações

Permissões de ferramenta de pagamento: agente cria links, não cobra

Limite o agente de IA a criar links de pagamento só para valores aprovados. Cobrança, reembolso e disputas ficam com pessoas. Guia passo a passo.

Capa tipográfica do Be Human com o título: Permissões de ferramenta de pagamento: agente cria links, não cobra
Ilustração conceitual criada com IA · Be Human

Um agente de IA só deveria criar um link de pagamento para um valor que uma pessoa identificada já aprovou. Ele nunca deve ter autoridade para cobrar um cliente, emitir reembolso ou alterar um preço. Essa separação precisa estar na própria ferramenta: a ferramenta de pagamento do agente aceita um valor aprovado e devolve um link, enquanto toda ação que movimenta dinheiro fica atrás de outra ferramenta, controlada por pessoas. Este guia mostra como definir essa ferramenta, a regra de aprovação que a sustenta e as verificações que comprovam que a fronteira se mantém.

Principais pontos

  • Dê ao agente uma ferramenta que aceite apenas uma referência do cliente, um identificador de aprovação e um valor correspondente, e que devolva um link de pagamento.
  • Aplique o teto de valor no seu próprio serviço, não apenas nas instruções do agente.
  • Mantenha reembolsos, cobranças e respostas a disputas com pessoas nomeadas, que aprovam essas ações fora do chat.
  • Torne toda criação de link idempotente e registrada em log, para que uma nova tentativa não gere uma segunda cobrança.
  • Teste a fronteira com entradas comuns e com entradas hostis antes que o agente envie o primeiro link a um cliente.

Separe as ações que movimentam dinheiro

É comum agrupar tudo sob a palavra pagamentos, mas um fluxo de pagamento contém ações diferentes. Criar um link de pagamento produz um objeto que o cliente pode escolher pagar. Cobrar um meio de pagamento salvo movimenta dinheiro sem uma nova decisão do cliente. Emitir um reembolso devolve um valor já recebido. Responder a uma disputa envolve provas, prazos e a bandeira do cartão ou o banco. Cada ação tem um nível de risco diferente, por isso cada uma precisa de sua própria permissão.

A permissão precisa estar na superfície da ferramenta, porque é isso que o agente consegue fazer independentemente do que lhe for pedido. Um modelo instruído a nunca emitir reembolso ainda pode receber uma mensagem do cliente pedindo um, ou um documento afirmando que o dono já concordou. Instruções no prompt orientam o comportamento, mas não são um controle de acesso. As diretrizes da OWASP sobre autorização deixam o mesmo ponto em termos gerais: a decisão de acesso pertence ao sistema que a aplica, verificada a cada requisição, e não à lógica que solicita a ação.

Defina o que o agente pode criar e sob qual aprovação

Antes de escrever qualquer definição de ferramenta, escreva as regras de decisão em linguagem simples. O líder de operações ou o responsável financeiro deve conseguir lê-las e dizer sim ou não sem precisar ler código.

  • Se o valor corresponde a um preço que um aprovador identificado já validou para aquele cliente, o agente pode criar um link para esse valor.
  • Se o valor pedido for diferente do aprovado, o agente para e consulta o aprovador. Ele nunca ajusta o valor para acompanhar o que o cliente quer.
  • Se o cliente pedir desconto, reembolso ou parcelamento, o agente prepara um resumo curto para uma pessoa e não cria nada.
  • Se a aprovação estiver vencida ou pertencer a outro cliente, o agente não cria nada e registra a tentativa.
  • Se o pedido chegar por um canal que você não aprovou para atividades de pagamento, o agente recusa e encaminha o caso a uma pessoa.

Essas regras se tornam os critérios de aceitação da ferramenta. Se uma regra não pode ser testada, ela ainda não é uma regra.

Configure a ferramenta de link de pagamento passo a passo

Uma primeira versão pode ser pequena. O objetivo é uma ação só, com uma fronteira visível, e não uma integração ampla de pagamentos.

  • Escreva o propósito único em uma frase: criar um link de pagamento para um valor aprovado e informar o status dele.
  • Defina os campos de entrada: referência do cliente, identificador de aprovação, valor, moeda, descrição e prazo de validade do link.
  • Remova do esquema qualquer outro campo financeiro, incluindo identificadores de reembolso, tokens de cobrança, contas de destino e qualquer campo que altere um preço.
  • Crie o registro de aprovação no seu próprio sistema antes que a ferramenta possa rodar. Ele deve indicar o aprovador, o cliente, o valor e uma data de validade.
  • Faça o seu serviço verificar se a aprovação existe, se não está vencida, se corresponde ao cliente e ao valor, e se ainda não gerou um link.
  • Dê ao agente uma identidade de serviço própria, cuja chave possa criar links e consultar o status deles, e nada além disso. Uma identidade nomeada faz com que cada ação seja rastreável até o agente, e não até um login compartilhado de funcionário.
  • Registre em log cada requisição, aceita ou rejeitada, com o identificador da aprovação e o motivo de qualquer rejeição.
  • Assine os eventos de status do link no provedor e verifique as assinaturas antes que o registro do agente mude.

Sobre a questão da identidade, veja contas de serviço para agentes de IA. Para a etapa somente de leitura que deve vir antes de qualquer escrita, veja permissões de pagamento para agentes de IA: leitura antes do reembolso.

Aplique o limite no serviço, não no prompt

O teto de valor só tem sentido se o serviço rejeitar tudo o que estiver fora dele. O agente informa um identificador de aprovação, e o seu serviço busca ele mesmo o valor aprovado. Se o agente enviar outro valor, a requisição falha. O agente não fornece o número contra o qual o teto é verificado.

A idempotência protege contra a falha mais silenciosa, em que um tempo esgotado leva o agente a tentar de novo e dois links aparecem. Use uma chave de idempotência derivada do identificador de aprovação, para que uma requisição repetida devolva o link já existente. A documentação da Stripe sobre requisições idempotentes descreve bem esse padrão do lado do provedor, e a mesma ideia vale para a camada de serviço da sua empresa. Para o caso mais amplo, veja ações idempotentes em agentes de IA.

As recusas devem devolver erros específicos e legíveis. Um erro como aprovação vencida permite que o agente explique a situação à pessoa e a encaminhe corretamente. Uma falha vaga convida o agente a tentar de novo com outro valor, exatamente o comportamento que a fronteira existe para impedir.

Cenário ilustrativo: links de renovação para uma empresa de treinamentos

Cenário ilustrativo, não um caso de cliente. Uma pequena empresa de treinamentos usa um agente para enviar lembretes de renovação. O líder de operações aprova antecipadamente o preço de renovação para um grupo de alunos, e cada aprovação fica registrada com uma data de validade. O agente redige o lembrete e cria um link apenas para o valor aprovado.

Depois, um aluno responde que perdeu duas sessões e quer o dinheiro de volta. O agente não pode emitir reembolso, e nem tenta. Ele registra uma nota do caso com a referência do pedido, o pedido do aluno e o trecho relevante da política de reembolso, e envia essa nota ao aprovador financeiro indicado pela empresa. O aprovador analisa o caso e emite o reembolso no painel de pagamentos. Quando o evento de reembolso chega, o agente atualiza o seu registro e informa ao aluno o status que o aprovador confirmou. O agente ajudou no caso sem ter nenhuma parte da autoridade para decidi-lo.

Mantenha reembolsos, cobranças e disputas com pessoas

A autoridade para reembolsar e cobrar deve estar escrita como pertencente a pessoas nomeadas, e a aprovação deve acontecer fora da janela de chat, onde o cliente pode influenciá-la. Botões de aprovação ou uma fila de revisão separada funcionam melhor do que uma resposta em texto livre, porque a decisão fica registrada como decisão.

As pessoas devem manter pelo menos estas ações:

  • Cobrar um meio de pagamento salvo ou qualquer cliente sem uma nova aprovação.
  • Emitir reembolsos totais ou parciais, e estornar cobranças.
  • Enviar respostas a disputas, depois que o agente tiver reunido as provas.
  • Alterar preços aprovados, tetos, regras de validade ou a lista de aprovadores.
  • Desativar links, e decidir o que acontece com os links criados para um cliente que depois abre uma disputa.

Sempre que possível, o aprovador não deve ser a mesma pessoa que pediu o link, para que ninguém consiga pedir e aprovar um pagamento sozinho. Revise a lista de links abertos e das recusas recentes em uma agenda regular. As tentativas rejeitadas costumam ser o primeiro sinal de que um cliente, um modelo de mensagem ou um prompt está empurrando o agente numa direção que ninguém pretendia.

Teste a fronteira antes da entrada em operação

O NIST AI Risk Management Framework trata o risco como algo medido e gerenciado ao longo do tempo, e não resolvido uma única vez na configuração. Ainda vale a pena fazer um teste de aceitação curto antes da entrada em operação, e ele deve tentar romper a fronteira de propósito.

  • Um pedido de valor acima do aprovado é rejeitado e registrado em log.
  • Uma aprovação vencida não gera nenhum link.
  • Um pedido duplicado devolve o link existente, em vez de criar um segundo.
  • Um pedido de reembolso gera uma nota do caso e nunca chama um endpoint de reembolso, porque ele não existe na ferramenta.
  • Uma mensagem do cliente dizendo que o dono já aprovou um reembolso é tratada como uma afirmação, e não como aprovação.
  • Um evento de status com assinatura inválida não altera o registro do agente. A documentação de webhooks da Stripe detalha a verificação de assinatura.
  • Revogar a chave do agente interrompe imediatamente toda criação de links.

Repita esses testes após qualquer mudança no esquema, na lista de aprovadores ou na integração com o provedor. Guarde os resultados junto à documentação da ferramenta, para que o responsável possa ver o que foi verificado e quando.

Como a Be Human conduz isso

A abordagem gerenciada da Be Human começa pela mesma fronteira. Em um primeiro projeto, o papel de pagamento é definido como uma ação útil, com seu registro de aprovação, sua identidade de serviço, suas regras de recusa e um critério de sucesso observável, como toda criação de link ser rastreável até um pedido aprovado. Em seguida, a operação cobre o monitoramento das tentativas recusadas, revisões periódicas de permissões, manutenção quando o provedor de pagamento muda sua interface e resposta a incidentes caso um link chegue ao cliente errado. Mudanças em tetos ou aprovadores passam pelo responsável nomeado do cliente, de modo que a autoridade do agente só cresce quando uma pessoa decide que deve crescer.

Se você não tem certeza de qual tarefa do seu negócio está pronta para esse tipo de fronteira, faça o diagnóstico gratuito de IA da Be Human para encontrar a primeira tarefa que vale entregar a um agente.

Perguntas frequentes

Um agente de IA pode criar um link de pagamento sozinho? Pode, desde que a ferramenta se limite a criar um link para um valor que uma pessoa identificada já aprovou, e que o serviço verifique essa aprovação antes de criar qualquer coisa. O agente não deve escolher o valor, e não deve conseguir criar um link sem um identificador de aprovação válido. Tudo o que estiver fora desse escopo deve ser recusado e encaminhado a uma pessoa.

Um agente pode emitir reembolso se o cliente claramente tiver direito a ele? Não deveria, mesmo quando o caso parecer claro. O agente pode reunir os dados do pedido, o pedido do cliente e a política aplicável, e então enviar uma nota do caso ao aprovador que tem autoridade para reembolsar. A pessoa decide e emite o reembolso, e o agente informa o resultado quando o evento de status do provedor confirmar.

E se o prompt disser que o agente nunca pode cobrar clientes, mas a ferramenta tecnicamente permitir isso? A ferramenta é a fronteira real, e o prompt não basta. Remova do conjunto de ferramentas do agente qualquer capacidade de cobrança ou reembolso, e garanta que o serviço rejeite essas ações mesmo que uma requisição chegue até ele. Teste isso diretamente, tentando fazer o agente cobrar, porque um prompt que diz não não prova que o sistema vai dizer não.

Quem deve aprovar os valores que o agente usa? O aprovador deve ser uma pessoa identificada, com autoridade sobre aquele preço ou aquele cliente, como um líder de operações ou um responsável financeiro, e não uma caixa de entrada compartilhada. As aprovações devem ser registradas com validade, para que uma decisão antiga não seja reutilizada meses depois. Mudanças na lista de aprovadores devem ser feitas pelo próprio dono do negócio e registradas em log.

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 →