Administra conjuntos de contexto en Spanner 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.

Nota sobre la interfaz de PostgreSQL: Los ejemplos de este tema están destinados a bases de datos con dialecto de GoogleSQL. Esta función no admite la interfaz de PostgreSQL.

En este documento, se describe cómo crear conjuntos de información contextual en Spanner 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.

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

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 for Google Cloud
• API de Knowledge Catalog

Prepara una instancia de Spanner

• Asegúrate de que haya una instancia de Spanner disponible. Para obtener más información, consulta Crea una instancia.
• 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 Spanner.

En este instructivo, se requiere que tengas una base de datos en tu instancia de Spanner. Para obtener más información, consulta Crea una base de datos.

Roles y permisos requeridos

• Agrega un usuario o una cuenta de servicio de IAM al clúster. Para obtener más información, consulta Aplica roles de IAM.
• Otorga los roles spanner.databaseReader y geminidataanalytics.queryDataUser al usuario 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.
• Para crear, subir y administrar conjuntos de información contextual, otorga el rol 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 Permisos de conjuntos de información contextual.
• Otorga roles y permisos al usuario de IAM a nivel del proyecto para las bases de datos requeridas.

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 Spanner.

   Ir a Spanner

2. Selecciona una instancia de la lista y, luego, selecciona una base de datos.

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

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

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

6. 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.

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

8. Haz clic en Crear.

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

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 el 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 Spanner.

   Ir a Spanner

2. Selecciona una instancia de la lista y, luego, selecciona una base de datos.

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

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

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

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

7. 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.

8. 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 Spanner.

   Ir a Spanner

2. Selecciona una instancia de la lista y, luego, selecciona una base de datos.

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

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

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

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

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

Nota: Antes de borrar una base de datos, debes borrar todos los conjuntos de información contextual asociados con esa base de datos.

¿Qué sigue?

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