Administra conjuntos de contexto en Cloud SQL Studio

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio y las Condiciones Adicionales para Productos de IA Generativa en Versión Preliminar. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En este documento, se describe cómo crear conjuntos de contexto en Cloud SQL para PostgreSQL Studio con un archivo de conjunto de contexto. Los nombres de los conjuntos de contextos deben ser únicos dentro de un proyecto.

Para obtener más información sobre los conjuntos de contexto, consulta Descripción general de los conjuntos de contexto.

Antes de comenzar

Completa los siguientes requisitos previos antes de crear un agente.

Habilita los servicios obligatorios

Habilita los siguientes servicios para tu proyecto:

• API de Data Analytics with Gemini
• API de Gemini para 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.

En este instructivo, se requiere que tengas una base de datos en tu instancia de Cloud SQL. 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 la instancia. Para obtener más información, consulta Administra usuarios con la autenticación de base de datos de IAM para Cloud SQL.
• Otorga los roles cloudsql.studioUser, cloudsql.instanceUser y geminidataanalytics.queryDataUser al usuario de IAM a nivel de proyecto. Para obtener más información, consulta Agrega una vinculación de política de IAM para un proyecto.
• Para crear, subir y administrar conjuntos de contexto, otorga el rol de editor de Dataplex Catalog (roles/dataplex.catalogEditor) o administrador de Dataplex Catalog (roles/dataplex.catalogAdmin) al usuario de IAM a nivel del proyecto. Para obtener más información, consulta El contexto establece permisos.
• También debes otorgar privilegios de base de datos de solo lectura a un usuario o una cuenta de servicio de IAM. Para ello, accede como un usuario con privilegios de superusuario, como el usuario postgres.
  
  GRANT SELECT ON ALL TABLES IN SCHEMA public TO USER_NAME;
  
  Reemplaza USER_NAME por la dirección de correo electrónico del usuario. Debes usar comillas alrededor del correo electrónico porque contiene caracteres especiales (@ y .).
  
  Para obtener más información, consulta Otorga privilegios de base de datos a un usuario o una cuenta de servicio de IAM individuales.

Otorga el permiso executesql a la instancia de Cloud SQL

Para otorgar el permiso executesql a la instancia de Cloud SQL y habilitar las APIs de datos de Cloud SQL, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

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

Para realizar los pasos de este instructivo, accede a Google Cloud y, luego, autentícate en la base de datos con la autenticación de IAM.

Crear un conjunto de contextos

Para crear un conjunto de contextos, sigue estos pasos:

1. En la consola de Google Cloud , 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 contexto, haz clic en Ver acciones.

6. Haz clic en Crear conjunto de contexto.

7. En Nombre del conjunto de contextos, proporciona un nombre único para el conjunto de contextos. El nombre del conjunto de contexto distingue mayúsculas de minúsculas y puede contener letras, números, guiones y guiones bajos. Los nombres deben tener entre 4 y 30 caracteres.

   El ID del conjunto de información contextual se deriva del nombre del conjunto de información contextual, pero no es necesariamente idéntico. Para el ID del conjunto de contexto, el nombre del conjunto de contexto se convierte en minúsculas y los caracteres no alfanuméricos se reemplazan por el carácter -. Por ejemplo, el nombre del conjunto de contextos querydata_e2e_test tiene el ID de conjunto de contextos querydata-e2e-test.

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

9. Es opcional. Para subir un archivo de conjunto de contexto, haz clic en Explorar en la sección Subir archivo de conjunto de contexto y selecciona el archivo de conjunto de contexto.

10. Haz clic en Crear.

Nota: La creación del primer conjunto de contextos en un proyecto puede tardar varios minutos.

Crea conjuntos de información contextual

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

Cómo editar un conjunto de información contextual

Para editar un conjunto de contextos, sigue estos pasos:

1. En la consola de Google Cloud , 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. Haz clic en Ver acciones junto al conjunto de contextos que deseas editar.

6. Haz clic en Editar conjunto de contextos.

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 contextos y selecciona el archivo de conjunto de contextos.

9. Haz clic en Guardar.

Borrar un conjunto de contextos

Para borrar un conjunto de contextos, sigue estos pasos:

1. En la consola de Google Cloud , 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. Haz clic en Ver acciones junto al conjunto de contextos que quieres borrar.

6. Haz clic en Borrar conjunto de contextos.

7. En el cuadro de diálogo de confirmación Borrar conjunto de contextos, ingresa el ID del conjunto de contextos.

8. Haz clic en Confirmar para borrar el conjunto de contextos.

Nota: Antes de borrar una base de datos, debes borrar todos los conjuntos de contexto asociados con ella.

¿Qué sigue?

• Obtén más información sobre los conjuntos de contexto.
• Obtén más información para probar un conjunto de contextos.
• Aprende a crear contextos con Gemini CLI.