Analyser des données avec des conversations

Ce document explique comment créer, modifier et supprimer des conversations dans AlloyDB pour PostgreSQL. Les conversations sont des discussions persistantes avec un agent de données.

Vous pouvez poser aux agents de données des questions en plusieurs parties qui utilisent des termes courants, par exemple "ventes" ou "les plus populaires", sans spécifier de noms de champs de table ni définir de conditions pour filtrer les données. La réponse du chat fournit la réponse à votre question sous forme de texte et de code, et génère des graphiques le cas échéant. La réponse inclut le raisonnement derrière les résultats.

Vous pouvez créer une conversation avec un agent de données. Lorsque vous créez une conversation directe, l'API Conversational Analytics interprète votre question sans le contexte ni les instructions de traitement fournis par un agent de données.

Avant de commencer

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

  2. Activez les API AlloyDB pour PostgreSQL, l'API 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 :
    • Un utilisateur ou un compte de service IAM ajouté au cluster au niveau de la base de données. Pour en savoir plus, consultez Gérer les utilisateurs de base de données.
    • Le rôle alloydb.databaseUser et l'autorisation serviceusage.serviceUsageConsumer accordés à l'utilisateur IAM au niveau du projet. Pour en savoir plus, consultez Ajouter une liaison de stratégie IAM pour un projet.
    • (Facultatif) Si vous utilisez des ensembles de contexte (preview) avec votre agent de données de base de données, pour créer, importer et gérer des ensembles de contexte : le rôle Éditeur de catalogue Dataplex (roles/dataplex.catalogEditor) ou Administrateur de catalogue Dataplex (roles/dataplex.catalogAdmin) attribué à l'utilisateur IAM au niveau du projet. Pour en savoir plus, consultez Autorisations des ensembles de contextes.
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).

Pour utiliser des ressources AlloyDB, par exemple pour afficher des tables ou exécuter des requêtes, consultez Rôles et autorisations IAM pour AlloyDB.

créer des conversations

Vous pouvez créer des conversations persistantes avec un agent ou une source de données dans la console Google Cloud pour AlloyDB à partir de l'onglet Catalogue d'agents de la page Conversations.

Créer une conversation avec un agent de données

Pour créer une conversation avec un agent de données, vous devez d'abord créer un agent de données et le publier. Vous pouvez également démarrer une conversation avec des agents que d'autres personnes partagent avec vous.

Pour créer une conversation avec un agent de données dans la console Google Cloud , procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page AlloyDB.

    Accéder à AlloyDB

  2. Sélectionnez un cluster dans la liste.

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

  4. Dans la section Mes agents ou Partagés par d'autres membres de votre organisation, cliquez sur la fiche de l'agent avec lequel vous souhaitez discuter.

  5. Cliquez sur Démarrer une conversation. Un nouveau panneau de discussion s'ouvre.

  6. Dans le champ Poser une question, saisissez une question pour l'agent de données. Par exemple, "Quel était le montant total de nos ventes au cours du dernier trimestre ?" ou "Affiche les cinq utilisateurs ayant la durée de session la plus élevée". Vous pouvez également cliquer sur l'une des questions suggérées par Gemini pour commencer.

    L'agent de données répond en indiquant l'action qu'il effectue pour répondre à votre question, puis il renvoie les résultats.

    Pour voir chaque étape suivie par l'agent de données pour répondre à votre question, cliquez sur Afficher le raisonnement pour afficher chaque message du processus de raisonnement de l'agent.

    Pour savoir comment les résultats ont été calculés, cliquez sur Comment ce résultat a-t-il été calculé ?. La section Résumé inclut désormais une requête générée, suivie du résultat de la requête. Vous pouvez copier le code, puis cliquer sur Studio pour le coller dans l'éditeur de requête.

    Lorsque cela est approprié pour les données, l'agent de données fournit des graphiques, des tableaux et d'autres visualisations. Pour afficher l'historique de vos discussions, accédez à la liste Gestion des conversations.

    Pour afficher les informations sur l'agent, accédez au panneau Détails. Ce panneau inclut une description de l'agent et de ses sources de connaissances.

Gérer les conversations

Vous pouvez ouvrir, renommer ou supprimer une conversation sur la page Conversations.

Ouvrez une conversation existante.

  1. Dans la console Google Cloud , accédez à la page AlloyDB.

    Accéder à AlloyDB

  2. Sélectionnez un cluster dans la liste.

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

  4. Dans l'onglet Conversations, dans la liste des conversations, cliquez sur celle que vous souhaitez ouvrir.

Renommer une conversation

  1. Dans la console Google Cloud , accédez à la page AlloyDB.

    Accéder à AlloyDB

  2. Sélectionnez un cluster dans la liste.

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

  4. Dans l'onglet Conversations, dans la liste des conversations, cliquez sur celle que vous souhaitez renommer.

  5. Cliquez sur Afficher les actions > Renommer.

  6. Dans la boîte de dialogue Renommer la conversation, saisissez un nouveau nom pour la conversation dans le champ Nom de la conversation.

  7. Cliquez sur Renommer.

Supprimer une conversation

  1. Dans la console Google Cloud , accédez à la page AlloyDB.

    Accéder à AlloyDB

  2. Sélectionnez un cluster dans la liste.

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

  4. Dans l'onglet Conversations, dans la liste des conversations, cliquez sur celle que vous souhaitez supprimer.

  5. Cliquez sur Afficher les actions > Supprimer.

  6. Dans la boîte de dialogue Supprimer la conversation ?, cliquez sur Supprimer.

Emplacements

L'analyse conversationnelle fonctionne à l'échelle mondiale. Vous ne pouvez pas choisir la région à utiliser.

Étapes suivantes