En este documento, se describe cómo crear conjuntos de información contextual en AlloyDB para PostgreSQL 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:Prepara un clúster, una instancia y una base de datos de AlloyDB para PostgreSQL
Asegúrate de tener acceso a un clúster y una instancia de AlloyDB existentes o crea uno nuevo.En este instructivo, se requiere que tengas una base de datos en tu instancia de AlloyDB. 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 Identity and Access Management (IAM) al clúster a nivel de la base de datos. Para obtener más información, consulta Administra usuarios de la base de datos.
- Otorga las funciones
alloydb.databaseUser,serviceusage.serviceUsageConsumerygeminidataanalytics.queryDataUseral 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.
Otorga permiso executesql a la instancia de AlloyDB para PostgreSQL
Para otorgar el permiso executesql a la instancia de AlloyDB para PostgreSQL y establecer el parámetro de configuración de la instancia data_api_access en el valor ALLOW_DATA_API, usa el siguiente comando curl :
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
-d '{
"dataApiAccess": "ENABLED",
}'
PROJECT_ID: Es el ID de tu Google Cloud proyecto.LOCATION: Es la región en la que se encuentra tu clúster de AlloyDB.CLUSTER_ID: Es el ID de tu clúster de AlloyDB.INSTANCE_ID: Es el ID de tu instancia de AlloyDB.
Crea un conjunto de información contextual
Para crear un conjunto de información contextual, realiza los siguientes pasos:
En la Google Cloud consola de, ve a la página de AlloyDB.
Selecciona un clúster de la lista.
En el menú de navegación, haz clic en AlloyDB Studio.
Accede a Studio con la autenticación de IAM.
En el panel Explorador, junto a Conjuntos de información contextual, haz clic en Ver acciones.
Haz clic en Crear conjunto de información contextual.
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.
Es opcional. En Descripción del conjunto de información contextual, agrega una descripción para tu conjunto de información contextual.
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 la CLI de Gemini 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, realiza los siguientes pasos:
En la Google Cloud consola de, ve a la página de AlloyDB.
Selecciona un clúster de la lista.
En el menú de navegación, haz clic en AlloyDB Studio.
Accede a Studio con la autenticación de Identity and Access Management.
En el panel Explorador, junto a Conjuntos de información contextual, haz clic en Ver acciones.
Haz clic en Editar conjunto de información contextual.
Opcional: Edita la Descripción del conjunto de información contextual.
Haz clic en Examinar en la sección Subir archivo de conjunto de información contextual y selecciona el archivo de conjunto de información contextual.
Haz clic en Guardar.
Borra un conjunto de información contextual
Para borrar un conjunto de información contextual, realiza los siguientes pasos:
En la Google Cloud consola de, ve a la página de AlloyDB.
Selecciona un clúster de la lista.
En el menú de navegación, haz clic en AlloyDB Studio.
Accede a Studio con la autenticación de Identity and Access Management.
En el panel Explorador, junto a Conjuntos de información contextual, haz clic en Ver acciones.
Haz clic en Borrar conjunto de información contextual.
En el cuadro de diálogo de confirmación Borrar conjunto de información contextual, ingresa el nombre del conjunto de información contextual.
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 la CLI de Gemini.