VolundOS

Cofre (segredos e credenciais)

Como você guarda uma credencial para um agente usar sem nunca ver o valor. A credencial fica protegida; o agente recebe apenas uma referência e o valor é usado direto…

Atualizado em 12 de agosto de 2026

Cofre

Como você guarda uma credencial para um agente usar sem nunca ver o valor. A credencial fica protegida; o agente recebe apenas uma referência e o valor é usado direto no destino, sem aparecer em nenhum momento — nem na conversa, nem em nada que o agente escreva.

O que dá para fazer

  • Guardar uma credencial por agente: usuário e senha, um valor único (chave de API, token), código de autenticação de dois fatores, cartão de crédito, um bloco de variáveis de ambiente, ou uma configuração de rede privada (VPN).
  • Pedir uma credencial que falta: o agente solicita, aparece um formulário na conversa, você preenche e o trabalho continua de onde parou.
  • Usar a credencial num campo do navegador sem que o valor apareça em nenhum momento.
  • Gerar o código de autenticação de dois fatores automaticamente a cada uso, sempre atualizado.
  • Compartilhar uma credencial com outra pessoa ou com outro agente, com registro de cada uso.
  • Consultar o histórico de uso de uma credencial.
  • Ter variáveis de ambiente disponíveis automaticamente para o agente usar, sem precisar pedir nada.

Cofre de um agente, com as credenciais guardadas listadas por nome e tipo e nenhum valor à vista

Do que este módulo cuida

O cofre garante que o valor de uma credencial nunca precisa passar pela conversa, pelo que o modelo produz ou por qualquer registro que alguém leia depois. Você guarda o valor uma vez, escolhe onde ele vale (um agente, e a partir daí, opcionalmente, mais uma pessoa ou outro agente) e o restante — usar, repetir o uso, revogar — acontece sem que o valor volte a aparecer.

Preencher automaticamente um campo de formulário só funciona dentro do navegador. Para credencial usada de outro jeito — comando de terminal, biblioteca que lê do ambiente — o caminho é guardar como variável de ambiente, disponível automaticamente para o agente sem precisar pedir nada.

On this page