Les agents de données conversationnels vous permettent d'interagir avec les données de votre base de données à l'aide d'une interface en langage naturel. En créant ces agents, vous aidez les utilisateurs à "parler à leurs données", ce qui leur permet d'obtenir des insights à partir de bases de données opérationnelles sans avoir à écrire des requêtes SQL complexes.
De manière générale, un agent de données est une combinaison de persona, d'un ensemble de sources de données et d'un ensemble de connaissances métier essentielles à ses objectifs.
Pour les développeurs d'applications, ces agents offrent les avantages suivants :
- Haute précision : en utilisant le contexte créé, vous pouvez obtenir une grande précision pour des questions commerciales spécifiques. Le contexte créé est le principal facteur clé que les créateurs d'agents peuvent utiliser pour améliorer la précision. Il inclut des descriptions de schémas, des instructions système et un contexte structuré qui fournit des informations supplémentaires sur les requêtes de base de données attendues.
- Complexité réduite : les agents traduisent le langage naturel en requêtes SQL, en exécution et même en résumé ou visualisation des données.
- Flexibilité : vous pouvez créer des agents pour vos tests personnels ou les publier pour les rendre disponibles aux autres utilisateurs de votre projet ou de manière programmatique à l'aide de l'API.
Avant de commencer
-
Vérifiez que la facturation est activée pour votre projet Google Cloud .
-
Activez les API AlloyDB pour PostgreSQL, Data Analytics avec Gemini et Gemini pour Google Cloud .
Rôles requis pour activer les API
Pour activer les API, vous avez besoin du rôle IAM Administrateur Service Usage (
roles/serviceusage.serviceUsageAdmin), qui contient l'autorisationserviceusage.services.enable. Découvrez comment attribuer des rôles.
Rôles requis
Pour utiliser des agents de données, vous devez disposer d'autorisations IAM correspondant à votre cas d'utilisation. Le tableau suivant liste les rôles requis selon que vous créez et publiez des agents, que vous provisionnez des agents dans Gemini Enterprise ou que vous découvrez et utilisez des agents. Pour en savoir plus, consultez Rôles IAM pour l'API Conversational Analytics.
| Cas d'utilisation | Rôles requis |
|---|---|
| Créer, modifier, publier, partager et supprimer des agents |
|
| Provisionner des agents dans Gemini Enterprise |
Pour mettre un agent publié à la disposition des utilisateurs dans Gemini Enterprise, vous devez disposer des autorisations nécessaires pour enregistrer et gérer les agents A2A dans la console d'administration Gemini Enterprise. |
| Découvrir et utiliser des agents |
|
Pour travailler avec des ressources AlloyDB, comme afficher des tables ou exécuter des requêtes, consultez Rôles et autorisations IAM pour AlloyDB.
Créer un agent de données
Les sections suivantes décrivent comment créer un agent de données. Une fois que vous avez créé un agent, vous pouvez modifier ses paramètres.
Configurer les paramètres de base
Dans la console Google Cloud , accédez à la page AlloyDB.
Sélectionnez un cluster dans la liste.
Dans le menu de navigation, cliquez sur Agents.
Cliquez sur l'onglet Agents.
Sélectionnez une base de données et connectez-vous à l'aide de votre compte IAM.
Cliquez sur New agent (Nouvel agent). La page Nouvel agent s'ouvre.
Dans la section Éditeur, dans le champ Nom de l'agent, saisissez un nom descriptif pour l'agent de données (par exemple,
Q4 sales dataouUser activity logs).Dans le champ Description de l'agent, saisissez une description de l'agent de données. Une bonne description explique ce que fait l'agent et les données qu'il utilise. Elle vous aide également à déterminer s'il s'agit de l'agent de données approprié à utiliser pour une conversation (par exemple,
What are the top 10 selling products in Q2?).Dans la section Sources de connaissances, cliquez sur Ajouter une source. La page Ajouter des données s'ouvre.
Sélectionnez les tables sur lesquelles l'agent se concentrera pour répondre aux questions. Pour afficher d'autres sources de connaissances, sélectionnez Afficher plus.
Cliquez sur Ajouter. La page du nouvel agent se rouvre.
Personnaliser les descriptions des tables et des champs
Pour améliorer la précision de l'agent de données conversationnel, vous pouvez éventuellement fournir des métadonnées de table supplémentaires. Seul l'agent de données utilise ces métadonnées, qui n'ont aucune incidence sur la table source. Vous pouvez ajouter les métadonnées suivantes :
- Descriptions du schéma : ajoutez des descriptions pour vos tableaux et vos colonnes afin d'aider l'agent à comprendre vos données. Si vous n'ajoutez pas de descriptions, l'agent utilise les descriptions de schéma de vos définitions de données.
Suivez ces bonnes pratiques lorsque vous ajoutez des descriptions de tables et de champs :
- Ajoutez des descriptions à votre définition de données plutôt qu'à votre définition d'agent de données. Cela permet de s'assurer que les autres agents bénéficient également des descriptions.
- Pour prototyper la description appropriée afin d'aider les agents de données à comprendre vos données, ajoutez des descriptions à votre agent spécifique. Une fois que vous avez vérifié que la description a l'impact souhaité, vous pouvez décider de l'ajouter ou non à votre définition de données.
Pour configurer les descriptions des tables et des champs, procédez comme suit :
- Dans l'onglet Catalogue d'agents, ouvrez l'agent que vous souhaitez personnaliser.
- Cliquez sur Modifier l'agent.
- Dans Sources de connaissances, recherchez le tableau que vous souhaitez personnaliser, puis cliquez sur Personnaliser.
- Saisissez une description de la table.
- Pour modifier la description d'un champ, cliquez sur
Modifier à côté du champ. Le volet Modifier le champ s'ouvre.
- Dans le champ ID, saisissez une description du champ.
- Pour enregistrer la description du champ, cliquez sur Mettre à jour.
- Pour enregistrer la description et les modifications apportées aux champs, cliquez sur Mettre à jour. La nouvelle page de l'agent se rouvre.
- Répétez ces étapes pour chaque tableau que vous souhaitez personnaliser.
Ajouter des libellés aux agents de données
Dans la section Paramètres de l'agent, vous pouvez créer des libellés pour organiser vos ressources Google Cloud . Les étiquettes sont des paires clé/valeur qui vous permettent de regrouper des objets associés ou de les combiner à d'autres Google Cloudressources.
- Dans l'onglet Catalogue d'agents, ouvrez l'agent auquel vous souhaitez ajouter un libellé.
- Cliquez sur Modifier l'agent.
- Dans la section Paramètres de l'agent, cliquez sur Ajouter un libellé. Le volet Gérer les libellés s'ouvre.
- Cliquez sur Ajouter une étiquette.
- Dans les champs key et value, saisissez la paire clé/valeur pour le libellé.
- Si vous souhaitez ajouter d'autres libellés, cliquez à nouveau sur Ajouter un libellé.
- Pour supprimer un libellé, cliquez sur Supprimer.
- Lorsque vous avez terminé, cliquez sur Ajouter. La page du nouvel agent se rouvre.
Passez à la section suivante pour placer l'agent en mode brouillon ou le publier.
Prévisualiser et publier l'agent
Dans la section Prévisualisation, saisissez un exemple de question dans le champ Poser une question, puis appuyez sur Entrée.
Pour vérifier que l'agent de données renvoie les données attendues, examinez sa réponse. Si la réponse ne correspond pas à vos attentes, modifiez les paramètres de la section Éditeur pour affiner la configuration de l'agent de données jusqu'à obtenir des réponses satisfaisantes. Vous pouvez continuer à tester et à modifier votre agent pour affiner ses résultats.
Cliquez sur Enregistrer.
Pour placer l'agent de données en mode brouillon, que vous pourrez modifier ultérieurement, cliquez sur Retour pour revenir à la page Catalogue d'agents. Comme votre agent est désormais en mode brouillon, il apparaît dans la section Mes agents en brouillon de l'onglet Catalogue d'agents.
Pour publier votre agent, restez sur la page de création de l'agent et passez à l'étape suivante.
Pour publier l'agent de données et le rendre disponible pour utilisation dans le projet, cliquez sur Publier. La publication de l'agent permet à d'autres utilisateurs ayant accès aux mêmes tables de base de données de consulter votre agent et de discuter avec lui, en bénéficiant des instructions et du contexte que vous avez créés.
Vous pouvez créer des conversations avec l'agent de données à l'aide de la page Agents de la console Google Cloud . Vous pouvez également créer votre propre interface pour discuter avec l'agent de données à l'aide de l'API Conversational Analytics.
Facultatif : Dans la boîte de dialogue Votre agent a été publié, cliquez sur Partager pour partager l'agent de données avec d'autres utilisateurs.
- Dans le volet Autorisations de partage, cliquez sur Ajouter un compte principal.
- Dans le champ Nouveaux comptes principaux, saisissez un ou plusieurs comptes principaux.
- Cliquez sur la liste Sélectionner un rôle.
- Dans la liste Rôle, sélectionnez l'un des rôles suivants :
- Utilisateur d'agent des données des analyses de données Gemini (
roles/geminidataanalytics.dataAgentUser) : accorde l'autorisation de discuter avec l'agent de données. - Éditeur d'agent des données des analyses de données Gemini (
roles/geminidataanalytics.dataAgentEditor) : accorde l'autorisation de modifier l'agent de données. - Lecteur d'agent des données des analyses de données Gemini (
roles/geminidataanalytics.dataAgentViewer) : accorde l'autorisation d'afficher l'agent de données.
- Utilisateur d'agent des données des analyses de données Gemini (
- Cliquez sur Enregistrer.
Facultatif : Vous pouvez publier l'agent de données dans Gemini Enterprise. Pour en savoir plus, consultez Publier un agent de données dans Gemini Enterprise.
Pour revenir à la page du nouvel agent, cliquez sur Fermer. Une fois votre agent enregistré ou publié, vous pouvez le voir dans le catalogue d'agents.
Gérer les agents de données
Vous trouverez les agents existants dans l'onglet Catalogue d'agents, qui se compose de trois sections :
- Mes agents : liste de tous les agents que vous créez et publiez. Vous pouvez modifier et partager des agents publiés avec d'autres utilisateurs.
- Mes agents brouillons : agents que vous n'avez pas encore publiés. Vous ne pouvez pas partager de brouillons d'agents.
- Partagés par d'autres membres de votre organisation : agents créés et partagés avec vous par d'autres membres. Si d'autres utilisateurs vous accordent des autorisations, vous pouvez modifier ces agents partagés.
Modifier un agent de données
Pour modifier un agent de données, procédez comme suit :
Dans la console Google Cloud , accédez à la page AlloyDB.
Sélectionnez un cluster dans la liste.
Dans le menu de navigation, cliquez sur Agents.
Connectez-vous à Agents à l'aide de l'authentification Identity and Access Management (IAM).
Cliquez sur l'onglet Catalogue d'agents.
Recherchez la fiche de l'agent de données que vous souhaitez modifier.
Pour ouvrir l'agent de données dans l'éditeur d'agent, cliquez sur Ouvrir les actions, puis sur Modifier sur la fiche de l'agent.
Modifiez la configuration de l'agent de données si nécessaire.
Pour enregistrer vos modifications sans les publier, cliquez sur Enregistrer.
Pour publier vos modifications, cliquez sur Publier. Dans la boîte de dialogue Partager, vous pouvez partager l'agent avec d'autres utilisateurs ou cliquer sur Annuler.
Pour revenir au volet Agents, cliquez sur Retour.
Partager un agent de données
Pour partager un agent de données publié, procédez comme suit. Vous ne pouvez pas partager d'agents brouillons.
Dans la console Google Cloud , accédez à la page AlloyDB.
Sélectionnez un cluster dans la liste.
Dans le menu de navigation, cliquez sur Agents.
Connectez-vous à Agents à l'aide de l'authentification Identity and Access Management (IAM).
Cliquez sur l'onglet Catalogue d'agents.
Recherchez la fiche de l'agent de données que vous souhaitez modifier.
Pour ouvrir l'agent de données dans l'éditeur d'agent, cliquez sur Ouvrir les actions > cliquez sur Modifier sur la fiche de l'agent.
Pour partager l'agent de données avec d'autres utilisateurs, cliquez sur Partager.
Dans le volet Autorisations de partage, cliquez sur Ajouter un compte principal.
Dans le champ Ajouter des comptes principaux, saisissez un ou plusieurs comptes principaux.
Cliquez sur Sélectionner un rôle.
Dans la liste Rôle, sélectionnez l'un des rôles suivants :
- Utilisateur d'agent des données des analyses de données Gemini (
roles/geminidataanalytics.dataAgentUser) : accorde l'autorisation de discuter avec l'agent de données. - Éditeur d'agent des données des analyses de données Gemini (
roles/geminidataanalytics.dataAgentEditor) : permet de modifier l'agent de données. - Lecteur d'agent des données des analyses de données Gemini (
roles/geminidataanalytics.dataAgentViewer) : accorde l'autorisation d'afficher l'agent de données.
- Utilisateur d'agent des données des analyses de données Gemini (
Cliquez sur Enregistrer.
Pour revenir à la page de modification de l'agent, cliquez sur Fermer.
Pour revenir au volet Agents, cliquez sur Retour.
Supprimer un agent de données
Dans la console Google Cloud , accédez à la page AlloyDB.
Sélectionnez un cluster dans la liste.
Dans le menu de navigation, cliquez sur Agents.
Connectez-vous à Agents à l'aide de l'authentification Identity and Access Management (IAM).
Sélectionnez l'onglet Catalogue d'agents.
Dans la section Agents de l'onglet Catalogue d'agents, recherchez la fiche de l'agent de données que vous souhaitez supprimer.
Cliquez sur Ouvrir les actions > Supprimer.
Dans la boîte de dialogue Supprimer l'agent ?, cliquez sur Supprimer. Si vous supprimez définitivement l'agent, il sera retiré du projet.
Une fois l'agent supprimé, les conversations existantes sont disponibles en mode lecture seule. Vous ne pouvez pas poser de nouvelles questions à l'agent supprimé.
Publier un agent de données dans Gemini Enterprise
La publication d'un agent de données implique une collaboration entre les analystes de données, les administrateurs Gemini Enterprise et les utilisateurs professionnels. Pour en savoir plus sur les rôles requis pour ces utilisateurs, consultez Rôles requis.
Créer et publier un agent
Pour créer, modifier et publier un agent, procédez comme suit :
- Créez ou modifiez votre agent de données dans AlloyDB.
- Publiez l'agent. Lorsque vous publiez l'agent, sélectionnez Gemini Enterprise comme option de publication.
- Pour copier le JSON du point de terminaison A2A, cliquez sur Copier le JSON.
- Partagez le fichier JSON du point de terminaison A2A et la liste des utilisateurs avec votre administrateur Gemini Enterprise afin qu'il puisse enregistrer l'agent personnalisé dans la console Google Cloud et configurer les autorisations d'accès. Pour en savoir plus, consultez Provisionner un agent.
- Partagez l'agent avec les utilisateurs et les groupes qui ont besoin d'y accéder.
Provisionner un agent
Pour rendre un agent publié disponible pour les utilisateurs dans la console Google Cloud , procédez comme suit :
Dans la console Google Cloud , accédez à Gemini Enterprise.
Cliquez sur le nom de l'application dans laquelle vous souhaitez enregistrer l'agent.
Cliquez sur Agents > Ajouter des agents.
Dans la section Choisir un type d'agent, cliquez sur Ajouter pour Agent personnalisé via A2A.
Dans le champ JSON de la fiche de l'agent, saisissez les détails de la fiche de l'agent que vous avez reçus précédemment de l'analyste de données au format JSON.
Cliquez sur Prévisualiser les informations sur l'agent > Suivant.
Pour permettre à l'agent d'accéder aux ressources Google Cloud en votre nom, procédez comme suit :
Saisissez l'ID client et le code secret du client que vous avez générés dans la section Configurer les détails de l'autorisation.
Dans le champ URI d'autorisation, saisissez ce qui suit :
https://accounts.google.com/o/oauth2/v2/auth?client_id=client_id&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Fstatic%2Foauth%2Foauth.html&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent
Remplacez client_id par l'ID client que vous avez généré dans Configurer les détails d'autorisation.
Dans le champ URI du jeton, saisissez ce qui suit :
https://oauth2.googleapis.com/token
Dans le champ Scopes, saisissez ce qui suit :
https://www.googleapis.com/auth/cloud-platform
Cliquez sur Terminer.
Partagez l'agent avec les utilisateurs ou les groupes.
Pour en savoir plus, consultez Enregistrer et gérer les agents A2A.
Rechercher et utiliser un agent
Vous pouvez trouver et utiliser un agent de données dans Gemini Enterprise en utilisant l'une des méthodes suivantes :
- Localisez l'agent dans la galerie d'agents et démarrez un chat dédié.
- Utilisez l'URL dédiée de l'agent pour ouvrir Gemini Enterprise directement dans une session avec cet agent de données AlloyDB spécifique.
- Invoquez l'agent en écrivant un
@mention(par exemple,@sales_pipeline_agent) dans le chat principal de Gemini Enterprise. - Posez une question analytique générale, comme "Quelle est la tendance de notre pipeline de vente au cours des trois derniers mois ?", pour que Gemini Enterprise achemine automatiquement la requête vers l'agent de données approprié.
Une fois que vous avez trouvé l'agent, vous pouvez interagir avec lui à l'aide de l'une des méthodes suivantes :
- Effectuez la connexion OAuth ponctuelle pour vous authentifier de manière sécurisée auprès d'AlloyDB.
- poser des questions en langage naturel ; L'agent d'analyse conversationnelle traite vos demandes et renvoie la réponse à Gemini Enterprise sous forme de texte, de code Markdown, de graphiques ou de tableaux.
- Consultez l'historique de vos conversations dans le volet "Historique", où les conversations sont automatiquement enregistrées.
Emplacements
L'analyse conversationnelle fonctionne dans le monde entier. Vous ne pouvez pas choisir la région à utiliser.
Étapes suivantes
- En savoir plus sur Conversational Analytics dans AlloyDB
- En savoir plus sur l'API Conversational Analytics
- Analyser les données avec des conversations
- Découvrez comment le rôle Lecteur d'agent des données des analyses de données Gemini (
roles/geminidataanalytics.dataAgentViewer) accorde l'autorisation d'afficher l'agent de données.