Administra conjuntos de contexto en Cloud SQL Studio

En este documento, se describe cómo crear conjuntos de información contextual en Cloud SQL para MySQL Studio con un archivo de conjunto de información contextual. Los nombres de los conjuntos de información contextual deben ser únicos dentro de una base de datos.

Antes de comenzar

Completa los siguientes requisitos previos antes de crear un agente.

Habilita los servicios obligatorios

• API de Data Analytics with Gemini
• API de Gemini for Google Cloud
• API de Knowledge Catalog

Prepara una instancia de Cloud SQL

• Asegúrate de tener acceso a una instancia de Cloud SQL existente o crea una nueva. Para obtener más información, consulta Crea instancias para Cloud SQL.
• Asegúrate de crear una base de datos en tu instancia en la que crearás las tablas. Para obtener más información, consulta Crea una base de datos en la instancia de Cloud SQL.

Roles y permisos requeridos

• Agrega un usuario o una cuenta de servicio de IAM a nivel de la instancia. Para obtener más información, consulta Agrega una vinculación de política de IAM a un usuario, una cuenta de servicio o un grupo.
• Otorga las funciones cloudsql.studioUser, cloudsql.instanceUser y geminidataanalytics.queryDataUser al usuario o la cuenta de servicio de IAM a nivel del proyecto. Para obtener más información, consulta Agrega una vinculación de política de IAM para un proyecto.
• Debes tener un usuario con privilegios que otorgue privilegios de base de datos a el usuario o la cuenta de servicio de IAM.
  
  GRANT SELECT PRIVILEGES ON * TO "IAM_USERNAME";.
  
  Para obtener más información, consulta Otorga privilegios de base de datos a un usuario o una cuenta de servicio de IAM individual.

Otorga permiso executesql a la instancia de Cloud SQL

gcloud config set project PROJECT_ID
gcloud components update
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API

• PROJECT_ID: Es el ID de tu Google Cloud proyecto.
• INSTANCE_ID: Es el ID de tu instancia de Cloud SQL.

Crea un conjunto de información contextual

Para crear un conjunto de información contextual, sigue estos pasos:

1. En la Google Cloud consola de, ve a la página de Cloud SQL.

   Ir a Cloud SQL

2. Elige una instancia de la lista.

3. En el menú de navegación, haz clic en Cloud SQL Studio.

4. Accede a Studio con la autenticación de IAM.

5. En el panel Explorador, junto a Conjuntos de información contextual, haz clic en Ver acciones.

6. Haz clic en Crear conjunto de información contextual.

7. En Nombre del conjunto de información contextual, proporciona un nombre único para el conjunto de información contextual. El nombre del conjunto de información contextual distingue mayúsculas de minúsculas y puede contener letras, números, guiones y guiones bajos.

8. Es opcional. En Descripción del conjunto de información contextual, agrega una descripción para tu conjunto de información contextual.

9. Haz clic en Crear.

Compila conjuntos de información contextual

Después de crear un conjunto de información contextual, sigue los pasos que se indican en Compila contextos con Gemini CLI para crear un archivo de conjunto de información contextual. Luego, puedes editar tu conjunto de información contextual para subir el archivo de conjunto de información contextual.

Edita un conjunto de información contextual

Para editar un conjunto de información contextual, sigue estos pasos:

1. En la Google Cloud consola de, ve a la página de Cloud SQL.

   Ir a Cloud SQL

2. Elige una instancia de la lista.

3. En el menú de navegación, haz clic en Cloud SQL Studio.

4. Accede a Studio con la autenticación de IAM.

5. En el panel Explorador, junto a Conjuntos de información contextual, haz clic en Ver acciones.

6. Haz clic en Editar conjunto de información contextual.

7. Es opcional. Edita la Descripción del conjunto de información contextual.

8. Haz clic en Explorar en la sección Subir archivo de conjunto de información contextual y selecciona el archivo de conjunto de información contextual.

9. Haz clic en Guardar.

Borra un conjunto de información contextual

Para borrar un conjunto de información contextual, sigue estos pasos:

1. En la Google Cloud consola de, ve a la página de Cloud SQL.

   Ir a Cloud SQL

2. Elige una instancia de la lista.

3. En el menú de navegación, haz clic en Cloud SQL Studio.

4. Accede a Studio con la autenticación de IAM.

5. En el panel Explorador, junto a Conjuntos de información contextual, haz clic en Ver acciones.

6. Haz clic en Borrar conjunto de información contextual.

7. En el cuadro de diálogo de confirmación Borrar conjunto de información contextual, ingresa el nombre del conjunto de información contextual.

8. Haz clic en Confirmar para borrar el conjunto de información contextual.

¿Qué sigue?

• Obtén más información sobre los conjuntos de información contextual.
• Obtén información para probar un conjunto de información contextual.
• Obtén información para compilar contextos con Gemini CLI.