Suporte

Solução de problemas

Falhas frequentes — chaves, conectores, CSP do widget, recuperação vazia — e como isolar a causa antes de contatar suporte.

solução de problemaserrosdebug

A maioria dos incidentes gira em torno de credenciais, escopo e conteúdo desatualizado. Esta página oferece uma ordem de triagem rápida; anexe logs e timestamps ao abrir tickets.

Reproduza no chat de teste do painel para saber se o problema é específico de canal ou afeta todo o agente.

Erros de chaves API e de modelo

401/403 costumam indicar chave incorreta, organização incorreta ou credencial BYOK expirada. Verifique se o ambiente (prod vs staging) coincide com a chave configurada.

Após rotacionar, reinicie ou refresque serviços dependentes que cacheiam headers.

Respostas pobres ou vazias

Confirme que o agente usa a base de conhecimento esperada. Reexecute jobs de sync ou crawl se o conteúdo mudou recentemente.

Verifique se instruções são muito restritivas — o modelo pode recusar mesmo quando a recuperação acerta.

Widget não carrega

Revise CSP, ad blockers e posicionamento do script. Procure erros de console que mencionem hosts connect-src bloqueados.

Confirme que a chave de embed coincide com o agente e listas de domínio permitidos, se habilitadas.

Erros de cota em upload ou crawl (402 / “limite atingido”)

Se uploads de conhecimento falharem com erro estilo cota ou pagamento após muitas imagens ou arquivos de mídia, você pode ter esgotado limites mensais hospedados de reconhecimento de imagem Gemini ou transcrição de mídia.

Mitigações: adicione chave API Google Gemini em Configurações → Chaves API de LLM para que essas operações usem seu projeto Google, peça a um administrador para aumentar limites do plano, ou envie temporariamente formatos com texto nativo e desative processamento de mídia em crawls.

  • Crawls que ativam imagem ou mídia exigem configuração Gemini resolvível (hospedada ou org); se não, a API rejeita início do crawl com mensagem de Gemini ausente.
  • Texto só OCR a partir de imagens pode ainda aparecer quando visão é omitida; não assuma que o arquivo falhou por completo — revise o corpo armazenado do documento.

Construa com seu stack

Pronto para implantar assistentes fundamentados?

Inicie um teste ou fale conosco sobre implantação, governança e requisitos empresariais.