Escribe código con asistencia de Duet AI

En este documento, se describe cómo puedes usar Duet AI, un colaborador con tecnología de IA en Google Cloud, para ayudarte a realizar las siguientes acciones en Cloud Code:

  • Proporciona orientación para ayudarte a resolver problemas con tu código.

  • Genera un código para tu proyecto.

  • Recibe sugerencias intercaladas mientras codificas.

Duet AI no usa tus mensajes ni sus respuestas como datos para entrenar su modelo. Para obtener más información, consulta Cómo usar Duet AI en Google Cloud utiliza tus.

Para ayudarte a cumplir con los requisitos de licencia de tu código, Duet AI proporciona citas de la fuente cuando sus sugerencias citan directamente una fuente específica. Para obtener más información sobre cómo y cuándo Duet AI cita fuentes, consulta Cómo te ayuda Duet AI a generar código y cita fuentes.

Este documento está dirigido a desarrolladores de todos los niveles de habilidades. Se supone que tienes conocimientos prácticos de VS Code y que estás familiarizado con Google Cloud. Si lo prefieres, también puedes explorar Duet AI en Cloud Workstations, Cloud Code para IntelliJ y Cloud Shell Editor.

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  4. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  5. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  6. Asegúrate de que Duet AI esté configurado para tu cuenta de usuario y proyecto de Google Cloud.
  7. Instala la extensión de Cloud Code si aún no lo has hecho. Cloud Code se integra a Duet AI en tu IDE.
  8. Si decides clonar una muestra para las tareas de este documento, instala Git (opcional). Se requiere Git para copiar muestras en tu máquina.

Conéctate a Google Cloud

Si ya te conectaste a Google Cloud en el IDE, puedes omitir esta sección. De lo contrario, sigue estos pasos:

  1. Inicia tu IDE.

  2. En la barra de estado, haz clic en Cloud Code - Sign In.

    Cloud Code - Botón de acceso en la barra de estado.

  3. Cuando se te solicite permitir que Cloud Code abra el sitio web externo, haz clic en Abrir.

  4. Sigue las indicaciones para acceder a tu Cuenta de Google.

  5. Cuando se te solicite asegurarte de que descargaste Cloud Code de Google, haz clic en Sign In.

    Ahora tienes conexión a Google Cloud.

Habilita Duet AI en Cloud Code

En esta sección, habilitarás Duet AI en Cloud Code. Antes de continuar, asegúrate de seguir las instrucciones de Cómo configurar Duet AI para un proyecto, si aún no lo hiciste.

Sigue estos pasos a fin de habilitar Duet AI en Cloud Code para tu IDE:

  1. En tu IDE, selecciona Code (para macOS) o File (para Windows y Linux) y, luego, navega a Settings > Settings.

  2. En la pestaña Usuario del diálogo Configuración, navega a Extensiones > Google Cloud Code.

  3. Desplázate hasta encontrar Duet AI: Habilitar y selecciona la casilla de verificación Habilitar Duet AI para desarrolladores.

  4. Vuelve a cargar tu IDE.

    De esta manera, se habilita Duet AI en Cloud Code, y la barra de estado de Duet AI aparece en tu IDE.

    La barra de estado de Duet AI está disponible.

  5. Selecciona un proyecto de Google Cloud que tenga habilitada la API de Cloud AI Companion:

    1. En la barra de estado de Duet AI, haz clic en Duet AI.

    2. En el menú Selección rápida de Duuet AI, selecciona un proyecto de Google Cloud que tenga habilitada la API de Cloud AI Companion.

    Duet AI está listo para usar.

    El ícono de Duet AI en la barra de estado está configurado como normal.

    Si seleccionas un proyecto de Google Cloud sin la API de Cloud AI Companion habilitada, recibirás una notificación de error y se te indicará que te comuniques con tu administrador. Para obtener más información, consulta Cómo configurar Duet AI para un proyecto.

Para probar las capacidades de Duet AI, abre una aplicación o crea una aplicación de ejemplo en la siguiente sección.

Opcional: Crea una aplicación de muestra

Si prefieres usar una aplicación existente para probar las capacidades de Duuet AI, puedes omitir esta sección. De lo contrario, sigue estos pasos para crear una aplicación de muestra:

  1. En tu IDE, abre la paleta de comandos. Para ello, presiona Control + Mayús + P (en Windows y Linux) o Comando + Mayús + P (en macOS), y, luego, ejecuta Cloud Code: New Application.

  2. Selecciona Kubernetes application.

  3. Selecciona la plantilla de la aplicación Python (Flask): Guestbook.

  4. Guarda la aplicación nueva en la ubicación que prefieras.

    Una notificación confirma que se creó la aplicación y se abre una ventana nueva con la aplicación cargada.

Chatea con Duet AI

En esta sección, aprenderás a abrir el panel de Duet AI y chatear con Duet AI para obtener una explicación de tu código existente.

Para comenzar a chatear con Duet AI, sigue estos pasos:

  1. Crea uno nuevo o usa uno existente. Si usas la muestra de Python (Flask), puedes realizar esta tarea en el archivo front.py. Para ello, navega a Explorador > src > frontend y abre el archivo front.py.

  2. En la barra de actividades de tu IDE, haz clic en chat_spark Duet AI.

  3. En el panel Duet AI, ingresa el mensaje Explain this code to me y haz clic en Enviar Enviar.

    Duet AI usa el código de tu archivo de código como referencia a tu mensaje y responde con una explicación del código.

    Para hacer referencia a un bloque de código específico en lugar del código completo del archivo, puedes seleccionar el bloque de tu archivo de código y, luego, solicitar Duuet AI.

Restablecer historial de chat

Duet AI usa el historial de chat para brindarte contexto adicional cuando responde tus mensajes.

Si tu historial de chat ya no es relevante para lo que quieres lograr, puedes restablecerlo. Para ello, en el panel Duet AI, haz clic en borrar Restablecer chat.

Cómo generar código con mensajes

En las siguientes secciones, se muestra cómo usar Duet AI para generar código con el mensaje de ejemplo # Function to create a Cloud Storage bucket dentro de un archivo de Python. También puedes seleccionar una parte de tu código y, luego, pedirle ayuda a Duet AI a través de la función de chat, así como recibir y aceptar o rechazar sugerencias de código mientras codificas.

Solicita a Duet AI en un archivo de código

  1. Crea uno nuevo o usa uno existente. Si usas la muestra de Python (Flask), puedes hacerlo en el archivo front.py: navega a Explorer > src > frontend y abre el archivo front.py.

  2. En el archivo de código, ingresa # Function to create a Cloud Storage bucket en una línea nueva y, luego, presiona Intro (en Windows y Linux) o Return (en MacOS).

  3. Para generar código, presiona Control + Intro (en Windows y Linux) o Control + Retorno (en MacOS).

    Junto al texto de la indicación en el archivo de Python, Duet AI genera el código en forma de texto fantasma.

  4. Opcional: Para aceptar el código generado, presiona Tab.

Preguntar a Duet AI con el código seleccionado a través del chat

Duet AI puede realizar tareas o responder tus preguntas según el código que selecciones. Para obtener un código generado basado en un mensaje con el código seleccionado, sigue estos pasos:

  1. En tu IDE, abre un archivo en tu proyecto que contenga código o usa el mismo archivo de código que usaste en los pasos anteriores.

  2. En la barra de actividades, haz clic en chat_spark Duet AI para abrir el panel de Duet AI.

  3. En tu archivo de código, selecciona un bloque de código.

  4. En el campo de texto del panel Duet AI, ingresa un mensaje para el código seleccionado.

    Por ejemplo, selecciona una función en tu código y, luego, ingresa el mensaje Write a unit test for this function:

    Duet AI escribe una prueba de unidades para una función seleccionada.

    Duet AI usa el código que seleccionaste como referencia y responde a tu indicación.

Obtén sugerencias intercaladas mientras escribes código

Mientras escribes código, Duet AI hace sugerencias de códigos intercalados que puedes aceptar o ignorar. Para probar esta función, sigue estos pasos:

  1. Crea uno nuevo o usa uno existente. Si usas la muestra de Python (Flask), puedes hacerlo en el archivo front.py: navega a Explorer > src > frontend y abre el archivo front.py.

  2. En el archivo de código, comienza a escribir una función en una línea nueva. Por ejemplo, si estás en un archivo de Python, escribe def.

    Duet AI sugiere código en forma de texto fantasma.

  3. Para aceptar la sugerencia de código de Duet AI, presiona Tab. De lo contrario, para ignorar la sugerencia, presiona Esc o continúa escribiendo tu código.

Opcional: Inhabilita las sugerencias intercaladas

Si prefieres inhabilitar las sugerencias intercaladas en Duet AI, sigue estos pasos:

  1. En tu IDE, selecciona Code (para macOS) o File (para Windows y Linux) y, luego, navega a Settings > Settings.

  2. En la pestaña Usuario del diálogo Configuración, navega a Extensiones > Cloud Code.

  3. Desplázate hasta encontrar la lista Cloudcode: Duet AI: Inline Suggestions: Enable Auto y, luego, selecciona Off.

    Esta acción desactiva las sugerencias intercaladas. Aún puedes presionar Control + Intro (en Windows y Linux) o Control + Retorno (en MacOS) para activar manualmente las sugerencias intercaladas.

Cómo usar acciones inteligentes

Para ayudarte a aumentar tu productividad y, al mismo tiempo, minimizar el cambio de contexto, Duuet AI proporciona acciones inteligentes con tecnología de IA directamente en tu editor de código. Cuando seleccionas el código en el editor de código, puedes ver y seleccionar de una lista de acciones relevantes para tu contexto.

Para usar acciones inteligentes en tu código, sigue estos pasos:

  1. En tu archivo de código, selecciona un bloque de código.

  2. Junto al bloque de código seleccionado, haz clic en la bombilla Más acciones.

  3. Selecciona una acción, como Generar pruebas de unidades.

    Duet AI genera una respuesta basada en la acción que seleccionaste.

Prueba otros mensajes de ejemplo

Después de leer la sección Cómo generar código con mensajes de este documento, prueba algunos de los siguientes mensajes de ejemplo.

Obtén una explicación del código

  1. En tu archivo de código, selecciona la función que quieras explicar.
  2. En el panel Duet AI, ingresa el mensaje Explain this code to me.

    Duet AI usa el código que seleccionaste como referencia y responde con una explicación de la función seleccionada.

Cómo generar planes de prueba

  1. En tu archivo de código, selecciona el código al que deseas agregar pruebas de unidades.
  2. En el panel Duet AI, ingresa el mensaje Write unit tests for my code.

Cómo obtener ayuda con el código de depuración

  1. En tu archivo de código, selecciona el código que deseas depurar.
  2. En el panel Duet AI, ingresa el mensaje Help me debug my code.

Haz que tu código sea más legible

  1. En tu archivo de código, selecciona el código que quieras que sea más legible.
  2. En el panel Duet AI, ingresa el mensaje Make my code more readable.

    Si prefieres enfocarte en una parte específica del código, selecciona la que prefieras antes de solicitar Duet AI.

Problemas conocidos

En las siguientes secciones, se describen los problemas conocidos de Duet AI en Cloud Code.

Es posible que las respuestas de Chat se trunquen cuando incluyan una versión actualizada de un archivo grande abierto

Para solucionar este problema, selecciona una sección de código más pequeña y agrega una directiva adicional en el mensaje de chat, como only output the selected code..

Vim: No se pueden aceptar ni descartar las sugerencias de generación de código, a menos que esté en el modo de inserción

Cuando usas el complemento Vim en modo normal, no puedes aceptar ni descartar sugerencias de código.

A fin de solucionar este problema, presiona i para ingresar al modo de inserción y, luego, presiona Tab para aceptar la sugerencia.

Vim: Comportamiento incoherente al presionar Esc para descartar sugerencias

Cuando presionas Esc, se descartan las sugerencias de IntelliJ y Duet AI. Este comportamiento es diferente del comportamiento sin Vim, en el que presionar Esc vuelve a activar Duet AI.

Las advertencias de recitación de licencias no persisten entre sesiones

Si las advertencias de recitación de licencias no persisten entre sesiones, consulta los registros persistentes:

  1. Haz clic en Ver > Resultado.

  2. Selecciona Duet AI - Citations.

Problemas de conectividad en la ventana de salida de Duet AI

Si ves un error de conexión o algún otro problema de conectividad en la ventana de salida de Duuet AI, prueba lo siguiente:

  • Configura tu firewall para permitir el acceso a oauth2.googleapis.com y cloudaicompanion.googleapis.com.

  • Configura tu firewall para permitir la comunicación a través de HTTP/2, que usa gRPC.

Puedes usar la herramienta de grpc-health-probe para probar la conectividad. Una verificación correcta da como resultado el siguiente resultado:

$ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

Una verificación incorrecta da como resultado el siguiente resultado:

timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

Para obtener más detalles, ejecuta lo siguiente antes del grpc-health-probe:

export GRPC_GO_LOG_SEVERITY_LEVEL=info

Enviar comentarios

Para dejar comentarios sobre tu experiencia, sigue estos pasos:

  1. En la barra de estado, haz clic en Duet AI y, luego, en el menú Selección rápida, selecciona Enviar comentarios.

  2. En el formulario, completa los campos Título y Comentarios.

  3. Si quieres compartir tus registros de Skaffold o AI Companion, asegúrate de seleccionar la opción Send Skaffold logs o Send AI Companion logs.

  4. Haz clic en Enviar comentarios.

¿Qué sigue?