Configura Gemini Cloud Assist

Antes de que puedas usar Gemini Cloud Assist, tu administrador debe realizar los pasos de configuración que se describen en este documento. Gemini Cloud Assist se puede configurar para un proyecto o una carpeta.

Configura Gemini Cloud Assist para un proyecto

En los siguientes pasos, se detalla cómo configurar Gemini Cloud Assist para un proyecto en la consola de Google Cloud o con Google Cloud CLI.

Console gcloud

  1. Ve a la página Administrador de Gemini.

    Ir a Gemini para Google Cloud

  2. En el selector de proyectos de la parte superior de la página, selecciona el recurso de tu proyecto.

  3. Selecciona Obtener Gemini Cloud Assist.

  4. En el diálogo Get Gemini Cloud Assist, haz lo siguiente:

    1. Selecciona la flecha del expansor que se encuentra en la sección APIs requeridas y recomendadas.

    2. Asegúrate de que las siguientes APIs requeridas estén habilitadas: API de Gemini Cloud Assist y API de Gemini para Google Cloud.

    3. En la lista APIs recomendadas, selecciona las APIs que quieres habilitar.

    4. Opcional: Selecciona Comparte tus instrucciones y respuestas para ayudar a Google a mejorar Cloud Assist.

    5. Selecciona Habilita Gemini Cloud Assist sin costo.

  5. Haz clic en Guardar.

  6. Otorga los roles de IAM necesarios para usar Gemini Cloud Assist.

    1. Ir a la página IAM y administración

      Ir a IAM y administración

    2. En la columna Principal, busca una principal para la que deseas otorgar acceso a Gemini Cloud Assist y, luego, haz clic en Editar principal en esa fila.

    3. En el panel Editar permisos, haz clic en Agregar otro rol.

    4. En Selecciona un rol, selecciona Usuario de Gemini Cloud Assist.

    5. Haz clic en Agregar otro rol y selecciona Visualizador de Recommender.

    Si la principal quiere obtener asistencia con productos a los que aún no tiene acceso, es posible que debas otorgarle roles de IAM adicionales. Consulta Requisitos de IAM para usar Gemini Cloud Assist para ver una tabla de roles de IAM que permiten una experiencia óptima de Gemini Cloud Assist para diferentes productos.

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  2. Habilita la API de Gemini Cloud Assist con el comando gcloud services enable:

    gcloud services enable geminicloudassist.googleapis.com

    Este paso también habilita la API de Gemini para Google Cloud, que también es necesaria para usar Gemini Cloud Assist.

    Si quieres habilitar la API de Gemini Cloud Assist en un proyecto de Google Cloud diferente, agrega el parámetro --project:

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

    El resultado es similar a este:

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

  3. Otorga roles de IAM en un proyecto de Google Cloud. Para obtener más información, consulta Otorga un solo rol y gcloud projects add-iam-policy-binding.

    1. Otorga la función roles/geminicloudassist.user:

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

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

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

      - members:
  - user:PRINCIPAL
  role: roles/geminicloudassist.user

    2. Repite el paso anterior para el rol roles/recommender.viewer.

    Si la principal quiere obtener asistencia con productos a los que aún no tiene acceso, es posible que debas otorgarle roles de IAM adicionales. Consulta Requisitos de IAM para usar Gemini Cloud Assist para ver una tabla de roles de IAM que permiten una experiencia óptima de Gemini Cloud Assist para diferentes productos.

Configura Gemini Cloud Assist para una carpeta

En los siguientes pasos, se detalla cómo configurar Gemini Cloud Assist para una carpeta en la consola de Google Cloud. No puedes usar Google Cloud CLI para configurar Gemini Cloud Assist.

  1. Habilita las APIs obligatorias y recomendadas.

    1. Ve a la página Administrador de Gemini.

      Ve a Administrador de Gemini

    2. En el selector de proyectos de la parte superior de la página, selecciona el recurso de la carpeta.

    3. Selecciona Obtener asistencia de Gemini Cloud.

      Aparecerá el diálogo Habilita la API para los proyectos existentes en la carpeta.

    4. En el diálogo Habilita la API para los proyectos existentes en una carpeta,selecciona la flecha del expansor que se encuentra en la sección APIs obligatorias y recomendadas.

    5. Asegúrate de que las siguientes APIs requeridas estén habilitadas: API de Gemini Cloud Assist y API de Gemini para Google Cloud.

    6. En la lista APIs recomendadas, selecciona las APIs que quieres habilitar.

    7. Opcional: Selecciona Comparte tus instrucciones y respuestas para ayudar a Google a mejorar Cloud Assist.

    8. Selecciona Habilita Gemini Cloud Assist sin costo.

      Este paso habilita las APIs recomendadas seleccionadas y obligatorias para todos los proyectos de la carpeta. Si deseas establecer excepciones para algunos proyectos en la carpeta, puedes bloquear la habilitación de la API configurando una restricción de la política de la organización Restringir el uso de servicios del recurso en esos proyectos. Para obtener más información, consulta Restringe el uso de recursos.

  2. Otorga los siguientes roles de IAM o crea roles personalizados con permisos equivalentes en la carpeta:

    • Usuario de Gemini para Google Cloud
    • Visualizador de Cloud Asset
    • Visor de Recommender

    Si la principal quiere obtener asistencia con productos a los que aún no tiene acceso, es posible que debas otorgarle roles de IAM adicionales. Consulta Requisitos de IAM para usar Gemini Cloud Assist para ver una tabla de roles de IAM que permiten una experiencia óptima de Gemini Cloud Assist para diferentes productos.

  3. Si usas Gemini Cloud Assist con aplicaciones, también debes habilitar la administración de aplicaciones. Con este paso, se crea un proyecto de administración al que debes vincular una cuenta de facturación.

    1. Regresa a la página Administrador de Gemini.

      Ve a Administrador de Gemini

    2. Selecciona Habilitar administración de apps.

      Aparecerá la página de configuración IAM y administración.

    3. Selecciona Habilitar en la sección Habilitación de apps de la página.

      Aparecerá el diálogo Habilita las APIs de la aplicación en esta carpeta.

    4. Selecciona Habilitar.

      Una barra de estado muestra el progreso de la habilitación de la API. La página de configuración de IAM y administración se actualiza cuando se completa la habilitación de la API.

    5. Selecciona Administrar facturación.

      Aparecerá la página Cuenta vinculada.

    6. Selecciona una cuenta de facturación de la lista y, luego, Establecer la cuenta.

  4. Otorga los roles de IAM que otorgaste a la carpeta en el paso 2 o crea roles personalizados con permisos equivalentes al proyecto de administración creado en el paso anterior.

    Busca el proyecto de administración de la carpeta:

    1. Regresa a la página Administrador de Gemini.

      Ve a Administrador de Gemini

    2. En el selector de proyectos de la parte superior de la página, selecciona el recurso de la carpeta.

    3. Selecciona Administrar la configuración de Gemini Cloud Assist.

      Aparecerá el diálogo Administrar Gemini Cloud Assist.

    4. Anota el proyecto de administración.

  5. (Opcional) Configura la configuración de los proyectos de la carpeta.

¿Qué sigue?