Les ensembles de contexte vous permettent d'ancrer les agents IA à l'aide de conteneurs limités d'informations sémantiques et de références d'éléments de données. Pour en savoir plus sur le fonctionnement de ces conteneurs, consultez la présentation des ensembles de contextes.
Vous devez configurer un ensemble de contextes avant d'exécuter une tâche d'enrichissement. Les tâches d'enrichissement sont des agents autonomes qui analysent en continu les schémas et la documentation de vos ensembles de données pour générer des propositions de métadonnées pour vos éléments de données.
Vous pouvez configurer un ensemble de contexte en tant que conteneur autonome ou dans le cadre d'une configuration de job d'enrichissement. Pour en savoir plus sur la création d'un ensemble de contextes lors de la configuration d'une tâche, consultez Créer des tâches d'enrichissement.
Avant de commencer
Avant de gérer des ensembles de contextes, assurez-vous de disposer des rôles IAM requis.
Rôles requis
Pour obtenir les autorisations nécessaires pour gérer les ensembles de contextes, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :
- Pour créer des ensembles de contexte : Administrateur de catalogue Dataplex (
roles/dataplex.catalogAdmin) ou Propriétaire de groupe d'entrées Dataplex (roles/dataplex.entryGroupOwner). Ces rôles contiennent l'autorisationdataplex.entryGroups.setIamPolicy, qui est requise pour vous accorder automatiquement des autorisations de propriétaire lors de la création de l'ensemble de contexte. - Pour modifier ou supprimer des ensembles de contexte : Administrateur de catalogue Dataplex (
roles/dataplex.catalogAdmin) ou Éditeur de catalogue Dataplex (roles/dataplex.catalogEditor).
Créer un ensemble de contextes
Pour créer un ensemble de contextes vide afin de stocker vos métadonnées enrichies, procédez comme suit :
Knowledge Studio
Dans la console Google Cloud , accédez à la page Knowledge Studio.
Dans le volet de navigation de gauche, sélectionnez Ensembles de contextes.
Sur la page Ensembles de contextes, cliquez sur Créer.
Dans le volet Créer un ensemble de contextes, saisissez un nom dans le champ Nom à afficher et un ID dans le champ ID de l'ensemble de contextes.
Facultatif : saisissez une description, sélectionnez un emplacement et ajoutez des libellés.
Cliquez sur Enregistrer.
Types de métadonnées
Dans la console Google Cloud , accédez à la page Types de métadonnées.
Cliquez sur Groupes d'entrées > Ensemble de contextes.
Sur la page Types de métadonnées, cliquez sur Créer.
Dans le volet Créer un ensemble de contextes, saisissez un nom dans le champ Nom à afficher et un ID dans le champ ID de l'ensemble de contextes.
Facultatif : saisissez une description, sélectionnez un emplacement et ajoutez des libellés.
Cliquez sur Enregistrer.
Après avoir créé l'ensemble de contexte, vous pouvez le sélectionner comme cible pour vos tâches d'enrichissement. L'exécution de l'enrichissement remplit ce conteneur avec les concepts de métadonnées, les associations sémantiques et les formules proposés par l'IA.
Pour en savoir plus sur les tâches d'enrichissement, consultez À propos des tâches d'enrichissement.
Afficher les ensembles de contexte
Pour afficher les ensembles de contextes existants, procédez comme suit :
Knowledge Studio
Dans la console Google Cloud , accédez à la page Knowledge Studio.
Dans le volet de navigation de gauche, sélectionnez Ensembles de contextes.
Pour afficher les détails d'un ensemble de contextes spécifique, cliquez sur son nom dans la liste.
Types de métadonnées
Dans la console Google Cloud , accédez à la page Types de métadonnées.
Cliquez sur Groupes d'entrées > Ensemble de contextes.
Pour afficher les détails d'un ensemble de contextes spécifique, cliquez sur son nom dans la liste.
La page d'informations affiche les propriétés de l'ensemble de contextes, telles que sa description, son emplacement et l'ID du projet. Il contient également une section Exemples d'entrées qui affiche un aperçu des entrées de métadonnées enrichies stockées dans l'ensemble de contexte, ainsi qu'un bouton permettant d'afficher toutes les entrées associées dans la recherche.
Modifier un ensemble de contextes
La console Google Cloud vous permet de modifier les propriétés du conteneur d'un ensemble de contextes, y compris son nom à afficher, sa description et ses libellés.
Pour mettre à jour le contenu des métadonnées enrichies dans un ensemble de contexte, vous devez exécuter une tâche d'enrichissement ciblant cet ensemble et approuver les propositions de modification générées. Pour en savoir plus sur l'approbation des propositions de modification, consultez Gérer les exécutions d'enrichissement.
Pour modifier les propriétés d'un ensemble de contextes, procédez comme suit :
Knowledge Studio
Dans la console Google Cloud , accédez à la page Knowledge Studio.
Dans le volet de navigation de gauche, sélectionnez Ensembles de contextes.
Cliquez sur le nom de l'ensemble de contextes que vous souhaitez modifier.
Sur la page des détails, cliquez sur Modifier.
Modifiez les champs modifiables (Nom à afficher, Description ou Libellés), puis cliquez sur Enregistrer.
Types de métadonnées
Dans la console Google Cloud , accédez à la page Types de métadonnées.
Cliquez sur Groupes d'entrées > Ensemble de contextes.
Sur la page Types de métadonnées, cliquez sur le nom de l'ensemble de contextes que vous souhaitez modifier.
Sur la page des détails, cliquez sur Modifier.
Modifiez les champs modifiables (Nom à afficher, Description ou Libellés), puis cliquez sur Enregistrer.
Supprimer un ensemble de contexte
La suppression d'un ensemble de contextes supprime ses associations sémantiques du graphique de contexte de données. Si vous supprimez un ensemble de contextes alors qu'une exécution d'enrichissement est active, l'exécution ne parvient pas à enregistrer les métadonnées proposées à la fin, car la destination cible n'est plus disponible. Les exécutions ultérieures de la tâche d'enrichissement échoueront également jusqu'à ce que vous mettiez à jour la tâche pour qu'elle génère un ensemble de contextes valide.
Pour supprimer un ensemble de contextes, procédez comme suit :
Knowledge Studio
Dans la console Google Cloud , accédez à la page Knowledge Studio.
Dans le volet de navigation de gauche, sélectionnez Ensembles de contextes.
Dans la liste, cliquez sur le nom de l'ensemble de contextes que vous souhaitez supprimer.
Sur la page d'informations, cliquez sur Supprimer.
Confirmez la suppression.
Types de métadonnées
Dans la console Google Cloud , accédez à la page Types de métadonnées.
Cliquez sur Groupes d'entrées > Ensemble de contextes.
Dans la liste, cliquez sur le nom de l'ensemble de contextes que vous souhaitez supprimer.
Sur la page d'informations, cliquez sur Supprimer.
Confirmez la suppression.
Limites
Pour en savoir plus sur les limites qui s'appliquent pendant la version Preview, consultez Limites de la version Preview.
Étapes suivantes
Pour en savoir plus, consultez les ressources suivantes :