Esta página se ha traducido con Cloud Translation API.

Configurar Gemini Cloud Assist

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

Configurar Gemini Cloud Assist en un proyecto

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

Consola

Ve a la página Administrar Gemini.

Ir a Gemini para Google Cloud
En el selector de proyectos de la parte superior de la página, selecciona el recurso de tu proyecto.
Selecciona Obtener Gemini Cloud Assist.
En el cuadro de diálogo Obtener Gemini Cloud Assist, haz lo siguiente:
1. Selecciona la flecha de expansión APIs obligatorias y recomendadas.
2. Asegúrate de que estén habilitadas las siguientes APIs obligatorias: API de Gemini Cloud Assist y API de Gemini para Google Cloud.
3. En la lista APIs recomendadas, selecciona las APIs que quieras habilitar.
4. Opcional: Selecciona Ayuda a Google a mejorar Cloud Assist compartiendo tus peticiones y respuestas.
5. Selecciona Habilitar Gemini Cloud Assist sin coste.
Haz clic en Guardar.
Concede los roles de gestión de identidades y accesos necesarios para usar Gemini Cloud Assist.
1. Ve a la página IAM y administración.
  
  Ir a IAM y administración
2. En la columna Principal, busque un principal al que quiera dar acceso a Gemini Cloud Assist y, a continuación, haga clic en Editar principal en esa fila.
3. En el panel Editar acceso, haz clic en Añadir otro rol.
4. En Seleccionar un rol, selecciona Usuario de Gemini Cloud Assist.
5. Haz clic en Añadir otro rol y selecciona Visor de Recommender.
6. Si el principal quiere obtener ayuda con productos a los que aún no tiene acceso, es posible que tengas que concederle roles de gestión de identidades y accesos adicionales haciendo clic en Añadir otro rol y seleccionando otros roles. Consulta la tabla de roles de gestión de identidades y accesos necesarios para usar Gemini Cloud Assist para ver los roles de gestión de identidades y accesos que permiten disfrutar de una experiencia óptima con Gemini Cloud Assist en diferentes productos.

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell
Habilita la API Gemini Cloud Assist con el comando gcloud services enable:
```
gcloud services enable geminicloudassist.googleapis.com
```
Este paso también habilita la API Gemini for Google Cloud, que también es necesaria para usar Gemini Cloud Assist.

Si quieres habilitar la API Gemini Cloud Assist en otro proyecto, añade el parámetro --project:Google Cloud
```
gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID
```
El resultado debería ser similar al siguiente:
```
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.
```
(Opcional) Habilita las APIs recomendadas con el comando gcloud services enable, como hiciste para habilitar la API Gemini Cloud Assist.
Asigna roles de gestión de identidades y accesos en un Google Cloud proyecto. Para obtener más información, consulta los artículos Asignar un rol concreto y gcloud projects add-iam-policy-binding.
1. Asigna el rol roles/geminicloudassist.user:
```
gcloud projects add-iam-policy-binding PROJECT_ID \
  --member=PRINCIPAL --role=roles/geminicloudassist.user
```
  Haz los cambios siguientes:
  - PROJECT_ID: el ID de tu Google Cloud proyecto, por ejemplo,1234567890.
  - PRINCIPAL: el identificador de la entidad principal. Por ejemplo, user:cloudysanfrancisco@gmail.com.
  El resultado es una lista de enlaces 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.
3. Si el principal quiere obtener ayuda con productos a los que aún no tiene acceso, es posible que tengas que asignarle roles de gestión de identidades y accesos adicionales. Consulta la tabla de roles de gestión de identidades y accesos necesarios para usar Gemini Cloud Assist para ver los roles de gestión de identidades y accesos que permiten disfrutar de una experiencia óptima con Gemini Cloud Assist en diferentes productos.

API

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

Habilita la API 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"
```
Sustituye PROJECT_ID por el ID del proyecto en el que vas a habilitar Gemini Cloud Assist.

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

Nota: Al habilitar el servicio geminicloudassist.googleapis.com, también se habilita el servicio cloudaicompanion.googleapis.com, que es necesario para usar Gemini Cloud Assist.
(Opcional) Habilita las APIs recomendadas mediante el método services.enable, como hiciste para habilitar la API Gemini Cloud Assist.
Concede roles de gestión de identidades y accesos al Google Cloud proyecto asociado.
1. Crea un archivo JSON que contenga la siguiente información:
```
  {
    "options": {
      "requestedPolicyVersion": 3
    }
  }
```
2. Recupera la política de gestión de identidades y accesos del 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"
```
  Haz los cambios siguientes:
  - JSON_FILE_NAME: la ruta del archivo JSON que has creado en el paso anterior.
  - PROJECT_ID: el ID del proyecto.
  Si la acción se realiza correctamente, 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 añade la siguiente información al contenido:
```
  {
    "role": "roles/geminicloudassist.user",
    "members": [
      "PRINCIPAL"
    ]
  },
  {
    "role": "roles/recommender.viewer",
    "members": [
      "PRINCIPAL"
    ]
  }
```
  Sustituye PRINCIPAL por el identificador de la entidad a la que vas a conceder acceso a Gemini Cloud Assist.
4. Aplica la política de gestión de identidades y accesos 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"
```
  Haz los cambios siguientes:
  - JSON_FILE_NAME: la ruta del archivo JSON que has creado en el paso anterior.
  - PROJECT_ID: el ID del proyecto.
  Si la acción se realiza correctamente, la respuesta devuelve la política de IAM actualizada del proyecto.
5. Si el principal quiere obtener ayuda con productos a los que aún no tiene acceso, es posible que tengas que asignarle roles de gestión de identidades y accesos adicionales. Consulta la tabla de roles de gestión de identidades y accesos necesarios para usar Gemini Cloud Assist para ver los roles de gestión de identidades y accesos que permiten disfrutar de una experiencia óptima con Gemini Cloud Assist en diferentes productos.

Configurar Gemini Cloud Assist en una carpeta

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

Habilita las APIs obligatorias y recomendadas.
1. Ve a la página Administrar Gemini.
  
  Ir a Administrar Gemini
2. En el selector de proyectos de la parte superior de la página, selecciona el recurso de tu carpeta.
3. Selecciona Habilitar APIs de Cloud Assist.
  
  Aparecerá el cuadro de diálogo Habilitar API en proyectos de la carpeta.
4. En el cuadro de diálogo Habilitar API para proyectos de una carpeta, selecciona la flecha del desplegable de 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 peticiones y respuestas.
7. Selecciona Habilitar Gemini Cloud Assist sin coste.
  
  Este paso habilita las APIs obligatorias y las recomendadas seleccionadas para todos los proyectos de la carpeta. Si quieres que haya excepciones en algunos proyectos de la carpeta, puedes bloquear la habilitación de la API configurando una restricción de la política de organización RestrictResourceServiceUsage en esos proyectos. Para obtener más información, consulta Restringir el uso de recursos.
Concede los siguientes roles de gestión de identidades y accesos o crea roles personalizados con permisos equivalentes en la carpeta:
- Usuario de Cloud Assist
- Lector de recursos de Cloud
- Lector de recomendaciones
Si el principal quiere obtener ayuda con productos a los que aún no tiene acceso, es posible que tengas que concederle roles de gestión de identidades y accesos adicionales. Consulta la tabla de roles de gestión de identidades y accesos necesarios para usar Gemini Cloud Assist para ver los roles de gestión de identidades y accesos que permiten disfrutar de una experiencia óptima con Gemini Cloud Assist en diferentes productos.
Si usas Gemini Cloud Assist con aplicaciones, también debes habilitar la gestión de aplicaciones a nivel de carpeta. Con este paso se crea un proyecto de gestión al que debes vincular una cuenta de facturación.
1. Vuelve a la página Administrar Gemini.
  
  Ir a Administrar Gemini
2. Selecciona Habilitar gestión de aplicaciones.
  
  Se abrirá la página de configuración IAM y administración.
3. Selecciona Habilitar en la sección Habilitación de aplicaciones de la página.
  
  Aparecerá el cuadro de diálogo Habilitar 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 IAM y administración se actualiza cuando se completa la habilitación de la API.
5. Selecciona Gestionar facturación.
  
  Aparecerá la página Cuenta vinculada.
6. Selecciona una cuenta de facturación de la lista y, a continuación, Definir cuenta.
Asigna los roles de gestión de identidades y accesos que has asignado a la carpeta en el paso 2 o crea roles personalizados con permisos equivalentes al proyecto de gestión creado en el paso anterior.

Busca el proyecto de gestión de la carpeta:
1. Vuelve a la página Administrar Gemini.
  
  Ir a Administrar Gemini
2. En el selector de proyectos de la parte superior de la página, selecciona el recurso de tu carpeta.
3. Selecciona Gestionar la configuración de Gemini Cloud Assist.
  
  Aparecerá el cuadro de diálogo Gestionar Gemini Cloud Assist.
4. Anota el proyecto de gestión.
(Opcional) Configura los ajustes de los proyectos de la carpeta.

Siguientes pasos

Consulta los precios de Gemini Cloud Assist.
Consulta cómo usar el panel Asistencia de Cloud en la Google Cloud consola.