Configurar Gemini Cloud Assist

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

Configurar Gemini Cloud Assist para un proyecto

Los siguientes pasos detallan cómo configurar Gemini Cloud Assist para un proyecto en el Google Cloud consola o usando Google Cloud CLI.

Consola

  1. Vaya a la página de administración de Gemini .

    Vaya a Gemini para Google Cloud

  2. Desde el selector de proyectos en la parte superior de la página, seleccione el recurso de su proyecto.

  3. Seleccione Obtener Gemini Cloud Assist .

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

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

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

    3. En la lista de API recomendadas , seleccione las API que desea habilitar.

    4. Opcional: selecciona Ayuda a Google a mejorar Cloud Assist compartiendo tus indicaciones y respuestas .

    5. Seleccione Habilitar Gemini Cloud Assist sin costo .

  5. Haga clic en Guardar .

  6. Otorgue los roles de IAM necesarios para utilizar Gemini Cloud Assist.

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

      Vaya a IAM y administración

    2. En la columna Principal , busque un principal al que desea otorgar acceso a Gemini Cloud Assist y luego haga clic en Editar principal en esa fila.

    3. En el panel Editar acceso , haga clic en Agregar otro rol .

    4. En Seleccionar un rol , seleccione Usuario de Gemini Cloud Assist .

    5. Haga clic en Agregar otro rol y seleccione Visor de recomendadores .

    Si el director desea obtener asistencia con productos a los que aún no tiene acceso, es posible que deba otorgarle roles de IAM adicionales. Consulte los requisitos de IAM para usar Gemini Cloud Assist para ver una tabla de roles de IAM que permiten una experiencia óptima con Gemini Cloud Assist para diferentes productos.

nube g

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

    Activate Cloud Shell

  2. Habilite la API de Gemini Cloud Assist mediante 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 utilizar Gemini Cloud Assist.

    Si desea habilitar la API de Gemini Cloud Assist en una ubicación diferenteGoogle Cloud proyecto, agregue el parámetro --project :

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

    La salida es similar a la siguiente:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
    Operation finished successfully.
    
  3. Otorgar roles de IAM en un Google Cloud Proyecto. Para obtener más información, consulte Otorgar un rol único y gcloud projects add-iam-policy-binding .

    1. Otorgar el rol roles/geminicloudassist.user :

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

      Reemplace lo siguiente:

      • PROJECT_ID : el ID de suGoogle Cloud proyecto—por ejemplo, 1234567890 .
      • PRINCIPAL : el identificador del 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. Repita el paso anterior para el rol roles/recommender.viewer .

    Si el director desea obtener asistencia con productos a los que aún no tiene acceso, es posible que deba otorgarle roles de IAM adicionales. Consulte los requisitos de IAM para usar Gemini Cloud Assist para ver una tabla de roles de IAM que permiten una experiencia óptima con Gemini Cloud Assist para diferentes productos.

API

Estas instrucciones utilizan cURL para llamar a métodos API.

  1. Habilite la API de Gemini Cloud Assist mediante 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"
    

    Reemplace PROJECT_ID con el ID del proyecto para el cual está habilitando Gemini Cloud Assist.

    Si el comando se ejecuta correctamente, devuelve una long-running operation que incluye un campo name . Puede usar el valor de name campo para comprobar el estado de la operación .

  2. Otorgar roles de IAM para los asociados Google Cloud proyecto.

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

        {
          "options": {
            "requestedPolicyVersion": 3
          }
        }
      
    2. Recupere la política de IAM existente para el proyecto utilizando 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"
      

      Reemplace lo siguiente:

      • JSON_FILE_NAME : la ruta del archivo JSON que creó en el paso anterior.

      • PROJECT_ID : el ID del proyecto.

      Si tiene éxito, la respuesta devuelve la política IAM del proyecto.

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

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

      Reemplace PRINCIPAL con el identificador del principal al que le está otorgando acceso a Gemini Cloud Assist.

    4. Aplique la política de IAM actualizada al proyecto utilizando 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"
      

      Reemplace lo siguiente:

      • JSON_FILE_NAME : la ruta del archivo JSON que creó en el paso anterior.

      • PROJECT_ID : el ID del proyecto.

      Si tiene éxito, la respuesta devuelve la política de IAM actualizada del proyecto.

    Si el director desea obtener asistencia con productos a los que aún no tiene acceso, es posible que deba otorgarle roles de IAM adicionales. Consulte los requisitos de IAM para usar Gemini Cloud Assist para ver una tabla de roles de IAM que permiten una experiencia óptima con Gemini Cloud Assist para diferentes productos.

Configurar Gemini Cloud Assist para una carpeta

Los siguientes pasos detallan cómo configurar Gemini Cloud Assist para una carpeta en el Google Cloud consola. No puedes usar Google Cloud CLI para configurar Gemini Cloud Assist.

  1. Habilitar las API obligatorias y recomendadas.

    1. Vaya a la página de administración de Gemini .

      Vaya a Administración para Gemini

    2. Desde el selector de proyectos en la parte superior de la página, seleccione su recurso de carpeta.

    3. Seleccione Obtener asistencia en la nube de Gemini .

      Aparece el cuadro de diálogo Habilitar API para proyectos existentes dentro de la carpeta .

    4. En el cuadro de diálogo Habilitar API para proyectos existentes dentro de una carpeta , seleccione la flecha de expansión que se encuentra en la sección API requeridas y recomendadas .

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

    6. En la lista de API recomendadas , seleccione las API que desea habilitar.

    7. Opcional: selecciona Ayuda a Google a mejorar Cloud Assist compartiendo tus indicaciones y respuestas .

    8. Seleccione Habilitar Gemini Cloud Assist sin costo .

      Este paso habilita las API recomendadas requeridas y seleccionadas para todos los proyectos de la carpeta. Si desea excepciones para algunos proyectos de la carpeta, puede bloquear la habilitación de las API mediante la restricción de la política de organización " Restringir el uso del servicio de recursos " en esos proyectos. Para obtener más información, consulte "Restringir el uso de recursos" .

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

    • Gemini para usuarios de Google Cloud
    • Visor de activos en la nube
    • Visor de recomendadores

    Si el director desea obtener asistencia con productos a los que aún no tiene acceso, es posible que deba otorgarle roles de IAM adicionales. Consulte los requisitos de IAM para usar Gemini Cloud Assist para ver una tabla de roles de IAM que permiten una experiencia óptima con Gemini Cloud Assist para diferentes productos.

  3. Si usa Gemini Cloud Assist con aplicaciones, también debe habilitar la administración de aplicaciones . Este paso crea un proyecto de administración al que debe vincular una cuenta de facturación.

    1. Regresar a la página de Administración de Gemini .

      Vaya a Administración para Gemini

    2. Seleccione Habilitar administración de aplicaciones .

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

    3. Seleccione Habilitar en la sección Habilitación de aplicaciones de la página.

      Aparece el cuadro de diálogo Habilitar API de aplicación en esta carpeta .

    4. Seleccione 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 al finalizar la habilitación.

    5. Seleccione Administrar facturación .

      Aparece la página de cuenta vinculada .

    6. Seleccione una cuenta de facturación de la lista y luego seleccione Establecer cuenta .

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

    Busque el proyecto de administración para la carpeta:

    1. Regresar a la página de Administración de Gemini .

      Vaya a Administración para Gemini

    2. Desde el selector de proyectos en la parte superior de la página, seleccione su recurso de carpeta.

    3. Seleccione Administrar configuración de Gemini Cloud Assist .

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

    4. Tenga en cuenta el proyecto de gestión .

  5. (Opcional) Configure los ajustes para los proyectos en la carpeta .

Cualquier proyecto agregado a la carpeta se habilita automáticamente para Gemini Cloud Assist.

¿Qué sigue?