Puedes actualizar los datos estructurados y los datos no estructurados con metadatos que admiten un esquema.
Puedes actualizar el esquema en la consola de Google Cloud o con el método de la API
schemas.patch.
Para actualizar el esquema, puedes agregar campos nuevos, cambiar las anotaciones indexables, que se pueden buscar y
recuperables de un campo, o marcar un campo como una propiedad clave, como
title, uri y description.
Actualiza tu esquema
Puedes actualizar tu esquema en la consola de Google Cloud o con la API.
Console
Para actualizar un esquema en la consola de Google Cloud , sigue estos pasos:
Revisa la sección Requisitos y limitaciones para verificar que la actualización del esquema sea válida.
Si actualizas las anotaciones de campo (configuras los campos como indexables, recuperables, con facetas dinámicas, con capacidad de búsqueda o con capacidad de completado), revisa Establece la configuración de los campos para conocer las limitaciones y los requisitos de cada tipo de anotación.
Verifica que hayas completado la ingesta de datos. De lo contrario, es posible que el esquema aún no esté disponible para editarlo.
En la consola de Google Cloud , ve a la página Gemini Enterprise.
En el menú de navegación, haz clic en Almacenes de datos.
En la columna Nombre, haz clic en el almacén de datos con el esquema que deseas actualizar.
Haz clic en la pestaña Esquema para ver el esquema de tus datos.
Esta pestaña puede estar vacía si es la primera vez que editas los campos.
Haz clic en el botón Editar.
Actualiza tu esquema:
Asigna propiedades clave: En la columna Propiedades clave de tu esquema, selecciona una propiedad clave para asignar un campo. Por ejemplo, si un campo llamado
detailssiempre contiene la descripción de un documento, asigna ese campo a la propiedad clave Descripción.Actualiza la cantidad de dimensiones (avanzado): Puedes actualizar este parámetro de configuración si usas embeddings de vectores personalizados con Gemini Enterprise. Consulta Usa embeddings personalizados en la documentación de Agent Search.
Actualiza las anotaciones de los campos: Para actualizar las anotaciones de un campo, selecciona o anula la selección de la configuración de anotaciones de un campo. Las anotaciones disponibles son Recuperable, Indexable, Faceta dinámica, Se puede buscar y Completable. Algunos parámetros de configuración de campos tienen limitaciones. Consulta Establece la configuración de los campos para obtener descripciones y requisitos de cada tipo de anotación.
Agrega un campo nuevo: Agregar campos nuevos a tu esquema antes de importar documentos nuevos con esos campos puede reducir el tiempo que tarda Gemini Enterprise en volver a indexar tus datos después de la importación.
Haz clic en Agregar campos nuevos para expandir esa sección.
Haz clic en add_box Agregar nodo y especifica la configuración del campo nuevo.
Para indicar un array, establece Array en Sí. Por ejemplo, para agregar un array de cadenas, establece type en
stringy Array enYes.
Haz clic en Guardar para aplicar los cambios en el esquema.
Si cambias el esquema, se activará la reindexación. En el caso de los almacenes de datos grandes, la reindexación puede tardar horas.
REST
Para usar la API y actualizar tu esquema, sigue estos pasos:
Revisa las secciones Requisitos y limitaciones y Ejemplos de limitaciones (solo REST) para verificar que los cambios en el esquema sean válidos.
Para actualizar el esquema de los almacenes de datos con datos no estructurados con metadatos, ve al paso 5 para llamar al método
schema.patch.Si actualizas las anotaciones de campo (configuras los campos como indexables, recuperables, categorizables en facetas dinámicas o con capacidad de búsqueda), revisa Establece la configuración de los campos para conocer las limitaciones y los requisitos de cada tipo de anotación.
Si editas un esquema detectado automáticamente, asegúrate de haber completado la transferencia de datos. De lo contrario, es posible que el esquema aún no esté disponible para editarlo.
Busca el ID de tu almacén de datos. Si ya tienes el ID del almacén de datos, continúa con el siguiente paso.
En la consola de Google Cloud , ve a la página Gemini Enterprise y, en el menú de navegación, haz clic en Almacenes de datos.
Haz clic en el nombre de tu almacén de datos.
En la página Datos de tu almacén de datos, obtén el ID del almacén de datos.
Usa el método de la API schemas.patch para proporcionar tu esquema JSON nuevo como un objeto JSON.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/schemas/default_schema" \ -d '{ "structSchema": JSON_SCHEMA_OBJECT }'Reemplaza lo siguiente:
PROJECT_ID: el ID de tu proyecto.DATA_STORE_ID: Es el ID del almacén de datos.JSON_SCHEMA_OBJECT: Es tu esquema JSON nuevo como un objeto JSON. Por ejemplo:{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "string", "keyPropertyMapping": "title" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } }, "uri": { "type": "string", "keyPropertyMapping": "uri" } } }
Opcional: Revisa el esquema siguiendo el procedimiento Visualiza una definición de esquema.
C#
Antes de probar este ejemplo, sigue las instrucciones de configuración para C# que encontrarás en la guía de inicio rápido de Gemini Enterprise sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Gemini Enterprise para C#.
Para autenticarte en Gemini Enterprise, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go que encontrarás en la guía de inicio rápido de Gemini Enterprise sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Gemini Enterprise para Go.
Para autenticarte en Gemini Enterprise, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que encontrarás en la guía de inicio rápido de Gemini Enterprise sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Gemini Enterprise para Java.
Para autenticarte en Gemini Enterprise, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración para Python que encontrarás en la guía de inicio rápido de Gemini Enterprise sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Gemini Enterprise para Python.
Para autenticarte en Gemini Enterprise, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Antes de probar este ejemplo, sigue las instrucciones de configuración para Ruby que encontrarás en la guía de inicio rápido de Gemini Enterprise sobre las bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Gemini Enterprise para Ruby.
Para autenticarte en Gemini Enterprise, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Requisitos y limitaciones
Cuando actualices un esquema, asegúrate de que el nuevo sea retrocompatible con el que estás actualizando. Para actualizar un esquema con uno nuevo que no sea retrocompatible, debes borrar todos los documentos del almacén de datos, borrar el esquema y crear uno nuevo.
La actualización de un esquema activa la reindexación de todos los documentos. Volver a indexar un almacén de datos grande puede tardar horas o días.
Las actualizaciones de esquemas no admiten lo siguiente:
- Cambiar el tipo de campo. Una actualización de esquema no admite cambiar el tipo
de un campo, con una excepción: un campo de tipo
integerse puede cambiar anumber. Cualquier otro cambio, comointegerastring, un solo campo a un array o una profundidad de anidamiento diferente para un array existente, falla con el errorSchema update cannot alter the field type. Field type mismatch for field "FIELD_NAME". - Quitar un campo Una vez que se define un campo, no se puede quitar. Se pueden
seguir agregando campos nuevos, pero no se puede quitar un campo existente. Una
solicitud que omite un campo existente falla con el error
Schema update doesn't support removing fields. Fields "FIELD_NAME" cannot be removed. - Cambiar otras asignaciones de propiedades clave Puedes agregar o quitar las asignaciones de propiedades de clave
title,description,uri,create_timeyupdate_time. No puedes mover una asignación de propiedad clave de un campo a otro, y no puedes agregar ninguna otra asignación de propiedad clave a un esquema mientras el almacén de datos contenga documentos.
Ejemplos de limitaciones (solo REST)
En esta sección, se muestran ejemplos de tipos de actualizaciones de esquemas válidos y no válidos. En estos ejemplos, se usa el siguiente esquema JSON de ejemplo:
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"title": {
"type": "string"
},
"description": {
"type": "string",
"keyPropertyMapping": "description"
},
"categories": {
"type": "array",
"items": {
"type": "string",
"keyPropertyMapping": "category"
}
}
}
}
Ejemplos de actualizaciones admitidas
Se admiten las siguientes actualizaciones del esquema de ejemplo.
Agrega un campo. En este ejemplo, se agregó el campo
properties.urial esquema.{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "string" }, "description": { "type": "string", "keyPropertyMapping": "description" }, "uri": { // Added field. This is supported. "type": "string", "keyPropertyMapping": "uri" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } } } }Agrega o quita anotaciones de propiedades clave para
title,descriptionouri. En este ejemplo, se agregókeyPropertyMappingal campotitle.{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "string", "keyPropertyMapping": "title" // Added "keyPropertyMapping". This is supported. }, "description": { "type": "string", "keyPropertyMapping": "description" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } } } }
Ejemplos de actualizaciones de esquemas no válidas
No se admiten las siguientes actualizaciones del esquema de ejemplo.
Cambiar el tipo de campo. En este ejemplo, el tipo del campo
titlese cambió de cadena a número. Esta opción no es compatible.{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "number" // Changed from string. Not allowed. }, "description": { "type": "string", "keyPropertyMapping": "description" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } } } }Quitar un campo En este ejemplo, se quitó el campo
title. Esta opción no es compatible.{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { // "title" is removed. Not allowed. "description": { "type": "string", "keyPropertyMapping": "description" }, "uri": { "type": "string", "keyPropertyMapping": "uri" }, "categories": { "type": "array", "items": { "type": "string", "keyPropertyMapping": "category" } } } }
¿Qué sigue?
- Consulta la definición del esquema para los datos estructurados
- Cómo borrar un esquema para datos estructurados
- Obtén una vista previa de los resultados de la búsqueda