Chaves API de LLM (traga sua própria chave)

Traga sua própria chave (BYOK) significa que o FlexyAgents chama provedores de modelo com credenciais que você guarda no painel (Configurações → Chaves API de LLM; a rota pode incluir prefixo de locale como /en/). Uso dessas chamadas é faturado no seu provedor sob seu acordo; planos hospedados podem continuar aplicando cotas do lado FlexyAgents onde a plataforma fornece o modelo.

Uma chave Google Gemini é especialmente importante se você usa descrição de imagem (visão) ou transcrição de áudio/vídeo em uploads ou crawls web: com chave Gemini de organização ativa, essas funções usam sua chave e não consomem cotas hospedadas de “reconhecimento de imagem” ou “transcrição de mídia” no seu plano FlexyAgents.

Onde adicionar chaves

Vá a Painel → Configurações → Chaves API de LLM (labels exatos podem variar levemente por locale). Adicione uma chave por provedor que precisar. Chaves são armazenadas criptografadas; apenas membros autorizados da org podem vê-las ou substituí-las.

Após salvar, aguarde um minuto para a config propagar antes de retestar agentes que falhavam por chave ausente.

Provedores suportados incluem os principais de modelos de chat (OpenAI-compatible onde aplicável, Anthropic, Google Gemini e outros listados na UI).
Se seu plano é somente BYOK para um provedor, o chat não fará fallback para chaves hospedadas do FlexyAgents — você deve fornecer uma chave válida.

Gemini e ingestão de conhecimento

Uploads e crawls de imagens podem executar OCR (extração de texto a partir de pixels) sem Gemini. Visão Gemini opcional gera descrições mais ricas em linguagem natural para busca e respostas — isso é o que limites do plano chamam de “reconhecimento de imagem” quando faturado em infraestrutura hospedada.

Da mesma forma, arquivos de áudio e vídeo podem ser transcritos com Gemini se habilitado; planos hospedados podem contar transcrições bem-sucedidas para limites mensais de “transcrição de mídia”, salvo se sua org fornecer chave Gemini.

A UI de upload mostra uso mensal hospedado de reconhecimento de imagem e transcrição de mídia para que operadores saibam antes de bater nos limites.
Se vir erro de cota no upload, adicione chave Gemini ou peça a um admin para aumentar limites do plano; caminhos só OCR ainda podem produzir algum texto sem visão.

Rotação e resposta a incidentes

Trate chaves LLM como senhas de banco de dados: rotação em calendário, rotação imediata se houver vazamento, e documentação de quais equipes possuem quais contas de provedor.

Quando uma chave expira, agentes afetados retornam erros do provedor — revise logs do painel e teste chat com uma mensagem antes de dar o “all clear”.

Prefira chaves ou projetos separados por ambiente (staging vs produção) para que vazamento de staging não comprometa tetos de gasto de produção.
Use alertas e budgets no provedor; o FlexyAgents não substitui seus guardrails de billing na nuvem.

Conformidade e fluxo de dados

Seu DPA com cada provedor de modelo governa subprocessadores, regiões e retenção. O FlexyAgents passa prompts e contexto recuperado ao provedor que o agente seleciona.

Para residência de dados estrita, confirme opções de deploy do FlexyAgents e a região do provedor para a chave que configurar.

Chaves API de LLM (traga sua própria chave)

Onde adicionar chaves

Gemini e ingestão de conhecimento

Rotação e resposta a incidentes

Conformidade e fluxo de dados

Pronto para implantar assistentes fundamentados?