En este documento, se describe cómo crear conjuntos de contexto en Spanner Studio con un archivo de conjunto de contexto. Los nombres de los conjuntos de contexto deben ser únicos dentro de una base de datos.
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: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 Cómo aplicar roles de IAM.
- Otorga los roles
spanner.databaseReaderygeminidataanalytics.queryDataUseral usuario de IAM a nivel del proyecto. Para obtener más información, consulta Cómo agregar 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. - 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 contexto, sigue estos pasos:
En la consola de Google Cloud , ve a la página de Spanner.
Selecciona una instancia de la lista y, luego, selecciona una base de datos.
En el menú de navegación, haz clic en Spanner Studio.
En el panel Explorador, junto a Conjuntos de contexto, haz clic en Ver acciones.
Haz clic en Crear conjunto de contexto.
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.
Es opcional. En Context set description, agrega una descripción para tu conjunto de contexto.
Haz clic en Crear.
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 contexto, sigue estos pasos:
En la consola de Google Cloud , ve a la página de Spanner.
Selecciona una instancia de la lista y, luego, selecciona una base de datos.
En el menú de navegación, haz clic en Spanner Studio.
En el panel Explorador, junto a Conjuntos de contexto, haz clic en Ver acciones.
Haz clic en Editar conjunto de contexto.
Es opcional. Edita la Descripción del conjunto de información contextual.
Haz clic en Explorar en la sección Subir archivo de conjunto de contexto y selecciona el archivo de conjunto de contexto.
Haz clic en Guardar.
Borra un conjunto de contextos
Para borrar un conjunto de contextos, sigue estos pasos:
En la consola de Google Cloud , ve a la página de Spanner.
Selecciona una instancia de la lista y, luego, selecciona una base de datos.
En el menú de navegación, haz clic en Spanner Studio.
En el panel Explorador, junto a Conjuntos de contexto, haz clic en Ver acciones.
Haz clic en Borrar el conjunto de contextos.
En el diálogo de confirmación Borrar conjunto de contexto, ingresa el nombre del conjunto de contexto.
Haz clic en Confirmar para borrar el conjunto de contexto.
¿Qué sigue?
- Obtén más información sobre los conjuntos de contexto.
- Obtén más información para probar un conjunto de contexto.
- Aprende a crear contextos con Gemini CLI.