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

Infraestrutura de IA personalizada

De quem devem ser as contas e chaves de API do agente de IA?

Conta de modelo da empresa ou do parceiro? Compare cobrança, controle e saída e veja de quem devem ser as chaves de API que o seu agente de IA usa.

Caixas de carvalho encaixadas sobre uma laje de travertino, com a menor delas, de alça de latão, separada sobre um ladrilho de mármore verde sob luz quente.
Ilustração conceitual criada com IA · Be Human

Sobre de quem devem ser as contas e chaves de API do agente de IA, a resposta na maioria dos casos é esta: a empresa deve ser titular da conta no provedor de modelo, da relação de cobrança e dos termos de dados, e o agente deve rodar com chaves de API de escopo limitado, emitidas dentro dessa conta. Uma conta em nome do parceiro pode funcionar em um piloto curto e bem delimitado, mas transfere a visibilidade de custo, o tratamento de dados e o controle de saída para as mãos de outra pessoa. Um teste simples resolve a questão: se o seu parceiro de implementação sumisse amanhã, você conseguiria manter o agente funcionando, ou desligá-lo, sem pedir permissão a ninguém?

Principais pontos

  • A propriedade está na conta, não na chave. Quem administra a conta controla a cobrança, os termos de dados, os limites de uso e o poder de revogar acessos.
  • Uma conta em nome da empresa dá faturas diretas, termos de dados diretos e uma saída limpa, ao custo de exigir um responsável interno e uma rotina financeira básica.
  • Uma conta em nome do parceiro é mais rápida de começar e mais fácil de administrar, mas esconde o uso atrás da fatura do parceiro e dificulta a saída.
  • O caminho intermediário prático é uma conta da empresa com chaves separadas e de escopo limitado por papel de agente e por ambiente, guardadas em um gerenciador de segredos.
  • Seja qual for a escolha, registre por escrito quem é titular de cada conta, quem pode rotacionar cada chave e como o acesso é revogado antes de emitir a primeira chave.

O que significa ser dono de uma chave de API de IA?

Uma chave de API é uma credencial. Ela prova ao provedor de modelo que uma requisição vem de alguém autorizado a fazê-la e vincula essa requisição a uma conta. A chave em si é a parte menos interessante. A propriedade mora na conta por trás dela.

A conta concentra cinco coisas que importam para um negócio:

  • O contrato e os termos de dados, incluindo como prompts e respostas podem ser retidos ou usados.
  • A forma de pagamento e as faturas.
  • Os limites de uso, os limites de taxa e os registros que mostram quem consumiu o quê.
  • A lista de pessoas que podem criar, ver e revogar chaves.
  • O histórico necessário para auditar o que o agente fez com o acesso ao modelo.

Quem administra a conta controla as cinco. Ter uma chave sem administrar a conta se parece mais com usar um crachá de visitante do que com ser dono do prédio.

Três partes diferentes costumam ser chamadas de “o provedor” nessas conversas, e misturá-las gera confusão. O provedor de modelo opera o modelo. Um provedor de nuvem pode oferecer o mesmo modelo pela conta de nuvem que você já tem. O parceiro de implementação constrói e opera o agente. Neste artigo, conta da empresa significa que a conta está no nome da sua empresa, seja aberta direto com o provedor de modelo, seja pela sua própria conta de nuvem. Conta do parceiro significa que a conta pertence ao parceiro de implementação, que repassa o acesso ao modelo para você, normalmente dentro de uma única fatura combinada.

O que muda quando a empresa é titular da conta?

A primeira mudança é a cobrança. Você vê a fatura do próprio provedor de modelo e o detalhamento de uso, em vez de um valor agregado. Isso permite ligar o gasto a um papel de agente e medir o custo por trabalho concluído, hábito que está por trás da abordagem de economia unitária descrita pela FinOps Foundation. Um total mensal diz muito pouco. O custo por consulta de fornecedor atendida ou por resposta redigida mostra se o papel vale a pena.

A segunda mudança é o controle. Você decide quem pode criar chaves, define limites de gasto e consegue revogar qualquer chave em uma única sessão de trabalho. A terceira são os termos de dados. O contrato é com você, então o jurídico e a segurança leem diretamente as condições de retenção e processamento, em vez de depender de um resumo. A quarta é a continuidade. Se você trocar de parceiro ou de modelo, a conta, o histórico de uso e a relação com o provedor continuam onde estão.

Ser titular também traz trabalho. Alguém precisa administrar a conta, alguém precisa ser o substituto, e alguém no financeiro precisa saber que a fatura vai chegar e que ela varia com o uso. Alertas de gasto existem exatamente por isso. Você também passa a responder pela higiene das chaves: onde são guardadas, quem pode vê-las e quando são rotacionadas.

A falha mais comum é banal. A conta é aberta com o e-mail pessoal de um funcionário e com o cartão pessoal dele para começar rápido, e depois essa pessoa muda de função ou sai da empresa. Abra a conta com um endereço corporativo baseado em função (por exemplo, um e-mail de área, não de pessoa), com forma de pagamento da empresa e com pelo menos dois administradores nomeados. A fatura do modelo também é só uma parte do custo de operar um agente; o artigo sobre o custo total de propriedade de um agente de IA cobre o restante.

Quando uma conta em nome do parceiro é aceitável?

Há motivos legítimos para começar na conta de um parceiro. A empresa pode ainda não ter um caminho de compras para um novo fornecedor. Pode querer um teste curto com material não sensível antes de assumir qualquer compromisso. Ou pode não ter ninguém disponível para administrar uma conta nas primeiras semanas. Nesses casos, a conta do parceiro tira atrito do caminho, e a troca é justa se os termos forem claros.

Use uma conta do parceiro apenas quando estas condições estiverem por escrito:

  • O arranjo tem prazo definido, com data de transferência.
  • O uso é informado por papel de agente em um formato que você consegue ler, e não diluído em uma cobrança única e indiferenciada.
  • As regras de tratamento de dados que se aplicam ao seu conteúdo estão declaradas, incluindo eventuais subprocessadores.
  • Seus dados, prompts e a configuração do agente podem ser exportados quando você pedir.
  • Nenhum dado sensível da empresa ou de clientes entra no agente até que a conta passe para o seu nome.

Os riscos continuam reais mesmo com essas condições. A cobrança é mais difícil de auditar. Uma conta compartilhada pode dividir limites de taxa entre os clientes do parceiro. Você pode ficar preso a termos que nunca leu. E, quanto mais o arranjo dura, mais a configuração do agente, as integrações e o histórico se misturam a uma conta que você não consegue administrar.

Cenário ilustrativo: uma distribuidora de médio porte começa um piloto na conta de um prestador porque é o jeito mais rápido de testar um agente que faz a triagem de e-mails de fornecedores. O piloto funciona e, sem alarde, vira produção. Meses depois, o contrato com o prestador termina. As chaves estão no ambiente do prestador, ninguém sabe dizer qual parte da fatura era uso de modelo e os termos de dados nunca foram revisados. Mover o agente significa abrir uma nova conta, reemitir todas as chaves e testar de novo todas as integrações, tudo sob pressão de prazo. Nada disso era inevitável. Uma data de transferência e um relatório de uso teriam evitado a maior parte do problema.

Uma bússola de latão sobre um mapa marfim dobrado e em branco, ao lado de uma corda de linho com um nó corrediço frouxo, sobre travertino sob luz quente.
Ilustração conceitual criada com IA · Be Human

Como cobrança, controle e saída se comparam?

As diferenças ficam mais claras lado a lado. Use a lista como guia de decisão: para cada dimensão, pergunte qual lado você defenderia com tranquilidade diante do seu responsável financeiro e do seu responsável de segurança.

  • Cobrança: uma conta da empresa mostra a fatura do próprio provedor e o uso por projeto, então o gasto pode ser ligado a um papel de agente. Uma conta do parceiro costuma mostrar um valor combinado único, e você depende dos relatórios do parceiro para entendê-lo.
  • Controle: na sua conta, você define limites de gasto, cria e revoga chaves e decide quem é administrador. Na conta do parceiro, esses poderes são dele, e você pede as mudanças.
  • Termos de dados: na sua conta, há um acordo direto que você pode revisar com o jurídico e a segurança. Na conta do parceiro, você herda termos que não assinou, além da forma como o parceiro trata o seu conteúdo.
  • Capacidade: uma conta compartilhada do parceiro pode dividir limites de taxa entre vários clientes, então o dia de pico de outro cliente pode deixar o seu agente lento. Uma conta dedicada tem limites próprios.
  • Continuidade: se a relação com o parceiro termina, um agente em conta da empresa mantém conta, histórico e chaves, e apenas o acesso do parceiro é removido. Um agente em conta do parceiro pode parar ou precisar ser reconstruído.
  • Saída: sair de um arranjo com conta da empresa significa revogar o acesso do parceiro e emitir novas chaves. Sair de um arranjo com conta do parceiro significa abrir uma nova conta, reemitir todas as chaves, redirecionar todas as integrações e verificar se o agente continua se comportando da mesma forma.
  • Velocidade: a conta do parceiro ganha no primeiro dia. A diferença diminui rápido, porque abrir uma conta costuma ser uma tarefa administrativa modesta, não um projeto.

Entre os dois modelos fica o arranjo que a maioria das empresas de médio porte acaba preferindo: a empresa é titular da conta e o parceiro trabalha dentro dela, com acesso limitado e revogável. Você ganha a visibilidade e os direitos de saída de quem é dono, e o parceiro continua podendo fazer o trabalho. Evitar a dependência de fornecedor é, em grande parte, manter esses pontos de controle nas suas mãos, como discutido em como evitar dependência de fornecedor de IA em agentes.

Como configurar contas e chaves?

Este plano serve para o primeiro agente e escala para vários. Ele pressupõe uma conta da empresa, operada por um parceiro ou por uma equipe interna dentro dela.

  • Abra a conta no nome legal da empresa, com um endereço de administração baseado em função, uma forma de pagamento da empresa e pelo menos dois administradores nomeados.
  • Crie um projeto ou espaço de trabalho separado para cada papel de agente e separe teste de produção, para que um erro no teste não consuma o orçamento de produção.
  • Emita uma chave por agente e por ambiente, limitada aos modelos e recursos de que aquele papel precisa. O princípio do menor privilégio, descrito nas orientações de autorização da OWASP, vale para chaves tanto quanto para pessoas.
  • Guarde as chaves em um gerenciador de segredos e deixe o ambiente de execução do agente lê-las de lá. Chaves nunca devem aparecer em prompts, documentos compartilhados, conversas de chat ou repositórios de código, e ninguém deve copiá-las de um lugar para outro.
  • Defina limites de gasto e alertas de uso para cada projeto, e nomeie quem recebe os alertas e o que se espera que essa pessoa faça.
  • Registre o uso de cada agente com telemetria consistente, como número de requisições, volume e erros. As convenções do OpenTelemetry para IA generativa oferecem um vocabulário útil e permitem conciliar a fatura com os papéis de agente.
  • Agende a rotação das chaves e uma revisão de acessos, e rotacione imediatamente quando uma pessoa ou um parceiro com acesso sair.
  • Escreva os passos de saída: quem revoga o quê, em que ordem e como o agente é pausado com segurança enquanto as novas chaves são emitidas.

O cuidado com as chaves é um caso de uma regra mais ampla: o agente deve ter identidade e contas próprias em vez de usar as de uma pessoa, o que o artigo por que o agente de IA da empresa precisa de identidade e contas próprias explica. Escreva os passos de saída enquanto a relação ainda vai bem. O guia de plano de saída de fornecedor de IA lista o que manter, exportar e documentar. Se a sua organização segue uma estrutura de gestão de riscos, como o NIST AI Risk Management Framework, esse inventário de contas, responsáveis e passos de revogação também serve como evidência de governança.

Como a Be Human trata contas de modelo e chaves?

A recomendação padrão da Be Human é que a conta do modelo fique no nome da empresa cliente, com a cobrança e os termos de dados sob responsabilidade dela. Na configuração, cada papel de agente recebe chaves próprias de escopo limitado por ambiente, guardadas em um gerenciador de segredos e nunca em prompts ou documentos, com limites de gasto e monitoramento de uso combinados de antemão. A operação gerenciada inclui a revisão de permissões, que cobre quem pode usar ou rotacionar cada chave, e a documentação de transferência registra cada conta, cada responsável por chave e cada passo de revogação, para que a empresa possa trocar de parceiro ou de modelo sem reconstruir tudo. Se a empresa preferir outro arranjo, as regras de propriedade, relatórios e transferência são acordadas por escrito antes da emissão de qualquer chave.

Perguntas frequentes

Um funcionário pode abrir a conta com e-mail e cartão pessoais para começar logo? Funciona no primeiro dia e causa problemas depois, porque a conta, as faturas e os direitos de administração pertencem a uma só pessoa. Abra a conta com um endereço corporativo baseado em função, uma forma de pagamento da empresa e dois administradores, para que nenhuma saída isolada tranque o acesso ou deixe você pagando por meio de reembolso de despesa de alguém.

Uma conta da empresa custa mais do que uma conta do parceiro? Não por padrão. Uma conta da empresa tira uma camada intermediária da fatura e deixa você ver o uso real, mas o total depende do uso, da escolha de modelo, do suporte e da operação. Peça uma projeção de uso por papel de agente e compare o custo total de operar o agente, não apenas a linha do modelo.

E se usarmos mais de um provedor de modelo? Mantenha cada conta no nome da empresa e aplique a mesma disciplina a todas: chaves de escopo limitado, limites de gasto, administradores nomeados e passos de saída por escrito. O agente pode então distribuir o trabalho entre modelos sem que nenhum provedor vire uma dependência escondida, e um único processo de revisão cobre todas as contas.

Com que frequência as chaves devem ser rotacionadas? Siga o cronograma definido pelo responsável de segurança e rotacione imediatamente quando alguém com acesso sair, quando uma chave aparecer onde não deveria ou quando o contrato com um parceiro terminar. Chaves de escopo limitado por agente e por ambiente fazem da rotação uma tarefa pequena e rotineira, em vez de uma emergência que afeta tudo de uma vez.

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.

Teste um agente de IA personalizado 7 dias grátis pelo WhatsApp ↗