​
Versões compatíveis

Versão 2022.3 ou superior.
  • JetBrains Fleet ou ReSharper não são compatíveis
  • Remote SSH não é compatível.

​
Coletando logs da extensão

A partir da versão 1.10.0 da extensão, o Painel do Chat inclui um botão Diagnóstico da Extensão na página de Configurações. Esse botão coleta automaticamente os logs e parâmetros relevantes em um arquivo de texto que pode ser baixado. Para versões anteriores da extensão:
  1. Os logs são gravados no arquivo idea.log. Para localizar esse arquivo, vá até a opção de menu Help > Show Log in Finder/Explorer
  2. Exporte ou copie os logs

​
Como redefinir ou alterar a URL do Enterprise

  1. Vá em Tools → Codeium Enterprise → Reset Codeium Enterprise Updater.
  2. Insira a nova URL, garantindo que não haja espaços em branco no início ou no fim.
  3. Reinicie seu IDE.
  4. Após reiniciar, você será solicitado a entrar na sua conta.

​
Problemas conhecidos do IDE e soluções

​
O Cascade não funciona (ou o plugin do Windsurf não funciona de jeito nenhum)

Se o plugin do Windsurf para JetBrains não estiver funcionando, um bom primeiro passo é tentar redefini-lo acessando Help > Find Action > Reset Windsurf Enterprise Updater. Se o problema estiver limitado a alguns usuários, é provável que o certificado da Enterprise Domain URL não esteja carregado no seu IDE. O administrador da sua equipe deve saber como fazer isso.

​
Cascade não está sendo exibido

Geralmente, você verá o seguinte erro nos logs: 
JCEF não é compatível com este ambiente ou falhou na inicialização
ou 
JCEF interno não é compatível, tentando JCEF externo
JCEF é o navegador necessário para exibir o Cascade. Para corrigir isso, vá em Help > Find Actions > Choose Java Boot Runtime e escolha um runtime com JCEF incluído. Se você já tem o JCEF incluído como parte do seu runtime, ele pode estar desativado no seu registro/propriedades. Edite suas propriedades: Help > Edit Custom Properties, adicione a seguinte flag e reinicie seu IDE: 
ide.browser.jcef.enabled=true

​
Problemas com certificados

Se você encontrar os seguintes erros: 
Falha ao obter URL base da extensão em <YourDomainURL>

Falha na construção do caminho PKIX: sun.security.provider.certpath.SunCertPathBuilderException: 
não foi possível encontrar um caminho de certificação válido para o destino solicitado
Isso indica que a extensão Codeium não consegue confiar na conexão TLS com seu portal corporativo/servidor de API porque não confia no certificado apresentado. Isso pode significar que o certificado apresentado pela implantação do Codeium não é confiável ou que o certificado apresentado por um proxy corporativo que intercepta a solicitação não é confiável. Em ambos os casos, a solução mais recomendada é garantir que o certificado raiz que assinou esse certificado esteja corretamente instalado nas máquinas dos usuários finais, no local apropriado. IDEs da JetBrains e a maioria dos outros IDEs carregam certificados do local padrão do sistema operacional. Seu certificado é emitido e gerenciado pela sua equipe local de TI ou de Administração. Entre em contato com eles para obter ajuda com a instalação dos certificados necessários no seu sistema. É importante que toda a cadeia de certificados seja apresentada no ponto onde o TLS é encerrado. Muitas vezes, se apenas o certificado folha é apresentado, IDEs da JetBrains e outros IDEs não conseguem verificar sua autenticidade porque não conhecem o certificado intermediário, que valida o certificado folha e é validado pelo certificado raiz. Os navegadores geralmente conseguem contornar esse problema, pois os usuários provavelmente já acessaram um site diferente que apresenta a cadeia completa de certificados, de modo que o certificado intermediário é visto e armazenado em cache; porém, aplicativos como os IDEs da JetBrains não têm essa vantagem. Nota: Nos produtos da família JetBrains 2024.3, foi introduzido um bug em que o IDE não aceita os certificados do sistema operacional (relatório de problema da JetBrains). Para resolver isso, os usuários podem fazer qualquer uma das seguintes ações:
  • Fazer downgrade dos produtos da JetBrains para versões anteriores
  • Usar a versão 2024.3.1 de prévia (beta)
  • Adicionar -Djavax.net.ssl.trustStoreType=Windows-ROOT como uma opção personalizada da JVM

​
Workspaces personalizados

Se você encontrar o seguinte erro ao usar o Cascade: 
Cascade não pode acessar caminhos sem um workspace ativo
Isso indica que o Cascade precisa de acesso a um workspace personalizado para funcionar corretamente. Para resolver:
  1. Abra as configurações do seu IDE JetBrains indo em File > Settings (ou IntelliJ IDEA > Preferences no macOS)
  2. Vá até Tools > Windsurf Settings
  3. No painel Windsurf Settings, localize a seção “Custom Workspaces” na parte inferior
  4. Clique no botão “Add Workspace” para adicionar o workspace do seu projeto
  5. Selecione o diretório de workspace apropriado para o seu projeto
  6. Clique em “OK” para aplicar as configurações
  7. Reinicie seu IDE para que as alterações entrem em vigor

​
Comportamento em Enterprise vs. Não‑Enterprise

O comportamento de workspaces personalizados varia conforme o seu tipo de usuário:

​
Usuários Enterprise

Usuários Enterprise têm controle seletivo sobre a indexação de workspaces:
  • Ao adicionar workspaces, você verá uma caixa de seleção para habilitar a indexação de cada workspace
  • Apenas os workspaces com a caixa de seleção ativada serão indexados e disponibilizados ao Cascade
  • Isso permite controlar quais workspaces consomem recursos de indexação
  • As chamadas de ferramentas são restritas ao workspace ativo por segurança

​
Usuários Non-Enterprise

Usuários Non-Enterprise contam com indexação automática de workspace:
  • Qualquer workspace que você adicionar será indexado automaticamente, sem necessidade de marcar uma caixa de seleção
  • Todos os workspaces adicionados ficam imediatamente disponíveis para o Cascade
  • As chamadas de ferramentas nunca são bloqueadas fora do workspace ativo
  • O recurso de indexação seletiva não se aplica nesse modelo
Após concluir as etapas de configuração acima, o Cascade deverá conseguir acessar seu workspace e funcionar normalmente.