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 de requêtes SQL complexes.
D'une manière générale, un agent de données est une combinaison d'un persona et d'un ensemble de sources de données, avec un accès à 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 un contexte créé, vous pouvez obtenir une haute précision pour des questions métier 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éma, 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 en visualisation de données.
- Flexibilité : vous pouvez créer des agents pour des tests personnels, ou les publier pour les mettre à la disposition d'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 Bigtable, Bigtable Admin, Data Analytics avec Gemini et Gemini pour Google Cloud , si elles ne sont pas déjà activées.
Rôles requis pour activer les API
Pour activer des API, vous devez disposer de l'autorisation
serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). 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 Identity and Access Management 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 qu'un agent publié soit disponible pour les utilisateurs de 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 utiliser les ressources Bigtable, consultez Rôles et autorisations Bigtable.
Créer un agent de données
Les sections suivantes expliquent 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 "Bigtable".
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Agents.
Cliquez sur l'onglet Catalogue d'agents.
Cliquez sur Create agent (Créer un agent). La page Éditeur 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, quelles données il utilise et vous aide à 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.
Cliquez sur Add Data (Ajouter des données). La page du nouvel agent s'ouvre à nouveau.
Cliquez sur Enregistrer le brouillon pour enregistrer votre progression.
Créer des requêtes validées
Vous pouvez sélectionner des requêtes validées dans une liste générée par le système ou créer les vôtres.
Pour créer une requête validée pour l'agent de données, procédez comme suit :
Dans la console Google Cloud , accédez à la page "Bigtable".
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Agents.
Cliquez sur l'onglet Catalogue d'agents.
Recherchez la fiche de l'agent de données que vous souhaitez modifier. Si votre agent de données est un brouillon non publié, cliquez sur Brouillons d'agents.
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.
Dans Requêtes validées, cliquez sur Ajouter une requête.
- Dans Question, saisissez la question à laquelle la requête validée peut répondre.
- Cliquez sur Générer du code SQL pour laisser Gemini générer une requête vérifiée qui correspond à la question que vous avez ajoutée.
- Cliquez sur Exécuter et vérifiez que la requête renvoie les résultats attendus.
- Examinez la réponse et modifiez la requête validée, si nécessaire.
- Cliquez sur Ajouter.
- Cliquez sur Enregistrer le brouillon pour enregistrer votre progression.
Répétez ces étapes pour créer d'autres requêtes validées.
Ajouter des étiquettes aux agents de données
Dans la section Paramètres de l'agent, vous pouvez créer des étiquettes 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 ressources Google Cloud.
Dans la console Google Cloud , accédez à la page "Bigtable".
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Agents.
Cliquez sur l'onglet Catalogue d'agents.
Recherchez la fiche de l'agent de données que vous souhaitez modifier. Si votre agent de données est un brouillon non publié, cliquez sur Brouillons d'agents.
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.
Dans la section Paramètres de l'agent, cliquez sur Ajouter un libellé. Le volet Gérer les étiquettes s'ouvre.
Cliquez sur Ajouter une étiquette.
Dans les champs clé et valeur, saisissez votre paire clé-valeur pour l'étiquette.
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 s'ouvre à nouveau.
Passez à la section suivante pour placer l'agent en mode brouillon ou pour le publier.
Prévisualiser et publier l'agent
Dans la section Aperçu, 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 le brouillon.
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 Brouillons d'agents 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 dans le projet, cliquez sur Publier. Dans la boîte de dialogue Canaux de publication, sélectionnez les canaux de publication à utiliser. Cliquez sur Publier l'agent (ou Publier les mises à jour).
La publication de l'agent permet aux autres utilisateurs ayant accès aux mêmes tables de base de données de voir 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 est publié et prêt à être partagé, 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 de 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) : autorise la modification de l'agent de données. - Lecteur d'agent de données Gemini Data Analytics (
roles/geminidataanalytics.dataAgentViewer) : autorise l'affichage de l'agent de données.
- Utilisateur d'agent de données des analyses de données Gemini (
- Cliquez sur Enregistrer.
Facultatif : vous pouvez publier l'agent de données sur 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 que vous avez enregistré ou publié votre agent, 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 :
- Tous les agents : liste de tous les agents que vous créez et publiez, ainsi que des agents que d'autres utilisateurs créent et partagent avec vous.
- 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.
Brouillons d'agents : agents que vous n'avez pas encore publiés. Vous ne pouvez pas partager de brouillons d'agents.
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 "Bigtable".
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Agents.
Cliquez sur l'onglet Catalogue d'agents.
Recherchez la fiche de l'agent de données que vous souhaitez modifier. Si votre agent de données est un brouillon non publié, cliquez sur Brouillons d'agents.
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 le brouillon.
Pour publier l'agent de données et le rendre disponible dans le projet, cliquez sur Publier. Dans la boîte de dialogue Canaux de publication, sélectionnez les canaux de publication à utiliser. Cliquez sur Publier l'agent (ou Publier les mises à jour). Dans la boîte de dialogue Partager, vous pouvez partager l'agent avec d'autres personnes ou cliquer sur Fermer.
Pour revenir au volet Catalogue d'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 "Bigtable".
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Agents.
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 de données Gemini Data Analytics (
roles/geminidataanalytics.dataAgentUser) : accorde l'autorisation de discuter avec l'agent de données. - Éditeur d'agent de 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 de données Gemini Data Analytics (
Cliquez sur Enregistrer.
Pour revenir à la page de modification de l'agent, cliquez sur Fermer.
Pour revenir au volet Catalogue d'agents, cliquez sur Retour.
Supprimer un agent de données
Dans la console Google Cloud , accédez à la page "Bigtable".
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Agents.
Sélectionnez l'onglet Catalogue d'agents.
Recherchez la fiche de l'agent de données que vous souhaitez supprimer. Si votre agent de données est un brouillon non publié, cliquez sur Brouillons d'agents.
Cliquez sur Ouvrir les actions > Supprimer.
Dans la boîte de dialogue Supprimer l'agent ?, cliquez sur Supprimer. La suppression de l'agent le supprime définitivement du projet.
Après avoir supprimé un agent, 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 Bigtable.
- Publiez l'agent. Lorsque vous publiez l'agent, sélectionnez Gemini Enterprise comme option de publication.
- Pour copier le fichier JSON du point de terminaison A2A, cliquez sur Copier le fichier 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 mettre un agent publié à la disposition des 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 Fiche d'agent JSON, saisissez les détails de la fiche d'agent que vous avez reçus précédemment de l'analyste de données au format JSON.
Cliquez sur Prévisualiser les détails de 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 Champs d'application, 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 des agents A2A.
Rechercher et utiliser un agent
Vous pouvez trouver et utiliser un agent de données dans Gemini Enterprise de l'une des manières suivantes :
- Recherchez l'agent dans Agent Gallery et démarrez une discussion dédiée.
- Utilisez l'URL dédiée de l'agent pour ouvrir Gemini Enterprise directement dans une session avec cet agent de données Bigtable spécifique.
- Appelez 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, par exemple "Comment notre pipeline de vente a-t-il évolué 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 de l'une des manières suivantes :
- Effectuez la connexion OAuth unique pour vous authentifier de manière sécurisée auprès de Bigtable.
- Posez des questions en langage naturel. L'agent d'analyse conversationnelle traite vos requêtes et transmet la réponse à Gemini Enterprise sous forme de texte, de Markdown, de graphiques ou de tableaux.
- Consultez l'historique de vos conversations dans le volet de l'historique, où les conversations sont automatiquement enregistrées.
Emplacements
L'analyse conversationnelle fonctionne à l'échelle mondiale. Vous ne pouvez pas choisir la région à utiliser.
Étapes suivantes
- En savoir plus sur l'analyse conversationnelle dans Bigtable
- 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.