## Visão geral

Cada conta pode usar as **próprias chaves** de provedores de IA (OpenAI, Anthropic, Google, Groq,
xAI, DeepSeek, OpenRouter, Cohere, ElevenLabs) — o chamado **BYOK** (bring your own key). Quando a
conta não informa chaves, valem as chaves globais definidas pelo operador.

A **Tavily** aparece na mesma tela, mas entra por outro motivo: ela **não é provedora de chat**.
Nenhum modelo roda nessa chave e ela nunca aparece na cadeia de modelos do Robô — é ela que libera
as ferramentas de **busca na web** e de **leitura de página**. Sem ela, essas duas ferramentas ficam
indisponíveis; todo o resto da IA continua funcionando normalmente.

## Pré-requisitos

- Governança de BYOK habilitada pelo operador (chave da instalação) e o recurso ativo na conta.
- Perfil de administrador da conta para cadastrar chaves.

## Passo a passo

1. Na conta: Configurações → Integrações → abra o provedor desejado.
2. Use **Obter credenciais do _provedor_** para criar a chave e **Ver documentação de configuração
   do _provedor_** para conferir o guia oficial; os dois atalhos ficam acima do formulário.
3. Informe a chave. Ela passa a ser usada pelos recursos de IA daquela conta (Cérebro, copiloto,
   robôs, ditado).
4. Para voltar às chaves globais, desative a integração do provedor.

## Configurações & opções

- **Governança pelo operador**: o operador pode desligar o BYOK da instalação inteira ou de uma
  conta específica. Com o BYOK desligado:
  - as chaves da conta **permanecem guardadas**, mas deixam de ser usadas;
  - novas gravações de chave são recusadas;
  - todos os recursos de IA passam a usar as chaves globais.
- **Precedência**: chave da conta (BYOK ativo) → chave global da instalação.

## Casos de uso

- Cliente enterprise que exige faturamento próprio junto ao provedor de IA.
- Operador que prefere centralizar o consumo de IA nas chaves globais para revenda por pacote.

## Dicas, limites e boas práticas

- Nunca compartilhe chaves entre contas de clientes diferentes.
- Prefira chaves com limite de gasto configurado no provedor.
- Rotacione chaves comprometidas imediatamente — a troca vale na próxima requisição.

## Solução de problemas

- **"Não consigo salvar a chave"**: o BYOK está desligado pelo operador para esta conta ou para a
  instalação.
- **IA respondendo com erro de cota**: verifique o saldo/limite da chave em uso (da conta ou
  global) no painel do provedor.

## Veja também

- Maestro & IA: configuração e saúde da integração
- DeepSeek como provedor de modelo do Robô
- Busca na web: o Robô pesquisando na internet pública
- Uso e limites de consumo