Instalación de la extensión para Visual Studio Code

watsonx Code Assistant

Crea una clave API y añade la extensión ' watsonx Code Assistant ' a tu editor Microsoft ' Visual Studio Code.

Compatibilidad

La extensión es compatible con Visual Studio Code 1.101 y posteriores, utilizando Node.js versión 22.15 o posterior.

Para verificar su versión de Node.js en Visual Studio Code, haga clic en el menú Código y seleccione Acerca de Visual Studio Code. Asegúrese de que Node.js es la versión 22.15 o posterior.

No es posible instalar la extensión en un contenedor de desarrollo.

Sistemas operativos:

  • macOS
  • Windows 11
  • Fedora Linux 41
  • Red Hat Enterprise Linux 8
  • Ubuntu 20.04

Crear una clave API en IBM Cloud

En lugar de un nombre de usuario y una contraseña, cada desarrollador utiliza una clave de API personal para iniciar sesión.

Para crear una clave API:

  1. Inicie sesión en IBM Cloud Claves API.

    Asegúrese de que está utilizando la cuenta IBM Cloud donde se aprovisiona la instancia de watsonx Code Assistant de su organización.

  2. Pulse Crear.

  3. Introduzca " IBM watsonx Code Assistant API key " como nombre de su clave API. Puede especificar una descripción opcional.

  4. Pulse Crear.

  5. Haga clic en Descargar o Copiar y guarde la clave API en un lugar seguro.

    La llave sólo está disponible durante 296 segundos. Guárdalo en un lugar donde puedas encontrarlo más tarde.

Instalar la extensión

Elija la instalación para el plan que esté utilizando.

Descripciones de plan
Plan Descripción Nombre de extensión Idiomas de visualización
Plan de prueba Prueba limitada sin coste con chat de IA generativa integrado para código. watsonx Code Assistant Inglés (en), japonés (ja), coreano (ko)
Plan Essentials IA generativa integrada para sugerencias de código, explicaciones de código, documentación de código y pruebas unitarias. watsonx Code Assistant Inglés (en), japonés (ja), coreano (ko)
Plan Estándar Todas las características del plan Essentials, más las funciones de modernización de la empresa Java, explicación mejorada del código, generación mejorada de pruebas unitarias y generación aumentada de recuperación (RAG).

Para la instalación del plan Estándar, aparecen dos entradas en su panel Visual Studio Code Extensions, una para watsonx Code Assistant y otra para watsonx Code Assistant for Enterprise Java Applications. Las dos extensiones son dependencias de esta instalación. Se requiere la versión 1.6.2 o posterior de watsonx Code Assistant y la versión 1.1.0 o posterior de watsonx Code Assistant for Enterprise Java Applications.		 watsonx Code Assistant for Enterprise Java Applications Sólo en inglés (en)

Para conocer todos los detalles del plan, consulte:

Desde Visual Studio Marketplace

Para instalar desde Visual Studio Marketplace:

  1. Elija la instalación para el plan que esté utilizando.

  2. Haga clic en Instalar en la página Marketplace.

  3. En Visual Studio Code, haga clic en Instalar en la extensión.

Desde el editor de Visual Studio Code

Para instalar desde el editor de Visual Studio Code:

  1. En el editor de Visual Studio Code, haga clic en el icono Extensiones.

  2. Elija la instalación para el plan que esté utilizando:

    • '[Plan de prueba] '{: tag-magenta} ' [Plan Esencial] '{: tag-green} Para instalar los planes Trial y Essentials, busque ' watsonx Code Assistant.
    • Plan estándar Para instalar el plan estándar, busque watsonx Code Assistant for Enterprise Java Applications.

  3. Seleccione la extensión que necesite y haga clic en Instalar.

Abrir la extensión

Para abrir watsonx Code Assistant:

  1. Haga clic en el watsonx Code Assistant watsonx Code Assistant icono.

  2. Haga clic en Iniciar sesión con su clave API e introduzca su clave API en IBM watsonx Code Assistant.

    Si su cuenta está asociada a más de un centro de datos IBM Cloud, elija también la ubicación.

Configure su entorno Java empresarial

Plan estándar Si utiliza el plan estándar y desea trabajar con aplicaciones Java empresariales, debe configurar su entorno. Para obtener más información, consulte Configuración del entorno Java empresarial.

Actualizar la configuración del proxy HTTP

Si su organización utiliza un servidor proxy de HTTP, debe actualizar su configuración de Visual Studio Code para que pueda conectarse correctamente. Es posible que reciba errores de consola cuando intente conectarse y falte esta configuración.

  1. Abra la configuración de http.proxy en los ajustes de Visual Studio Code.
  2. Introduzca el URL de su servidor proxy HTTP en el formato https://proxy_server:port. Es posible que tenga que incluir información de autenticación, como http://user:pass@proxy_server:port.

Configuración de la verificación de certificados personalizados

Si su servidor proxy utiliza certificados personalizados, deberá configurar la verificación para Visual Studio Code. Siga estos pasos:

Para exportar el certificado SSL de su servidor:

  1. Utilice Google Chrome para abrir su instancia watsonx Code Assistant en IBM Cloud.

  2. Haga clic en el icono Ver información del sitio situado junto a la dirección web en el navegador.

  3. Haga clic en La conexión es segura y, a continuación, en El certificado es válido para abrir el Visor de certificados.

  4. Haga clic en Detalles, seleccione el certificado del proxy y, a continuación, haga clic en Exportar.

Para configurar para MacOS:

  1. Utiliza Spotlight para buscar y abrir Keychain Access.

  2. Haga clic en Sistema y, a continuación, en la pestaña Certificados.

  3. Arrastre el archivo de certificado a la pestaña Certificados.

  4. Haga clic con el botón derecho en el certificado y, a continuación, en Obtener información.

  5. En la sección Confianza, establezca Al utilizar este certificado en Always Trust.

  6. Reinicie la extensión para aplicar los cambios. Debería poder iniciar sesión utilizando su clave API.

Para configurar para Windows:

  1. Abra Microsoft Management Console.

  2. Abra Certificados (equipo local) > Autoridades de certificación raíz de confianza > Certificados.

  3. Haga clic con el botón derecho del ratón en Certificados, seleccione Todas las tareas y, a continuación, Importar.

  4. Haga clic en Detalles, seleccione el certificado del proxy y, a continuación, haga clic en Exportar.

  5. Reinicie Visual Studio Code y la extensión watsonx Code Assistant para aplicar los cambios. Debería poder iniciar sesión utilizando su clave API.

Asegure su instalación

IBM watsonx Code Assistant no proporciona controles de seguridad adicionales. Siga estos pasos para asegurar correctamente su instalación.

Su entorno Visual Studio Code

Aplique todas las actualizaciones de Visual Studio Code, para asegurarse de que dispone de la última seguridad y correcciones de errores. Para más información, consulte la documentación de Microsoft.

Los registros de extensión watsonx Code Assistant se almacenan en archivos *.log bajo ' <your home directory>/.wca. Estos archivos no están encriptados, aparte de la encriptación que proporciona tu sistema de archivos. Proteja los registros contra el acceso indebido.

Almacenamiento de conversaciones de chat

IBM watsonx Code Assistant almacena todo el historial de conversaciones de chat localmente en su sistema de archivos en <your home directory>/.wca/chat.db, en un formato de base de datos definido por SQLite. IBM watsonx Code Assistant no comparte estas conversaciones con nadie. Este archivo no está encriptado, aparte de la encriptación que proporciona tu sistema de archivos. Proteja este archivo contra el acceso indebido.

Datos de telemetría

IBM watsonx Code Assistant no recoge datos de telemetría. En general, watsonx Code Assistant no envía ningún dato que procese a terceros, IBM incluido.

Cierre de sesión de su clave API

Si es necesario, puede desconectarse de su clave API. Cerrar sesión y volver a introducir su clave API podría ayudarle con cualquier problema de autenticación que encuentre.

Para cerrar la sesión:

  1. En Visual Studio Code, haga clic en el icono Cuentas.

  2. Haga clic en la opción Su nombre (Clave API WCA) y, a continuación, en Cerrar sesión.

Uso de la vista de salida para ver los detalles de la actividad

Puede utilizar la vista Salida de Visual Studio Code para ver detalles sobre lo que la extensión está haciendo y registrando, y comprobar si hay algún error.

Para abrir la vista Salida:

  1. En Visual Studio Code, haga clic en Ver y, a continuación, en Salida.

  2. En la vista Salida, utilice la lista desplegable para seleccionar WCA o WCA Language Server. Ambos proporcionan más detalles sobre lo que hace la extensión.

Para ajustar la vista de salida y el registro para la extensión Visual Studio Code:

  1. En Visual Studio Code, abra la configuración de extensión para watsonx Code Assistant.

  2. En Wca: Log level, cambie el valor predeterminado de INFO por otro como WARN.

Desactivar o desinstalar la extensión

Si es necesario, puede desactivar la extensión y mantenerla instalada, o puede desinstalarla por completo.

Para desactivar o desinstalar la extensión:

  1. En Visual Studio Code, haga clic en el icono Extensiones para abrir el panel.

  2. Haga clic en la extensión watsonx Code Assistant.

  3. Haga clic en Desactivar o Desinstalar.

Cambiar el idioma de la pantalla

La extensión watsonx Code Assistant está disponible en inglés (en), japonés (ja) y coreano (ko).

La extensión watsonx Code Assistant for Enterprise Java Applications sólo está disponible en inglés (en).

Para cambiar el idioma de la pantalla:

  1. En Visual Studio Code, haga clic en Ver y, a continuación, en Paleta de comandos.

  2. Busque display y haga clic en Configurar idioma de visualización.

  3. Elija entre inglés (en), japonés (ja) o coreano (ko).

Para más información, consulte Lenguaje de visualización en la documentación de Visual Studio Code.