Configura Gemini Cloud Assist

Gemini Cloud Assist te ayuda a diseñar, operar y optimizar tus aplicaciones y tu infraestructura de nube con orientación contextual de IA. Antes de que los miembros del equipo puedan usar estas funciones, un administrador debe completar la configuración inicial de 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.

Console

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

    Ir a Gemini para Google Cloud

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

  3. Selecciona Obtener Gemini Cloud Assist.

  4. En el cuadro de diálogo Obtener Gemini Cloud Assist, haz lo siguiente:

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

    2. En la lista APIs recomendadas, selecciona las APIs adicionales que quieras habilitar para mejorar el rendimiento de Gemini Cloud Assist.

    3. Opcional: Selecciona Ayuda a Google a mejorar Cloud Assist compartiendo tus instrucciones y respuestas.

    4. Selecciona Habilitar 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 a la que desees 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 Cloud Asset.

    6. 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. Para ello, haz clic en Agregar otro rol y selecciona los roles adicionales. Consulta Requisitos de IAM para usar Gemini Cloud Assist y obtener una tabla de roles de IAM que habilitan una experiencia óptima de Gemini Cloud Assist para diferentes productos.

    7. Si tu proyecto forma parte de una organización que usa restricciones personalizadas, revisa los permisos necesarios para el chat y asegúrate de que el chat de Gemini Cloud Assist no esté bloqueado.

  7. (Opcional) Establece la configuración del proyecto.

gcloud

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

    Activa Cloud Shell

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

    gcloud services enable geminicloudassist.googleapis.com

    Con este paso, también se habilita la API de Gemini para Google Cloud, que también se requiere 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

    Reemplaza PROJECT_ID por el ID del proyecto para el que habilitarás Gemini Cloud Assist.

    El resultado es similar a lo siguiente:

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

  3. Habilita otras APIs requeridas con el comando gcloud services enable como lo hiciste para habilitar la API de Gemini Cloud Assist:

    gcloud services enable cloudasset.googleapis.com designcenter.googleapis.com appoptimize.googleapis.com apphub.googleapis.com --project PROJECT_ID

  4. Habilita las APIs recomendadas con el comando gcloud services enable como lo hiciste para habilitar la API de Gemini Cloud Assist (opcional).

  5. 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 lo siguiente:

      • PROJECT_ID: Es el ID de tu proyecto deGoogle Cloud , por ejemplo,1234567890.
      • PRINCIPAL: Es el identificador de la principal, por ejemplo, user:cloudysanfrancisco@gmail.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/cloudasset.viewer.

    3. Si la principal desea 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 y obtener una tabla de roles de IAM que habilitan una experiencia óptima de Gemini Cloud Assist para diferentes productos.

    4. Si tu proyecto forma parte de una organización que usa restricciones personalizadas, revisa los permisos necesarios para el chat y asegúrate de que el chat de Gemini Cloud Assist no esté bloqueado.

  6. (Opcional) Establece la configuración del proyecto.

API

En estas instrucciones, se usa cURL para llamar a los métodos de la API.

  1. Habilita la API de Gemini Cloud Assist con el método services.enable:

    curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/geminicloudassist.googleapis.com:enable"

    Reemplaza PROJECT_ID por el ID del proyecto para el que habilitarás Gemini Cloud Assist.

    Si el comando se ejecuta de forma correcta, devuelve un long-running operation, que incluye un campo name. Puedes usar el valor del campo name para verificar el estado de la operación.

  2. Habilita las siguientes APIs adicionales requeridas con el método services.enable como lo hiciste para habilitar la API de Gemini Cloud Assist:

    • cloudasset.googleapis.com
    • designcenter.googleapis.com
    • appoptimize.googleapis.com
    • apphub.googleapis.com

  3. (Opcional) Habilita las APIs recomendadas con el método services.enable como lo hiciste para habilitar la API de Gemini Cloud Assist.

  4. Otorga roles de IAM para el proyecto de Google Cloud asociado.

    1. Crea un archivo JSON que contenga la siguiente información:

        {
    "options": {
      "requestedPolicyVersion": 3
    }
  }

    2. Recupera la política de IAM existente para el proyecto con el método projects.getIamPolicy:

        curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:getIamPolicy"

      Reemplaza lo siguiente:

      • JSON_FILE_NAME: Es la ruta de acceso al archivo JSON que creaste en el paso anterior.

      • PROJECT_ID: Es el ID del proyecto.

      Si se ejecuta de forma correcta, la respuesta devuelve la política de IAM del proyecto.

    3. Copia la política de IAM del proyecto en un archivo JSON vacío y agrega la siguiente información al contenido existente:

        {
    "role": "roles/geminicloudassist.user",
    "members": [
      "PRINCIPAL"
    ]
  },
  {
    "role": "roles/cloudasset.viewer",
    "members": [
      "PRINCIPAL"
    ]
  }

      Reemplaza PRINCIPAL por el identificador de la principal a la que le otorgas acceso a Gemini Cloud Assist.

    4. Aplica la política de IAM actualizada al proyecto con el método projects.setIamPolicy:

        curl -X POST --data-binary @JSON_FILE_NAME \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:setIamPolicy"

      Reemplaza lo siguiente:

      • JSON_FILE_NAME: Es la ruta de acceso al archivo JSON que creaste en el paso anterior.

      • PROJECT_ID: Es el ID del proyecto.

      Si se ejecuta de forma correcta, la respuesta devuelve la política de IAM actualizada del proyecto.

    5. Si la principal desea 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 y obtener una tabla de roles de IAM que habilitan una experiencia óptima de Gemini Cloud Assist para diferentes productos.

    6. Si tu proyecto forma parte de una organización que usa restricciones personalizadas, revisa los permisos necesarios para el chat y asegúrate de que el chat de Gemini Cloud Assist no esté bloqueado.

  5. (Opcional) Establece la configuración del proyecto.

Configura Gemini Cloud Assist para una carpeta

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

  1. Habilita las APIs obligatorias y recomendadas.

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

      Ir a Administrador para Gemini

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

    3. Selecciona Habilitar las APIs de Cloud Assist.

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

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

    5. En la lista APIs recomendadas, selecciona las APIs opcionales que quieras habilitar.

    6. Opcional: Selecciona Ayuda a Google a mejorar Cloud Assist compartiendo tus instrucciones y respuestas.

    7. Selecciona Habilitar Gemini Cloud Assist sin costo.

      En este paso, se habilitan las APIs recomendadas obligatorias y seleccionadas para todos los proyectos de la carpeta. Si deseas excepciones para algunos proyectos de 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 Cloud Assist
    • Visualizador de recursos de Cloud

    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 y obtener una tabla de roles de IAM que habilitan una experiencia óptima de Gemini Cloud Assist para diferentes productos.

  3. Si tu carpeta forma parte de una organización que usa restricciones personalizadas, revisa los permisos necesarios para el chat para asegurarte de que el chat de Gemini Cloud Assist no esté bloqueado.

  4. Si usas Gemini Cloud Assist con aplicaciones, también debes habilitar la administración de aplicaciones a nivel de la carpeta. En 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.

      Ir a Administrador para Gemini

    2. Selecciona Habilitar la administración de apps.

      Aparecerá la página de configuración de 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 aplicaciones 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 cuenta.

  5. 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.

      Ir a Administrador para Gemini

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

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

      Aparecerá el cuadro de diálogo Administrar Gemini Cloud Assist.

    4. Toma nota del proyecto de administración.

  6. Establece la configuración de los proyectos de la carpeta (opcional).

¿Qué sigue?