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
- Na conta: Configurações → Integrações → abra o provedor desejado.
- 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.
- Informe a chave. Ela passa a ser usada pelos recursos de IA daquela conta (Cérebro, copiloto, robôs, ditado).
- 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