Crear una investigación de Cloud Assist

Nota: El uso de esta oferta de vista previa de Gemini Cloud Assist está sujeto al Google Cloud Contrato, incluidos los Términos de la Oferta de Acceso Previo a la Disponibilidad General de los Google Cloud Términos Específicos del Servicio, complementados por los términos del Programa de Testers de Confianza de Gemini para Google Cloud .

En esta página se explica cómo crear y revisar investigaciones de Gemini Cloud Assist.

Antes de empezar

1. Comprueba que tu proyecto tenga habilitadas las siguientes APIs:

   • cloudaicompanion.googleapis.com
   • cloudasset.googleapis.com
   • cloudresourcemanager.googleapis.com
   • geminicloudassist.googleapis.com
   • logging.googleapis.com (recomendado)
   • monitoring.googelapis.com (recomendado)

   Consulta Habilitar e inhabilitar servicios para obtener instrucciones sobre cómo habilitar APIs.

2. Para obtener los permisos necesarios para crear una investigación, pide a tu administrador que te asigne el rol de gestión de identidades y accesos Creador de investigaciones (roles/geminicloudassist.investigationCreator) en el proyecto.

   Este rol predefinido contiene el permiso necesario para crear una investigación en tu proyecto. Cuando creas una investigación, se te asigna el rol de gestión de identidades y accesos Propietario de la investigación (roles/geminicloudassist.investigationOwner) en esa investigación, lo que te permite revisar los resultados de la investigación.

3. Tener acceso al producto que se está investigando.

   Cuando llevas a cabo una investigación, Gemini Cloud Assist usa tus credenciales para acceder a APIs e información. Esto significa que el acceso de la investigación se limita al acceso que tengas.

4. Si tienes previsto investigar una aplicación, esta debe estar incluida en una carpeta habilitada para aplicaciones.

Crear una investigación

Consola

Importante: La función Investigaciones está integrada en varios Google Cloud servicios y flujos de trabajo. Puede que tu experiencia al crear una investigación sea ligeramente diferente a la que se describe en este documento. Por ejemplo, algunos servicios pueden rellenar automáticamente información como la hora de inicio o el campo para describir el problema.

1. Para crear una investigación, haz clic en el botón Investigar asociado a tu punto de entrada. El punto de entrada habitual para crear una investigación es la página Investigaciones de Cloud Assist.

   Ir a Cloud Assist Investigations

2. (Opcional) Introduzca un nombre para la investigación.

   El nombre que elijas identificará esta investigación en tu historial de investigaciones. Si te saltas este paso, se generará automáticamente un nombre para la investigación.

3. Describe el problema que tienes.

   Puedes copiar y pegar el mensaje de error exacto que has recibido, usar el lenguaje natural para explicar el problema que estás teniendo o incluir ambas cosas.

4. Selecciona la hora de inicio del problema que estás investigando.

   Nota: Si la hora de inicio es precisa, se pueden establecer correlaciones basadas en el tiempo entre eventos que aparentemente no están relacionados y se da más importancia a los eventos que se producen cerca de la hora de inicio. Si no sabes a qué hora empieza, puedes realizar varias investigaciones simultáneamente con diferentes horas de inicio.

5. (Opcional) Selecciona la Hora de finalización del problema que estás investigando.

6. Si tu punto de entrada admite investigaciones de aplicaciones, usa el campo Aplicación para elegir una aplicación que quieras investigar.

   • En el caso de los puntos de entrada que no admiten investigaciones de aplicaciones, tu proyecto actual se muestra como Proyecto de destino y no se puede cambiar.

7. (Opcional) Haz clic en + Añadir recurso para seleccionar los recursos que se ven afectados por el problema que estás experimentando.

   Puedes añadir recursos mediante el selector de recursos o introduciéndolos manualmente. Cuando introduzca recursos manualmente, debe consultar la documentación de referencia del recurso para asegurarse de que utiliza el formato correcto.

   No puedes continuar con una investigación si incluyes alguno de los siguientes elementos:

   • Recursos que se encuentran en un proyecto o una aplicación que no están incluidos en el ámbito de la investigación.
   • Recursos que no son compatibles.
   • Recursos que no se reconocen.

8. Haz clic en Crear para iniciar la investigación.

La investigación puede tardar varios minutos en completarse. Para comprobar el estado de la investigación, haz clic en el botón Notificaciones ().

API

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

   {
   "title": "INVESTIGATION_NAME",
   "observations": {
     "user.project": {
       "id": "user.project",
       "observationType": "OBSERVATION_TYPE_STRUCTURED_INPUT",
       "observerType": "OBSERVER_TYPE_USER",
       "text": "PROJECT_NAME"
     },
     "user.input.text": {
       "id": "user.input.text",
       "observationType": "OBSERVATION_TYPE_TEXT_DESCRIPTION",
       "observerType": "OBSERVER_TYPE_USER",
       "timeIntervals": [
         {
           "startTime": "ISSUE_START_TIME"
         }
       ],
       "text": "ISSUE_DESCRIPTION",
       "relevantResources": [
         "AFFECTED_RESOURCE"
       ],
     },
   }
   

   Haz los cambios siguientes:

   • INVESTIGATION_NAME: introduce un nombre para la investigación. Por ejemplo, Missing Cloud Storage bucket.

   • PROJECT_NAME: Introduce el nombre del proyecto en el que se está creando la investigación. Por ejemplo, my-project.

   • ISSUE_START_TIME: introduce la fecha y la hora en las que empezó el problema que estás investigando. Por ejemplo, 2025-07-08T17:23:00Z.

   • ISSUE_DESCRIPTION: introduce una descripción del problema que estás experimentando. Puedes incluir el mensaje de error exacto que has recibido, usar lenguaje natural para explicar el problema que estás experimentando o incluir ambas cosas.

   • AFFECTED_RESOURCE: Introduce el nombre del recurso implicado en el problema que estás experimentando. Por ejemplo, //storage.googleapis.com/my-bucket. Para asegurarte de que usas el formato correcto de un recurso, debes consultar la documentación de referencia del recurso.

   Para ver una representación completa de un recurso de investigación, consulta la especificación del recurso.

2. Obtén un token de acceso:

   TOKEN=$(gcloud auth print-access-token)

3. Para crear la investigación, usa el método investigations.create:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $TOKEN" \
     -H 'Content-Type: application/json' \
     "https://geminicloudassist.googleapis.com/v1alpha/projects/PROJECT_NAME/locations/global/investigations"
   

   Haz los cambios siguientes:

   • JSON_FILE_NAME: introduce la ruta al archivo JSON que has creado anteriormente. Por ejemplo, Desktop/my-investigation.json.

   • PROJECT_NAME: introduce el mismo nombre de proyecto que incluiste en la observación user.project.

4. En la respuesta, copie el valor del parámetro revision.

5. Usa el método investigations.revisions.run para llevar a cabo la investigación:

   curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     "https://geminicloudassist.googleapis.com/v1alpha/projects/REVISION_RESOURCE:run"
   

   Sustituye REVISION_RESOURCE por el valor que has copiado del parámetro revision.

La investigación puede tardar varios minutos en completarse. Para comprobar el estado de la investigación, copie el valor del parámetro name que se devolvió en la respuesta investigations.revisions.run y úselo en el parámetro name de una solicitud operations.get.

Nota: Al usuario o a la cuenta de servicio que crea una investigación se le asigna el rol de gestión de identidades y accesos Propietario de la investigación (roles/geminicloudassist.investigationOwner) de esa investigación específica como parte del proceso de creación.

Revisar una investigación

Una vez que se haya completado la investigación, podrás ver sus detalles desde el punto de entrada donde la iniciaste o desde el historial de investigaciones de tu proyecto.

Una investigación contiene las siguientes secciones:

1. El problema

   En esta sección se incluye la información que se ha usado para generar los resultados de la investigación, como la descripción del problema, las marcas de tiempo y las listas de recursos relevantes. Hay tres tipos de listas de recursos que pueden estar asociadas a la investigación:

   • Recursos proporcionados por el usuario: recursos proporcionados por el usuario o obtenidos del error inicial.
   • Recursos descubiertos: recursos adicionales que ha tenido en cuenta Gemini al llevar a cabo la investigación.
   • Recursos relevantes: los recursos que Gemini considera relevantes para la hipótesis de la causa raíz, que siempre incluye los recursos proporcionados por el usuario.

2. Las observaciones

   Esta sección contiene las observaciones generadas por la investigación. Las observaciones se basan en las revisiones de los manuales de procedimientos, los registros, los mensajes de interrupción y las alertas. A partir de estas observaciones, Gemini genera hipótesis sobre la causa principal del problema que estás investigando.

3. Las hipótesis

   Esta sección contiene una o varias hipótesis basadas en los datos que se han recogido en la investigación y en las observaciones que se han hecho. Una hipótesis contiene una Descripción general de cuál podría ser el problema y Soluciones recomendadas, que son acciones que te ayudan a corregir el problema o que te proporcionan pasos adicionales para confirmar o refutar la hipótesis.

Puedes revisar la información que has introducido para la investigación con el botón Editar, que te permite volver a ejecutar la investigación con información actualizada. Cuando una investigación tiene varias ejecuciones asociadas, puedes consultar los resultados de las ejecuciones anteriores mediante el selector desplegable Revisión.

Siguientes pasos

• Más información sobre las investigaciones
• Ver y gestionar investigaciones