Créer des agents de données

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

  1. Vérifiez que la facturation est activée pour votre projet Google Cloud .

  2. Activez les API Cloud SQL, 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.

    Activer les API

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, provisionnez des agents dans Gemini Enterprise, ou 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
  • Pour créer des agents de données dans un projet : créateur d'agent des données des analyses de données Gemini (roles/geminidataanalytics.dataAgentCreator) sur le projet. Ce rôle vous attribue automatiquement le rôle de propriétaire de l'agent de données des analyses de données Gemini sur les agents de données que vous créez.
  • Pour modifier, partager ou supprimer un agent de données : propriétaire d'agent des données des analyses de données Gemini (roles/geminidataanalytics.dataAgentOwner) sur l'agent ou le projet.
  • Pour modifier un agent de données dans un projet : Éditeur d'agent de données des analyses de données Gemini (roles/geminidataanalytics.dataAgentEditor) sur le projet.
  • Pour afficher les agents de données d'un projet : Lecteur d'agent de données des analyses de données Gemini (roles/geminidataanalytics.dataAgentViewer) sur le projet.
  • De plus, vous devez disposer des rôles suivants pour créer ou modifier un agent de données :
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 discuter avec des agents de données : Utilisateur d'agent de données Gemini Data Analytics (roles/geminidataanalytics.dataAgentUser).
  • Pour afficher tous les agents de données du projet : Lecteur d'agent des données des analyses de données Gemini (roles/geminidataanalytics.dataAgentViewer).

Lorsque vous gérez l'accès aux ressources de base de données Cloud SQL pour PostgreSQL, tenez compte des couches d'autorisations suivantes :

  • Google Cloud IAM : contrôle l'accès à l'instance de base de données en tant que ressource cloud. Cela inclut les autorisations de connexion, de gestion de l'instance et d'exécution de requêtes SQL, par exemple à l'aide de l'autorisation executeSql.
  • Autorisations de base de données : contrôlez l'accès aux objets de la base de données, tels que les tables, les vues et les schémas. Elles sont gérées à l'aide de commandes SQL telles que GRANT, ainsi que de systèmes d'utilisateurs et de rôles spécifiques à la base de données.

Pour Cloud SQL pour PostgreSQL, vous devez disposer des rôles IAM Cloud SQL appropriés pour vous connecter à l'instance et être autorisé à envoyer des requêtes. Pour interagir avec des objets tels que des tables et des vues, l'utilisateur de la base de données de connexion doit disposer des droits nécessaires accordés à l'aide du système GRANT de Cloud SQL pour PostgreSQL. Pour en savoir plus, consultez À propos des utilisateurs et des rôles PostgreSQL. Si l'agent utilise un compte de service, vous pouvez obtenir un rôle de base de données attribué. Pour en savoir plus, consultez Gérer les utilisateurs avec l'authentification IAM pour les bases de données.

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

  1. Dans la console Google Cloud , accédez à la page Cloud SQL pour PostgreSQL.

    Accéder à Cloud SQL

  2. Sélectionnez une instance dans la liste.

  3. Dans le menu de navigation, cliquez sur Conversations.

  4. Cliquez sur l'onglet Agents.

  5. Sélectionnez une base de données et connectez-vous à l'aide de votre compte IAM.

  6. Cliquez sur New agent (Nouvel agent). La page Nouvel agent s'ouvre.

  7. 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 data ou User activity logs.

  8. 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?).

  9. Dans la section Sources de connaissances, cliquez sur Ajouter une source. La page Ajouter des données s'ouvre.

  10. 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.

  11. Cliquez sur Ajouter. La page du nouvel agent s'ouvre à nouveau.

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, et cela n'affecte pas la table source. Vous pouvez ajouter les métadonnées suivantes :

  • Descriptions de schéma : ajoutez des descriptions pour vos tables et 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, et pas seulement à la définition de votre 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. Après avoir 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 personnaliser les descriptions des tables et des champs d'un agent, procédez comme suit :

  1. Dans l'onglet Catalogue d'agents, ouvrez l'agent que vous souhaitez personnaliser.
  2. Cliquez sur Modifier l'agent.
  3. Dans Sources de connaissances, recherchez le tableau que vous souhaitez personnaliser, puis cliquez sur Personnaliser.
  4. Ajoutez une description dans Description de la table ou acceptez la suggestion de Gemini.
  5. Dans Champs, examinez les descriptions suggérées par Gemini pour les colonnes de la table.
  6. Gérez les descriptions de champs suggérées :
    • Pour accepter les suggestions, sélectionnez les descriptions de votre choix, puis cliquez sur Accepter les suggestions.
    • Pour refuser des suggestions, sélectionnez les descriptions de votre choix, puis cliquez sur Refuser les suggestions.
  7. Pour modifier la description d'un champ, cliquez sur Modifier à côté du champ.
    1. Dans le champ Description, saisissez une description du champ.
    2. Cliquez sur Mettre à jour pour enregistrer vos modifications.
  8. Cliquez sur Mettre à jour pour enregistrer la personnalisation du tableau.
  9. Répétez ces étapes pour chaque tableau que vous souhaitez personnaliser.

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 :

  1. Dans l'onglet Catalogue d'agents, ouvrez l'agent que vous souhaitez personnaliser.
  2. Cliquez sur Modifier l'agent.

  3. Dans Requêtes validées, cliquez sur Afficher les suggestions générées par Gemini.

    1. Dans Consulter les requêtes validées suggérées, examinez les requêtes validées suggérées.
    2. Sélectionnez les requêtes qui s'appliquent à votre cas d'utilisation.
    3. Cliquez sur Ajouter pour ajouter les requêtes au contexte.

  4. Facultatif. Pour créer votre propre requête validée, dans Requêtes validées, cliquez sur Ajouter une requête.

    1. Dans Question, saisissez la question à laquelle la requête validée peut répondre.
    2. Cliquez sur Générer du code SQL pour laisser Gemini générer une requête validée correspondant à la question que vous avez ajoutée.
    3. Cliquez sur Exécuter et vérifiez que la requête renvoie les résultats attendus.
    4. Examinez la réponse et modifiez la requête validée, si nécessaire.
    5. Cliquez sur Ajouter.

  5. 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.

  1. Dans l'onglet Catalogue d'agents, ouvrez l'agent auquel vous souhaitez ajouter une étiquette.
  2. Cliquez sur Modifier l'agent.
  3. Dans la section Paramètres de l'agent, cliquez sur Ajouter un libellé. Le volet Gérer les étiquettes s'ouvre.
  4. Cliquez sur Ajouter une étiquette.
  5. Dans les champs clé et valeur, saisissez votre paire clé/valeur pour l'étiquette.
  6. Si vous souhaitez ajouter d'autres libellés, cliquez à nouveau sur Ajouter un libellé.
  7. Pour supprimer un libellé, cliquez sur Supprimer.
  8. 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

  1. 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.

  2. Cliquez sur Enregistrer.

  3. 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.

  4. Pour publier l'agent de données et le rendre disponible dans le projet, cliquez sur Publier. 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 Conversations 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.

  5. 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.

    1. Dans le volet Autorisations de partage, cliquez sur Ajouter un compte principal.
    2. Dans le champ Nouveaux comptes principaux, saisissez un ou plusieurs comptes principaux.
    3. Cliquez sur la liste Sélectionner un rôle.
    4. Dans la liste Rôle, sélectionnez l'un des rôles suivants :
      • Utilisateur d'agent d'analyse de données Gemini (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) : autorise la modification de l'agent de données.
      • Lecteur d'agent d'analyse de données Gemini (roles/geminidataanalytics.dataAgentViewer) : autorise l'affichage de l'agent de données.
    5. Cliquez sur Enregistrer.

  6. 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.

  7. 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 :

  • 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 brouillons d'agents : 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 que d'autres utilisateurs créent et partagent avec vous. 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 :

  1. Dans la console Google Cloud , accédez à la page Cloud SQL pour PostgreSQL.

    Accéder à Cloud SQL

  2. Sélectionnez une instance dans la liste.

  3. Dans le menu de navigation, cliquez sur Conversations.

  4. Connectez-vous à Conversations à l'aide de l'authentification Identity and Access Management (IAM).

  5. Cliquez sur l'onglet Catalogue d'agents.

  6. Recherchez la fiche de l'agent de données que vous souhaitez modifier.

  7. 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.

  8. Modifiez la configuration de l'agent de données si nécessaire.

  9. Pour enregistrer vos modifications sans les publier, cliquez sur Enregistrer.

  10. Pour publier vos modifications, cliquez sur Publier. Dans la boîte de dialogue Partager, vous pouvez partager l'agent avec d'autres personnes ou cliquer sur Annuler.

  11. Pour revenir au volet Conversations, 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.

  1. Dans la console Google Cloud , accédez à la page Cloud SQL pour PostgreSQL.

    Accéder à Cloud SQL

  2. Sélectionnez une instance dans la liste.

  3. Dans le menu de navigation, cliquez sur Conversations.

  4. Connectez-vous à Conversations à l'aide de l'authentification Identity and Access Management (IAM).

  5. Cliquez sur l'onglet Catalogue d'agents.

  6. Recherchez la fiche de l'agent de données que vous souhaitez modifier.

  7. 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.

  8. Pour partager l'agent de données avec d'autres utilisateurs, cliquez sur Partager.

  9. Dans le volet Autorisations de partage, cliquez sur Ajouter un compte principal.

  10. Dans le champ Ajouter des comptes principaux, saisissez un ou plusieurs comptes principaux.

  11. Cliquez sur Sélectionner un rôle.

  12. Dans la liste Rôle, sélectionnez l'un des rôles suivants :

    • Utilisateur d'agent d'analyse de données Gemini (roles/geminidataanalytics.dataAgentUser) : autorise à discuter avec l'agent de données.
    • Éditeur d'agent d'analyse de données Gemini (roles/geminidataanalytics.dataAgentEditor) : accorde l'autorisation de modifier l'agent de données.
    • Lecteur d'agent de données Gemini Data Analytics (roles/geminidataanalytics.dataAgentViewer) : accorde l'autorisation d'afficher l'agent de données.

  13. Cliquez sur Enregistrer.

  14. Pour revenir à la page de modification de l'agent, cliquez sur Fermer.

  15. Pour revenir au volet Conversations, cliquez sur Retour.

Supprimer un agent de données

  1. Dans la console Google Cloud , accédez à la page Cloud SQL pour PostgreSQL.

    Accéder à Cloud SQL

  2. Sélectionnez une instance dans la liste.

  3. Dans le menu de navigation, cliquez sur Conversations.

  4. Connectez-vous à Conversations à l'aide de l'authentification Identity and Access Management (IAM).

  5. Sélectionnez l'onglet Catalogue d'agents.

  6. Dans la section Agents de l'onglet Catalogue d'agents, recherchez la fiche de l'agent de données que vous souhaitez supprimer.

  7. Cliquez sur Ouvrir les actions > Supprimer.

  8. 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 :

  1. Créez ou modifiez votre agent de données dans Cloud SQL pour PostgreSQL.
  2. Publiez l'agent. Lorsque vous publiez l'agent, sélectionnez Gemini Enterprise comme option de publication.
  3. Pour copier le JSON du point de terminaison A2A, cliquez sur Copier le JSON.
  4. 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.
  5. 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 :

  1. Dans la console Google Cloud , accédez à Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur le nom de l'application dans laquelle vous souhaitez enregistrer l'agent.

  3. Cliquez sur Agents > Ajouter des agents.

  4. Dans la section Choisir un type d'agent, cliquez sur Ajouter pour Agent personnalisé via A2A.

  5. Dans le champ Fiche d'agent JSON, saisissez les détails de la fiche d'agent que vous avez précédemment reçus de l'analyste de données au format JSON.

  6. Cliquez sur Prévisualiser les détails de l'agent > Suivant.

  7. Pour permettre à l'agent d'accéder aux ressources Google Cloud en votre nom, procédez comme suit :

    1. Saisissez l'ID client et le code secret du client que vous avez générés dans la section Configurer les détails d'autorisation.

    2. 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.

    3. Dans le champ URI du jeton, saisissez ce qui suit :

      https://oauth2.googleapis.com/token

    4. Dans le champ Champs d'application, saisissez ce qui suit :

      https://www.googleapis.com/auth/cloud-platform

  8. Cliquez sur Terminer.

  9. 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 Cloud SQL pour PostgreSQL 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 Cloud SQL pour PostgreSQL.
  • 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