Configura Duet AI para desarrolladores de un proyecto

Antes de que puedas usar Duet AI para desarrolladores en los productos compatibles de Google Cloud, tu equipo debe seguir los pasos que se describen en este documento:

  1. Compra una suscripción a una o más ofertas de productos de Duet AI.

  2. Activa Duet AI en un proyecto de Google Cloud. Por lo general, un administrador realiza este paso.

  3. Si quieres usar Duet AI en un IDE, instala el complemento de Cloud Code.

Compra una suscripción a Duet AI

Si solo usas Duet AI para BigQuery, Spanner o Colab Enterprise, puedes omitir esta sección.

Duet AI para desarrolladores está disponible para probarla sin una suscripción sin costo hasta el 11 de mayo de 2024, con un límite de un usuario por cuenta de facturación. Las organizaciones con varios usuarios por cuenta de facturación deben comprar una suscripción como se describe en esta sección. Si tienes contratos existentes con Google Cloud, comunícate con nuestro equipo de ventas antes de comprar una suscripción.

  1. En la consola de Google Cloud, ve a la página Administrador de Duet AI.

    Ir a Administrador de Duet AI

  2. Revisa y confirma el mensaje Antes de comenzar.

  3. Si no tienes una suscripción para esta cuenta de facturación, verás la página de la promoción. Haz clic en Comenzar a usar Duet AI.

  4. Si se te solicita, selecciona una cuenta de facturación y haz clic en la página Continuar con la página Administrador de Duet AI.

  5. En la página Suscripciones, haz clic en Comprar suscripción nueva.

  6. Completa los campos para Configurar suscripción, incluido un nombre opcional para la suscripción, el período del compromiso (mensual o anual) y la cantidad de licencias de la suscripción.

    Elige si quieres renovar automáticamente la suscripción después del plazo del compromiso (mensual o anual). Esto mantiene la suscripción y las licencias activas. Si la suscripción no se renueva automáticamente, finalizará cuando finalice el período actual y deberás volver a realizar el proceso de compra para recuperar las licencias.

  7. Haz clic en Continuar para revisar los detalles de la suscripción. Revisa y acepta las condiciones de compra.

  8. Haz clic en Complete Purchase y, luego, confirma tu suscripción.

Ahora, la facturación está habilitada para Duet AI. Luego, activa Duet AI en uno o más proyectos asociados con esta cuenta de facturación. Los usuarios no verán Duet AI hasta que lo hayas activado en al menos un proyecto

Activa Duet AI en un proyecto de Google Cloud

Para activar Duet AI en un proyecto de Google Cloud, un administrador debe habilitar la API de Cloud AI Companion y otorgar a los usuarios los roles de usuario de Cloud AI Companion y de Identity and Access Management (IAM) de visualizador de Service Usage.

Console

  1. Para habilitar la API, ve a la página API de Cloud AI Companion en la consola de Google Cloud.

    Ir a la API de Cloud AI Companion

  2. En el selector de proyectos, selecciona un proyecto.

  3. Haz clic en Habilitar.

    La página se actualizará y mostrará el estado Habilitada. Duet AI ahora está disponible en el proyecto de Google Cloud seleccionado para todos los usuarios que tengan los roles de IAM necesarios.

  4. Si quieres otorgar los roles de IAM necesarios para usar Duet AI, ve a la página IAM.

    Ir a IAM

  5. En la columna Principal, busca una principal para la que quieras habilitar el acceso a Duet AI y, luego, haz clic en Editar principal en esa fila.

  6. En el panel Acceso de edición, haz clic en Agregar otro rol.

  7. En Selecciona un rol, elige Usuario de Cloud AI Companion.

  8. Haz clic en Agregar otro rol y selecciona Visualizador de Service Usage.

  9. Haz clic en Guardar.

gcloud

  1. En la consola de Google Cloud, activa Cloud Shell.

    Activar Cloud Shell

  2. En la lista desplegable del selector de proyectos, selecciona un proyecto.

  3. Habilita la API de Cloud AI Companion para Duet AI con el comando gcloud services enable:

    gcloud services enable cloudaicompanion.googleapis.com
    

    Si quieres habilitar la API de Cloud AI Companion para un proyecto de Google Cloud diferente, agrega el parámetro --project:

    gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
    

    Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud.

    El resultado es similar al siguiente:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
    Operation finished successfully.
    

    Duet AI ahora está disponible en el proyecto de Google Cloud especificado para todos los usuarios que tengan los roles de IAM necesarios.

  4. Otorga los dos roles de IAM necesarios para usar Duet AI:

    1. Otorga el rol Usuario de Cloud AI Companion:

      gcloud projects add-iam-policy-binding  PROJECT_ID \
      --member=PRINCIPAL --role=roles/cloudaicompanion.user
      

      Reemplaza PRINCIPAL por el identificador de la principal. El identificador toma el formato user|group|serviceAccount:email o domain:domain, por ejemplo, user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com o domain:example.domain.com.

      El resultado es una lista de vinculaciones de políticas que incluye lo siguiente:

      - members:
        - user:PRINCIPAL
        role: roles/cloudaicompanion.user
      
    2. Otorga el rol Visualizador de Service Usage:

      gcloud projects add-iam-policy-binding  PROJECT_ID \
      --member=PRINCIPAL --role=roles/serviceusage.serviceUsageViewer
      

      El resultado es una lista de vinculaciones de políticas que incluye lo siguiente:

      - members:
        - user:PRINCIPAL
        role: roles/serviceusage.serviceUsageViewer
      

    Para obtener más información, consulta Cómo otorgar un solo rol y gcloud projects add-iam-policy-binding.

Todos los usuarios a los que se les otorgaron estos roles pueden acceder a las funciones de Duet AI en la consola de Google Cloud dentro del proyecto especificado. Para obtener más información, consulta la Descripción general de Duet AI en Google Cloud.

Usa Duet AI en un IDE

Si eres desarrollador y quieres usar Duet AI en tu IDE, debes instalar el complemento de Cloud Code. Para obtener más información, consulta lo siguiente:

Tareas de configuración avanzada

En lugar de usar la consola de Google Cloud o gcloud CLI para otorgar roles predefinidos de IAM, puedes realizar cualquiera de las siguientes acciones:

¿Qué sigue?