Esta é uma tradução automática do documento original em inglês. Em caso de conflito entre esta tradução e a versão original em inglês, a versão em inglês prevalecerá. Ler a versão original em inglês

Solução de problemas

Algo não está funcionando? Comece por aqui.

Problemas com a Extensão do Navegador

A extensão não carrega

  1. Certifique-se de que a instalou pela Chrome Web Store (não uma versão de desenvolvimento)
  2. Vá para chrome://extensions e procure por mensagens de erro
  3. Tente desativar a extensão e ativá-la novamente
  4. Reinicie o Chrome completamente se isso não funcionar

O painel lateral não abre

  1. Clique no ícone do Caiioo na sua barra de ferramentas (canto superior direito)
  2. Certifique-se de que está em uma página da web comum (algumas páginas como as configurações do Chrome não permitem extensões)
  3. Vá para chrome://extensions, encontre o Caiioo e clique em "Recarregar"
  4. Tente clicar no ícone novamente

Barra lateral em branco ou quebrada após uma atualização

  • Limpe o cache do navegador e recarregue a extensão
  • Feche e reabra o painel lateral
  • Se nada ajudar, desative e reative a extensão

Problemas de Login

Não consigo entrar com Google / Apple / Microsoft

  1. Certifique-se de que seu navegador não está bloqueando pop-ups — o OAuth requer uma janela pop-up
  2. No iOS, se o login do Google travar, tente a opção "Entrar com a Apple"
  3. Limpe os cookies de caiioo.ai e tente novamente
  4. Se você alterou senhas recentemente, saia do provedor no seu navegador primeiro e tente de novo

Travado na tela de login após entrar

  • Aguarde alguns segundos — o app está buscando seu perfil
  • Se continuar travado, feche e abra o app (ou recarregue a extensão)
  • Certifique-se de que o relógio do dispositivo está correto — a validação do token OAuth falha se o relógio estiver errado

Problemas com Chave de API

A chave de API não está funcionando

  1. Copie a chave novamente do site do provedor e cole com atenção (sem espaços antes ou depois)
  2. Verifique se sua conta ainda tem créditos disponíveis
  3. Tente gerar uma nova chave e usá-la em vez da anterior
  4. Verifique se o formato da chave está correto — chaves do OpenRouter começam com sk-or-

Não consigo encontrar minha chave de API

  • OpenRouter: openrouter.ai/keys
  • Ollama: não precisa de chave — confirme apenas se o servidor local está em execução em http://localhost:11434

Consulte Provedores de IA e Chaves de API para mais detalhes.

Mensagem de "Limite de taxa atingido" ou "sobrecarregado" no modelo escolhido

Isso ocorre no lado do provedor, não na sua chave. Quando um modelo escolhido por você atinge o limite de taxa, fica sobrecarregado ou indisponível, o Caiioo indica o nome do modelo e explica o ocorrido em vez de mudar silenciosamente para outro. Aguarde um minuto e envie novamente, ou escolha outro modelo manualmente. (Quando o Caiioo seleciona o modelo automaticamente, ele faz a troca por conta própria — essa é a diferença.)

Um modelo gratuito recusa minhas solicitações com frequência

Certos modelos gratuitos do OpenRouter rejeitam solicitações vindas de aplicativos que não constam em sua própria lista de permissões. O Caiioo memoriza os modelos que recusaram, sinaliza-os no seletor e os ignora em tentativas de contingência — verificando novamente mais tarde para o caso de o bloqueio ter sido suspenso. Enquanto isso, selecione outro modelo.

Integração com o Google (Nível Pro)

Não é possível ligar ao Google

  1. Aceda a Definições > Conta > Autorizações de Conta e Permissões
  2. Clique em "Ligar Conta Google"
  3. Certifique-se de que aprova todas as permissões solicitadas
  4. Verifique se a sua conta aparece como ligada
  5. Se continuar a não funcionar, desligue e tente novamente

As ferramentas do Google não estão a funcionar

  1. Verifique se o Google está ligado (Definições > Conta > Autorizações de Conta e Permissões)
  2. Tente atualizar a sua ligação ao Google (botão "Reconectar Google")
  3. Certifique-se de que a ferramenta específica está ativada (Definições > Ferramentas, Modos e Aplicações > Configuração de Ferramentas)

Problemas com a Sincronização Privada

A sincronização não está funcionando

  1. Verifique se a sincronização privada está de fato ativada (Configurações > Conectividade > Sincronização Privada)
  2. Verifique se sua conta Google está conectada
  3. Certifique-se de que há espaço de armazenamento livre no seu Google Drive
  4. Clique em "Reconectar Google" se o token tiver expirado
  5. Tente desativar e reativar a sincronização

Os dados não sincronizaram entre dispositivos

  • A sincronização privada funciona em segundo plano — aguarde alguns segundos
  • Confira se você está usando a mesma conta Google em todos os aparelhos
  • Certifique-se de que a sincronização privada também está ativada no outro dispositivo
  • Atualize manualmente desativando e reativando a sincronização

Problemas de Acesso Remoto ao Browser

A página relay.caiioo.ai/app não liga

  • No seu dispositivo principal, certifique-se de que o Reencaminhamento Privado está ligado (Definições > Conetividade > Ligações) e indica "Ligado"
  • Inicie sessão no browser remoto com a mesma conta do seu dispositivo principal — o reencaminhamento apenas acede à sua própria instância
  • A extensão ou a aplicação de ambiente de trabalho do seu dispositivo principal precisam de estar a correr e online para que o browser remoto a possa controlar
  • Numa abertura a frio, a página pode apresentar um indicador de progresso de "a ligar" durante alguns segundos enquanto estabelece a sessão encriptada — deixe terminar antes de recarregar

Sessão iniciada mas a página remota fica bloqueada no ecrã de início de sessão

  • Aguarde alguns segundos — a aplicação só é iniciada após a sessão encriptada estar estabelecida
  • Se continuar bloqueada, confirme que o seu dispositivo principal está online e o Reencaminhamento Privado está ligado, depois recarregue a página

Problemas de desempenho

As respostas estão lentas

  1. Verifique se o provedor de IA está com problemas (verifique a página de status deles)
  2. Tente usar um modelo mais rápido e barato (como Gemini Flash ou Mistral)
  3. Arquive conversas antigas se você tiver centenas delas
  4. Verifique sua conexão com a internet

As conversas estão demorando muito

  • A IA está trabalhando—procure pelo indicador de carregamento
  • Alguns modelos são mais lentos que outros. Mude para um mais rápido se estiver com pressa
  • Se estiver demorando mais que alguns minutos, a IA pode estar travada. Clique em Parar e tente novamente

Subscrição e Faturação

Não consegue ver "Gerir Plano"

  • Certifique-se de que tem sessão iniciada com a conta associada à subscrição
  • Se subscreveu no iOS, o botão Gerir Plano reencaminha para as definições de subscrição da Apple
  • Se subscreveu na web, reencaminha para o portal de faturação do Stripe
  • Termine sessão e inicie-a novamente para atualizar o estado da sua subscrição

"Gerir Plano" abre o sítio errado

  • As compras dentro da aplicação no iOS são geridas em Definições > ID Apple > Subscrições — e não em caiioo.ai/account
  • As subscrições do Stripe são geridas através da ligação do portal em Definições > Conta > Perfil de Utilizador ou em caiioo.ai/account
  • O Caiioo reencaminha automaticamente com base no local onde efetuou a subscrição — isto é o comportamento esperado

Atualizou mas continua no nível antigo

  • As atualizações do Stripe demoram um minuto a propagar-se — recarregue a aplicação
  • As compras in-app da Apple podem demorar até 24 horas a verificar. Toque em "Restaurar Compras" em Definições > Conta > Perfil de Utilizador para acelerar o processo
  • Se já tiver uma subscrição noutra plataforma, o botão Subscritor indicará para a gerir lá em vez disso

Outros problemas

Ecrã em branco na aplicação de ambiente de trabalho ou móvel

  • Reinicie a aplicação completamente
  • Verifique se está ligado à internet
  • Tente limpar a cache da aplicação (varia consoante a plataforma)
  • Atualize para a versão mais recente

As ferramentas não estão a funcionar

  1. Aceda a Definições > Ferramentas, Modos e Aplicações > Configuração de Ferramentas e verifique se a ferramenta está ativada
  2. Algumas ferramentas requerem permissões ou configuração (como uma conta Google ligada para as ferramentas do Google)
  3. Se vir um erro de "necessita de permissão", volte a ligar o fornecedor em Definições > Conta > Autorizações de Conta e Permissões e aprove novamente os âmbitos

A extensão não consegue ligar à aplicação de ambiente de trabalho

  • Primeiro, verifique se Ativar Ponte Caiioo está ligado (Definições > Conetividade > Ligações) — está desligado por predefinição, e enquanto estiver desligado a extensão nunca se liga à aplicação de ambiente de trabalho e os controlos de reconexão/porta aparecem a cinzento
  • Se estiver a utilizar tanto a extensão do browser como a aplicação de ambiente de trabalho, a extensão liga-se à aplicação de ambiente de trabalho através de um WebSocket local (ponte de capacidades, não sincronização de estado)
  • Reinicie a aplicação de ambiente de trabalho e recarregue a extensão
  • Certifique-se de que não está a correr nenhuma outra cópia da aplicação de ambiente de trabalho — instâncias múltiplas entram em conflito

Aviso de "Browser não ligado" no macOS mesmo com um browser aberto

  • O Caiioo reconhece agora Chrome, Safari, Edge e Firefox — o aviso desaparece assim que qualquer um deles se liga
  • O Safari liga-se através de um canal diferente e pode ficar brevemente inativo quando não é a aplicação em primeiro plano; mantém-se ligado e o Caiioo acorda-o automaticamente quando um comando o necessita
  • Se o aviso persistir, traga o seu browser para primeiro plano uma vez e tente novamente

Os anexos de mensagens não são carregados

  • Verifique se o formato do ficheiro é suportado (PDF, imagens, documentos Word, folhas de cálculo, apresentações)
  • Tente um ficheiro mais pequeno
  • Certifique-se de que tem ligação à internet

Obter ajuda

  • Respostas rápidas: Clique no ícone ? no cabeçalho
  • Definições e resolução de problemas: Clique no ícone de engrenagem
  • Este guia: Definições > Ajuda > Documentação e Legal
  • Deixe o Caiioo criar um relatório de erro por si: Peça-lhe para relatar um problema e ele abre o formulário de suporte integrado pré-preenchido com uma descrição detalhada para rever e enviar. Diga "apenas envia" e — com a sua aprovação — o ticket é submetido diretamente, anexando os detalhes técnicos da conversa para que a equipa possa reproduzir o que viu.

Veja também

This guide is maintained by the Caiioo team using Slate, our built-in editor.