Analyser des données avec des conversations

Ce document explique comment créer, modifier et supprimer des conversations dans Cloud SQL pour MySQL. 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 les noms des 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 proposés 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 Cloud SQL, 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'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

    Activer les API

Rôles requis

Pour travailler avec des agents de données, vous devez disposer de l'un des rôles IAM (Identity and Access Management) de l'API Conversational Analytics suivants :

  • Interrogez les données à partir de sources de données compatibles à l'aide de la méthode QueryData : Utilisateur de données de requête Gemini Data Analytics (roles/geminidataanalytics.queryDataUser) au niveau du projet.
  • Créer, modifier, partager et supprimer tous les agents de données du projet : Gemini Data Analytics Data Agent Owner (roles/geminidataanalytics.dataAgentOwner) au niveau du projet.
  • Créez vos propres agents de données dans le projet : Créateur d'agent des données des analyses de données Gemini (roles/geminidataanalytics.dataAgentCreator) au niveau du projet. Ce rôle vous attribue automatiquement le rôle Propriétaire d'agent des données des analyses de données Gemini sur les agents de données que vous créez.
  • Afficher et modifier tous les agents de données du projet : Éditeur d'agent des données des analyses de données Gemini (roles/geminidataanalytics.dataAgentEditor) au niveau du projet.
  • Affichez tous les agents de données du projet : lecteur d'agent de données Gemini Data Analytics (roles/geminidataanalytics.dataAgentViewer) au niveau du projet.

De plus, vous devez disposer des rôles suivants pour créer ou modifier un agent de données :

Lorsque vous gérez l'accès aux ressources de base de données Cloud SQL pour MySQL, tenez compte des niveaux d'autorisation suivants :

  • 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 et de systèmes d'utilisateurs et de rôles spécifiques aux bases de données.

Pour Cloud SQL pour MySQL, vous avez besoin 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 base de données qui se connecte doit disposer des droits d'accès nécessaires accordés à l'aide du système GRANT de Cloud SQL pour MySQL. Pour en savoir plus, consultez À propos des utilisateurs Cloud SQL pour MySQL. Si l'agent utilise un compte de service, vous pouvez lui attribuer un rôle de base de données. Pour en savoir plus, consultez Gérer les utilisateurs avec l'authentification IAM pour les bases de données.

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 Cloud SQL pour MySQL depuis l'onglet Catalogue d'agents de la page Agents.

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 utilisateurs 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 Cloud SQL pour MySQL.

    Accéder à Cloud SQL

  2. Sélectionnez une instance dans la liste.

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

  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 chat s'ouvre.

  6. Dans le champ Poser une question, saisissez une question pour l'agent de données. Par exemple, "Quelles ont été nos ventes totales le trimestre dernier ?" ou "Affiche-moi les cinq principaux utilisateurs par durée de session". 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 entreprend 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 afin d'afficher chaque message du processus de raisonnement de l'agent.

    Pour en savoir plus sur le calcul des résultats, 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 Agents.

Ouvrir une conversation existante

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

    Accéder à Cloud SQL

  2. Sélectionnez une instance dans la liste.

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

  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 Cloud SQL pour MySQL.

    Accéder à Cloud SQL

  2. Sélectionnez une instance dans la liste.

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

  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 Cloud SQL pour MySQL.

    Accéder à Cloud SQL

  2. Sélectionnez une instance dans la liste.

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

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

  5. Cliquez sur Afficher les actions > Supprimer.

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

Emplacements

Les analyses conversationnelles fonctionnent à l'échelle mondiale. Vous ne pouvez pas choisir la région à utiliser.

Étapes suivantes