Los conjuntos de contexto te permiten fundamentar agentes de IA con contenedores limitados de información semántica y referencias de recursos de datos. Para obtener más información sobre cómo funcionan estos contenedores, consulta Descripción general de los conjuntos de contexto.
Debes configurar un conjunto de contexto antes de ejecutar una tarea de enriquecimiento. Las tareas de enriquecimiento son agentes autónomos que analizan de forma continua los esquemas y la documentación de tu conjunto de datos para generar metadatos propuestos para tus recursos de datos.
Puedes configurar un conjunto de contexto como un contenedor independiente o como parte de la configuración de un trabajo de enriquecimiento. Para obtener más información sobre cómo crear un conjunto de contexto durante la configuración de una tarea, consulta Crea tareas de enriquecimiento.
Antes de comenzar
Antes de administrar conjuntos de contexto, asegúrate de tener los roles de IAM necesarios.
Roles obligatorios
Para obtener los permisos que necesitas para administrar conjuntos de contexto, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:
- Para crear conjuntos de contexto: Administrador de Dataplex Catalog (
roles/dataplex.catalogAdmin) o Propietario del grupo de entradas de Dataplex (roles/dataplex.entryGroupOwner). Estos roles contienen el permisodataplex.entryGroups.setIamPolicy, que es necesario para otorgarte automáticamente permisos de propietario durante la creación del conjunto de contexto. - Para editar o borrar conjuntos de contexto: Administrador del catálogo de Dataplex
(
roles/dataplex.catalogAdmin) o Editor del catálogo de Dataplex (roles/dataplex.catalogEditor).
Crea un conjunto de información contextual
Para crear un conjunto de contexto vacío en el que se almacenen tus metadatos enriquecidos, haz lo siguiente:
Knowledge Studio
En la consola de Google Cloud , ve a la página Knowledge Studio.
En el panel de navegación izquierdo, selecciona Conjuntos de contexto.
En la página Conjuntos de contexto, haz clic en Crear.
En el panel Crear conjunto de contexto, ingresa un nombre en el campo Nombre visible y un ID en el campo ID del conjunto de contexto.
Opcional: Ingresa una Descripción, selecciona una Ubicación y agrega Etiquetas.
Haz clic en Guardar.
Tipos de metadatos
En la consola de Google Cloud , ve a la página Tipos de metadatos.
Haz clic en Grupos de entrada > Conjunto de contexto.
En la página Tipos de metadatos, haz clic en Crear.
En el panel Crear conjunto de contexto, ingresa un nombre en el campo Nombre visible y un ID en el campo ID del conjunto de contexto.
Opcional: Ingresa una Descripción, selecciona una Ubicación y agrega Etiquetas.
Haz clic en Guardar.
Después de crear el conjunto de contexto, puedes seleccionarlo como el destino de tus tareas de enriquecimiento. La ejecución de enriquecimiento propaga este contenedor con los conceptos de metadatos, las asociaciones semánticas y las fórmulas que propone la IA.
Para obtener más información sobre las tareas de enriquecimiento, consulta Acerca de las tareas de enriquecimiento.
Ver conjuntos de contextos
Para ver los conjuntos de contexto existentes, haz lo siguiente:
Knowledge Studio
En la consola de Google Cloud , ve a la página Knowledge Studio.
En el panel de navegación izquierdo, selecciona Conjuntos de contexto.
Para ver los detalles de un conjunto de contexto específico, haz clic en su nombre en la lista.
Tipos de metadatos
En la consola de Google Cloud , ve a la página Tipos de metadatos.
Haz clic en Grupos de entrada > Conjunto de contexto.
Para ver los detalles de un conjunto de contexto específico, haz clic en su nombre en la lista.
En la página de detalles, se muestran las propiedades del conjunto de contextos, como su descripción, ubicación y el ID del proyecto. También contiene una sección Entradas de muestra en la que se muestra una vista previa de las entradas de metadatos enriquecidos almacenadas en el conjunto de contexto y se proporciona un botón para ver todas las entradas relacionadas en la búsqueda.
Cómo editar un conjunto de contextos
Con la consola de Google Cloud , puedes editar las propiedades del contenedor de un conjunto de contextos, que incluyen su Nombre visible, Descripción y Etiquetas.
Para actualizar el contenido de los metadatos enriquecidos dentro de un conjunto de contexto, debes ejecutar una tarea de enriquecimiento orientada a ese conjunto y aprobar las propuestas de cambio generadas. Para obtener más información sobre cómo aprobar propuestas de cambios, consulta Administra ejecuciones de enriquecimiento.
Para editar las propiedades de un conjunto de contextos, haz lo siguiente:
Knowledge Studio
En la consola de Google Cloud , ve a la página Knowledge Studio.
En el panel de navegación izquierdo, selecciona Conjuntos de contexto.
Haz clic en el nombre del conjunto de contextos que deseas editar.
En la página de detalles, haz clic en Editar.
Modifica los campos editables (Nombre visible, Descripción o Etiquetas) y, luego, haz clic en Guardar.
Tipos de metadatos
En la consola de Google Cloud , ve a la página Tipos de metadatos.
Haz clic en Grupos de entrada > Conjunto de contexto.
En la página Tipos de metadatos, haz clic en el nombre del conjunto de contexto que deseas editar.
En la página de detalles, haz clic en Editar.
Modifica los campos editables (Nombre visible, Descripción o Etiquetas) y, luego, haz clic en Guardar.
Borrar un conjunto de contextos
Si borras un conjunto de contexto, se quitan sus asociaciones semánticas del grafo de contexto de datos. Si borras un conjunto de contexto mientras se ejecuta un enriquecimiento, la ejecución no puede guardar los metadatos propuestos cuando se completa porque el destino ya no está disponible. Las ejecuciones posteriores de la tarea de enriquecimiento también fallarán hasta que actualices la tarea para que genere un conjunto de contexto válido.
Para borrar un conjunto de contextos, haz lo siguiente:
Knowledge Studio
En la consola de Google Cloud , ve a la página Knowledge Studio.
En el panel de navegación izquierdo, selecciona Conjuntos de contexto.
En la lista, haz clic en el nombre del conjunto de contexto que deseas borrar.
En la página de detalles, haz clic en Borrar.
Confirma la eliminación.
Tipos de metadatos
En la consola de Google Cloud , ve a la página Tipos de metadatos.
Haz clic en Grupos de entrada > Conjunto de contexto.
En la lista, haz clic en el nombre del conjunto de contexto que deseas borrar.
En la página de detalles, haz clic en Borrar.
Confirma la eliminación.
Limitaciones
Para obtener información sobre las limitaciones que se aplican durante la versión preliminar, consulta Límites de la versión preliminar.
¿Qué sigue?
Para obtener más información, consulta lo siguiente:
- Configura los requisitos previos para las tareas de enriquecimiento
- Crea tareas de enriquecimiento
- Administra las ejecuciones de enriquecimiento