Saltar al contenido principal

​
Versiones compatibles

Versión 2022.3 o superior.
  • JetBrains Fleet o ReSharper no son compatibles
  • Remote SSH no es compatible.

​
Recolección de logs de la extensión

A partir de la versión 1.10.0 de la extensión, el Panel de Chat incluye un botón de Diagnóstico de la extensión en la página de Configuración. Este botón recopila automáticamente los logs y parámetros relevantes en un archivo de texto que se puede descargar. Para versiones anteriores de la extensión:
  1. Los logs se escriben en el archivo idea.log. Para localizar este archivo, ve a la opción de menú Help > Show Log in Finder/Explorer.
  2. Exporta o copia los logs.

​
Problemas conocidos del IDE y sus soluciones

​
Cascade no se muestra

Por lo general, verás el siguiente error en los logs: 
JCEF no es compatible con este entorno o no se pudo inicializar
o 
JCEF interno no compatible, probando JCEF externo
JCEF es el componente de navegador necesario para mostrar Cascade. Para solucionarlo, ve a Help > Find Actions > Choose Java Boot Runtime y elige un runtime con JCEF incluido. Si ya tienes JCEF incluido como parte de tu runtime, es posible que JCEF esté deshabilitado en tu registro/propiedades. Edita tus propiedades: Help > Edit Custom Properties, agrega la siguiente marca y reinicia tu IDE: 
ide.browser.jcef.enabled=true

​
Problemas con certificados

Si te encuentras con los siguientes errores: 
No se pudo obtener la URL base de la extensión en <YourDomainURL>

PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: 
unable to find valid certification path to requested target
Esto sugiere que la extensión de Codeium no puede confiar en la conexión TLS a tu portal de empresa o servidor de API porque no confía en el certificado que se está presentando. Esto significa que o bien el certificado presentado por la implementación de Codeium no es de confianza, o bien el certificado presentado por un proxy corporativo que está interceptando la solicitud no es de confianza. En cualquier caso, la solución más recomendable es asegurarse de que el certificado raíz que firmó este certificado esté correctamente instalado en las máquinas de los usuarios finales en la ubicación adecuada. Los IDE de JetBrains y la mayoría de los demás IDE cargan certificados desde la ubicación predeterminada del sistema operativo. Tu certificado es emitido y gestionado por tu equipo local de TI o de administración. Ponte en contacto con ellos para obtener ayuda con la instalación de los certificados necesarios en tu sistema. Es importante que se presente la cadena completa de certificados desde el punto donde se termina TLS. A menudo, si solo se presenta el certificado hoja, el IDE de JetBrains y otros IDE no pueden verificar su autenticidad porque no conocen el certificado intermedio que valida el certificado hoja y que a su vez está validado por el certificado raíz. Los navegadores a menudo pueden sortear este problema, ya que es probable que los usuarios se hayan encontrado con otro sitio web que sí presenta la cadena completa de certificados, por lo que el certificado intermedio se ve y se almacena en caché, pero aplicaciones como los IDE de JetBrains no tienen esta ventaja. Nota: En los productos de la familia JetBrains 2024.3 se introdujo un error por el cual el IDE no acepta los certificados del sistema operativo (informe de problema de JetBrains). Para solucionarlo, los usuarios pueden hacer cualquiera de lo siguiente:
  • Volver a versiones anteriores de los productos de JetBrains
  • Usar la versión preliminar 2024.3.1 (versión beta)
  • Añadir -Djavax.net.ssl.trustStoreType=Windows-ROOT como opción personalizada de la JVM

​
Workspaces personalizados

Si aparece el siguiente error al usar Cascade: 
Cascade no puede acceder a las rutas sin un workspace activo
Esto indica que Cascade necesita acceso a un workspace personalizado para funcionar correctamente. Para solucionarlo:
  1. Abre la configuración de tu IDE JetBrains yendo a File > Settings (o IntelliJ IDEA > Preferences en macOS)
  2. Navega a Tools > Windsurf Settings
  3. En el panel de configuración de Windsurf, localiza la sección “Custom Workspaces” en la parte inferior
  4. Haz clic en el botón “Add Workspace” para añadir el workspace de tu proyecto
  5. Selecciona el directorio de workspace adecuado para tu proyecto
  6. Haz clic en “OK” para aplicar la configuración
  7. Reinicia tu IDE para que los cambios surtan efecto

​
Comportamiento en Enterprise vs No Enterprise

El comportamiento de los workspaces personalizados varía según tu tipo de usuario:

​
Usuarios de Enterprise

Los usuarios de Enterprise tienen control selectivo sobre la indexación del workspace:
  • Al agregar workspaces, verás una casilla para habilitar la indexación de cada workspace
  • Solo los workspaces con la casilla habilitada se indexarán y estarán disponibles para Cascade
  • Esto te permite controlar qué workspaces consumen recursos de indexación
  • Por seguridad, las llamadas a herramientas están restringidas al workspace activo

​
Usuarios no Enterprise

Los usuarios no Enterprise obtienen indexación automática del workspace:
  • Cualquier workspace que añadas se indexa automáticamente sin requerir marcar ninguna casilla
  • Todos los workspaces añadidos están disponibles de inmediato para Cascade
  • Las llamadas a herramientas nunca se bloquean fuera del workspace activo
  • La función de indexación selectiva no es relevante en este modelo
Después de completar los pasos de configuración anteriores, Cascade debería poder acceder a tu workspace y funcionar con normalidad.

​
Atajos de teclado que no funcionan en Rider en Windows

Si estás usando JetBrains Rider en Windows y experimentas problemas cuando Shift+Enter no inserta una nueva línea en Cascade o la tecla Delete no funciona, esto se debe a un conflicto de atajos de teclado con la ventana de la herramienta Unit Test Tool Window de Rider. Este es un problema conocido que afecta a los plugins de IA en Rider. Para resolverlo:
  1. Abre la configuración de tu IDE de JetBrains yendo a File > Settings
  2. Navega a Keymap
  3. Busca “Unit Test Tool Window Action”
  4. Desactiva o reasigna los atajos en conflicto (Shift+Enter y Delete)
  5. Reinicia tu IDE para que los cambios surtan efecto