Administra conjuntos de información contextual

Los conjuntos de contexto te permiten organizar la información semántica y las referencias de recursos de datos en contenedores limitados que fundamentan a los agentes de IA. En Knowledge Studio, puedes crear, ver, actualizar y borrar conjuntos de contexto, y configurar el control de acceso para cada contenedor.

Debes configurar un conjunto de contexto antes de ejecutar una tarea de enriquecimiento para generar propuestas de metadatos. Puedes crear un conjunto de contexto como un contenedor independiente o durante la configuración de la tarea de enriquecimiento. Para obtener más información, consulta Descripción general de los conjuntos de contexto y Crea tareas de enriquecimiento.

Antes de comenzar

Antes de administrar los conjuntos de contexto, asegúrate de tener los roles de Identity and Access Management (IAM) necesarios.

Roles obligatorios

Para obtener los permisos que necesitas para crear y administrar conjuntos de contexto y sus entradas, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto o conjunto de contexto:

  • Para crear conjuntos de contexto en un proyecto: Creador de contenido de Dataplex (roles/dataplex.contentCreator) o Administrador del catálogo de Dataplex (roles/dataplex.catalogAdmin)
  • Para descubrir conjuntos de contexto sin leer sus entradas: Visualizador de contenido de Dataplex (roles/dataplex.contentViewer)
  • Para ver entradas y proponer cambios en un conjunto de contexto: Usuario de contenido de Dataplex (roles/dataplex.contentUser)
  • Para crear, actualizar, borrar y vincular entradas en un conjunto de contexto: Editor de contenido de Dataplex (roles/dataplex.contentEditor)
  • Para administrar los permisos de IAM en un conjunto de contexto o borrarlo: Administrador de contenido de Dataplex (roles/dataplex.contentAdmin)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para crear y administrar conjuntos de contexto y sus entradas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear y administrar conjuntos de contexto y sus entradas:

  • Crea conjuntos de información contextual: dataplex.entryGroups.createContextSet
  • Enumera los conjuntos de contexto: dataplex.entryGroups.list
  • Consulta los detalles del conjunto de contexto: dataplex.entryGroups.getContextSet
  • Actualiza los conjuntos de contextos: dataplex.entryGroups.updateContextSet
  • Borrar conjuntos de contextos: dataplex.entryGroups.deleteContextSet
  • Propón cambios en los conjuntos de información contextual: dataplex.entryGroups.requestContextChanges
  • Administra las políticas de IAM de configuración de contexto: dataplex.entryGroups.getIamPolicy, dataplex.entryGroups.setIamPolicy
  • Crea, visualiza, enumera, actualiza y borra entradas en un conjunto de información contextual: dataplex.entries.createContext, dataplex.entries.getContext, dataplex.entries.listContext, dataplex.entries.updateContext, dataplex.entries.deleteContext
  • Vincula y desvincula recursos del catálogo en las entradas del conjunto de contexto: dataplex.entryLinks.create, dataplex.entryLinks.delete, dataplex.entries.link, dataplex.entryGroups.useReferenceEntryLink

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Cuando creas un conjunto de contexto, Knowledge Catalog te otorga automáticamente el rol de administrador de contenido de Dataplex (roles/dataplex.contentAdmin) en ese conjunto de contexto.

Crear un conjunto de contextos

Para crear un conjunto de contexto que almacene tus metadatos seleccionados o enriquecidos, sigue estos pasos:

Knowledge Studio

  1. En la consola de Google Cloud , ve a la página Knowledge Studio.

    Ir a Knowledge Studio

  2. En el panel de navegación, selecciona Conjuntos de contexto.

  3. En la página Conjuntos de contexto, haz clic en Crear conjunto de contexto.

  4. En el panel Crear conjunto de información contextual, ingresa un nombre descriptivo en el campo Nombre visible y un identificador único en el campo ID del conjunto de información contextual (o conserva el ID generado de forma automática). El ID del conjunto de contexto se convierte en el ID del recurso del grupo de entradas en la API y no se puede cambiar después de la creación.

  5. En el menú Región, selecciona una ubicación de Google Cloud para el conjunto de contexto:

    • Regional (por ejemplo, us-central1): Se recomienda cuando todos los recursos enriquecidos residen en una sola región.
    • Multirregión (por ejemplo, us o eu): Permite que el conjunto de contexto abarque recursos ubicados en varias regiones individuales dentro de ese límite geográfico.
    • Global (global): Permite que el conjunto de contexto haga referencia a recursos en cualquier región.

  6. Opcional: Ingresa una Descripción que resuma el dominio empresarial y el propósito del conjunto de contextos, y haz clic en Agregar etiqueta para adjuntar etiquetas de par clave-valor.

  7. Haz clic en Crear.

Tipos de metadatos

  1. En la consola de Google Cloud , ve a la página Tipos de metadatos.

    Ir a Tipos de metadatos

  2. Haz clic en Grupos de entrada > Conjunto de contexto.

  3. En la página Tipos de metadatos, haz clic en Crear.

  4. En el panel Crear conjunto de información contextual, ingresa un nombre descriptivo en el campo Nombre visible y un identificador único en el campo ID del conjunto de información contextual (o conserva el ID generado de forma automática). El ID del conjunto de contexto se convierte en el ID del recurso del grupo de entradas en la API y no se puede cambiar después de la creación.

  5. En el menú Región, selecciona una ubicación de Google Cloud para el conjunto de contexto:

    • Regional (por ejemplo, us-central1): Se recomienda cuando todos los recursos enriquecidos residen en una sola región.
    • Multirregión (por ejemplo, us o eu): Permite que el conjunto de contexto abarque recursos ubicados en varias regiones individuales dentro de ese límite geográfico.
    • Global (global): Permite que el conjunto de contexto haga referencia a recursos en cualquier región.

  6. Opcional: Ingresa una Descripción que resuma el dominio empresarial y el propósito del conjunto de contextos, y haz clic en Agregar etiqueta para adjuntar etiquetas de par clave-valor.

  7. Haz clic en Crear.

Después de crear el conjunto de contexto, puedes seleccionarlo como el destino de una tarea de enriquecimiento. La ejecución de enriquecimiento propaga el contenedor con documentos de metadatos, conceptos y entradas de recursos de datos propuestos. Para obtener más información, consulta Acerca de las tareas de enriquecimiento.

Cómo ver los conjuntos de contextos

Para ver los conjuntos de contexto existentes, sigue estos pasos:

Knowledge Studio

  1. En la consola de Google Cloud , ve a la página Knowledge Studio.

    Ir a Knowledge Studio

  2. En el panel de navegación, selecciona Conjuntos de contexto para ver los conjuntos de contexto en el proyecto seleccionado.

  3. Para ver los detalles de un conjunto de contextos específico, haz clic en su nombre en la lista.

Tipos de metadatos

  1. En la consola de Google Cloud , ve a la página Tipos de metadatos.

    Ir a Tipos de metadatos

  2. Haz clic en Grupos de entrada > Conjunto de contexto.

  3. Opcional: Activa el botón de activación Mostrar de todos los proyectos para explorar los conjuntos de contextos que tienes permiso para ver en todos los proyectos deGoogle Cloud .

  4. Para ver los detalles de un conjunto de contextos específico, haz clic en su nombre en la lista.

La página de detalles del conjunto de contexto incluye las siguientes secciones y controles:

  • Metadatos del contenedor: Muestra la descripción, la ubicación, el ID del proyecto, las marcas de tiempo de creación y modificación, y las etiquetas del conjunto de contexto.
  • Barra de acciones superior: Proporciona botones para administrar el conjunto de contextos (Editar, Borrar y Permisos).
  • Tabla de entradas: Enumera las entradas almacenadas en el conjunto de contexto, incluido el Nombre, la Descripción, el Tipo de entrada, la Fecha de creación y los Recursos vinculados de cada entrada.

Cómo editar un conjunto de información contextual

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 las entradas de metadatos dentro de un conjunto de contexto, ejecuta una tarea de enriquecimiento orientada a ese conjunto de contexto y aprueba las propuestas de cambio generadas. Para obtener más información sobre cómo aprobar propuestas de cambios, consulta Evalúa y aprueba propuestas de enriquecimiento.

Para editar las propiedades de un conjunto de contextos, sigue estos pasos:

Knowledge Studio

  1. En la consola de Google Cloud , ve a la página Knowledge Studio.

    Ir a Knowledge Studio

  2. En el panel de navegación, selecciona Conjuntos de contexto.

  3. Haz clic en el nombre del conjunto de contextos que deseas editar y, luego, en Editar en la página de detalles. Como alternativa, selecciona la casilla de verificación junto al conjunto de contextos de la lista y haz clic en Editar en la barra de acciones de la parte superior, o haz clic en Más opciones > Editar en la fila.

  4. Modifica los campos editables (Nombre visible, Descripción o Etiquetas) y, luego, haz clic en Guardar.

Tipos de metadatos

  1. En la consola de Google Cloud , ve a la página Tipos de metadatos.

    Ir a Tipos de metadatos

  2. Haz clic en Grupos de entrada > Conjunto de contexto.

  3. Haz clic en el nombre del conjunto de contextos que deseas editar y, luego, en Editar en la página de detalles.

  4. Modifica los campos editables (Nombre visible, Descripción o Etiquetas) y, luego, haz clic en Guardar.

Borrar un conjunto de contextos

Cuando borras un conjunto de contexto, se quitan sus entradas y asociaciones semánticas del grafo de contexto de datos. La consola no muestra una advertencia si borras un conjunto de contexto al que hace referencia una tarea de enriquecimiento existente. Si borras un conjunto de contexto mientras una ejecución de enriquecimiento está activa, la ejecución no guardará los metadatos propuestos cuando se complete, ya que el destino ya no está disponible. Las ejecuciones posteriores de la tarea de enriquecimiento también fallan después de ejecutarse hasta que vuelvas a crear el conjunto de contexto o crees una nueva tarea de enriquecimiento orientada a un conjunto de contexto válido.

Para borrar un conjunto de contextos, sigue estos pasos:

Knowledge Studio

  1. En la consola de Google Cloud , ve a la página Knowledge Studio.

    Ir a Knowledge Studio

  2. En el panel de navegación, selecciona Conjuntos de contexto.

  3. Haz clic en el nombre del conjunto de contextos que deseas borrar y, luego, en Borrar en la página de detalles. Como alternativa, selecciona la casilla de verificación junto al conjunto de contexto en la lista y haz clic en Borrar en la barra de acciones superior, o haz clic en Más opciones > Borrar en la fila.

  4. Confirma la eliminación.

Tipos de metadatos

  1. En la consola de Google Cloud , ve a la página Tipos de metadatos.

    Ir a Tipos de metadatos

  2. Haz clic en Grupos de entrada > Conjunto de contexto.

  3. Haz clic en el nombre del conjunto de contextos que deseas borrar y, luego, en Borrar en la página de detalles.

  4. Confirma la eliminación.

Limitaciones

Para obtener información sobre las limitaciones que se aplican durante la versión preliminar, consulta la sección Alcance y límites de la versión preliminar en Descripción general de los conjuntos de contexto.

¿Qué sigue?

Para obtener más información, consulta los siguientes recursos: