Analyser des données avec des conversations

Ce document explique comment créer, modifier et supprimer des conversations dans BigQuery. Les conversations sont des discussions persistantes avec un agent de données ou des sources de données (tables, vues ou graphiques, par exemple) que vous sélectionnez.

Les conversations sont des discussions persistantes avec un agent de données ou une source de données. Vous pouvez poser aux agents de données des questions en plusieurs parties qui utilisent des termes courants tels que "ventes" ou "le plus populaire", sans avoir à spécifier les noms des champs de table ni à définir de conditions pour filtrer les données. Vous pouvez également poser des questions sur les données contenues dans des objets tels que des PDF. Lorsqu'il construit une réponse, un agent peut déterminer les sources de données à interroger et tirer parti des optimisations, telles que les partitions de table ou les index de recherche.

La réponse du chat qui vous est renvoyée offre les fonctionnalités suivantes :

  • La réponse à votre question sous forme de texte, de code ou d'images (multimodale). La réponse peut inclure les fonctions d'IA et de ML BigQuery compatibles.
  • Génération de graphiques, le cas échéant.
  • Raisonnement de l'agent pour les résultats.
  • Métadonnées sur la conversation, telles que l'agent et les sources de données utilisées.

Lorsque vous créez une conversation directe avec une source de données, l'API Conversational Analytics interprète votre question sans le contexte ni les instructions de traitement qu'un agent de données propose. Par conséquent, les résultats des conversations directes peuvent être moins précis. Utilisez des agents de données pour les cas qui nécessitent une plus grande précision.

Vous pouvez créer et gérer des conversations dans BigQuery à l'aide de la consoleGoogle Cloud . Pour en savoir plus, consultez Analyser les données avec des conversations.

Avant de commencer

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

  2. Activez les API BigQuery, Gemini Data Analytics 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 créer des conversations, vous devez disposer de l'un des rôles IAM pour l'API Conversational Analytics suivants :

  • Pour afficher et créer des conversations avec n'importe quel agent de données partagé avec vous, vous devez disposer des rôles Utilisateur d'agent des données des analyses de données Gemini (roles/geminidataanalytics.dataAgentUser) et Utilisateur Gemini pour Google Cloud (roles/cloudaicompanion.user) au niveau du projet.
  • Pour créer une conversation directe, vous devez disposer du rôle Utilisateur sans état du chat des analyses de données Gemini (roles/geminidataanalytics.dataAgentStatelessUser).

De plus, vous devez disposer des rôles suivants dans les situations suivantes :

Si vous ne disposez pas des rôles appropriés sur les tables de données sources utilisées par l'agent de données, le système renvoie l'erreur suivante lorsque vous discutez avec l'agent de données :

Schema_Resolution: Access Denied

Bonnes pratiques

L'analyse conversationnelle exécute automatiquement des requêtes en votre nom pour répondre à vos questions. Tenez compte des facteurs suivants qui peuvent augmenter le coût des requêtes :

  • Grandes tailles de tables
  • Utilisation des jointures de données dans les requêtes
  • Appels fréquents aux fonctions d'IA dans les requêtes

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 existant dans la console Google Cloud  :

  1. Accédez à la page Agents de BigQuery.

    Accéder aux agents

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

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

    Un nouveau panneau de chat s'ouvre.

  4. Dans le champ Poser une question, saisissez votre question et choisissez un mode :

    • Réflexion (par défaut) : raisonnement détaillé.
    • Rapide : idéal pour la plupart des questions.

    Vous pouvez également cliquer sur l'une des questions suggérées par Gemini pour commencer.

  5. Cliquez sur send_spark Envoyer.

    L'API Conversational Analytics traite votre question et renvoie les résultats.

Créer une conversation directe avec une source de données

Vous pouvez créer une conversation directe avec ces sources de données BigQuery (également appelées sources de connaissances). 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.

Vous pouvez créer une conversation avec les sources de données suivantes :

  • Table
  • Afficher
  • Ensemble de données (bêta)
  • Graphique (Aperçu)

Discuter avec une source de données à l'aide de la page "Agents"

Pour créer une conversation avec une source de données à l'aide de la page Agents de la consoleGoogle Cloud , procédez comme suit :

Pour créer une conversation directe avec une source de données depuis la page Agents, procédez comme suit :

  1. Accédez à la page Agents de BigQuery.

    Accéder aux agents

  2. Dans l'onglet Conversations, cliquez sur Nouvelle conversation.

  3. Dans le volet Interrogez vos données, cliquez sur l'onglet Sources de connaissances. Si votre source de données n'apparaît pas dans la liste, vous pouvez la rechercher.

  4. Sélectionnez une ou plusieurs sources de données, puis cliquez sur Chat.

Échanger avec une source de données à l'aide de BigQuery Studio

Pour créer une conversation directe avec une source de données à l'aide de BigQuery Studio, choisissez l'une des options suivantes.

Discuter avec un ensemble de données, une table, une vue ou un graphique

Pour créer une conversation directe avec un ensemble de données, une table, une vue ou un graphique, procédez comme suit :

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

    Accéder à BigQuery Studio

  2. Dans le volet de gauche, cliquez sur Explorateur.

  3. Dans le volet Explorateur, développez votre projet, cliquez sur Ensembles de données, puis sélectionnez un ensemble de données. La page Ensembles de données s'ouvre.

  4. Cliquez sur un ensemble de données pour l'ouvrir.

  5. Pour discuter avec l'ensemble de données, cliquez sur chat_spark > Chat.

  6. Pour discuter avec une table ou une vue dans l'ensemble de données, procédez comme suit :

    1. Dans l'onglet Vue d'ensemble, cliquez sur Tableaux.

    2. Dans la colonne ID de la table, cliquez sur le lien vers la table ou la vue.

    3. Cliquez sur chat_spark Chat.

  7. Pour discuter avec un graphique, procédez comme suit :

    1. Dans l'onglet Vue d'ensemble, cliquez sur Graphiques.

    2. Dans la colonne ID du graphique, cliquez sur le lien vers le graphique.

    3. Cliquez sur chat_spark Chat.

Ensembles de données

Créer une conversation avec un ensemble de données vous permet de poser des questions sur vos données sans avoir à lister explicitement les sources de données. Lorsque vous créez une conversation avec un ensemble de données, l'agent de données a accès à toutes les tables de cet ensemble de données. Lorsque vous posez une question, l'agent de données recherche les tables pertinentes et les joint si nécessaire pour produire une réponse.

Discuter avec un résultat de requête

Vous pouvez créer une conversation avec les résultats après avoir exécuté une requête. La source de données est la table temporaire des résultats mis en cache, qui est généralement conservée pendant 24 heures. Une fois les résultats mis en cache expirés, vous ne pouvez plus poser de questions sur les données.

Pour créer une conversation à partir du résultat d'une requête, procédez comme suit :

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

    Accéder à BigQuery Studio

  2. Passez à l'onglet de l'éditeur de requête search_insights ou cliquez sur arrow_drop_down > Requête SQL.

  3. Saisissez votre requête SQL, puis cliquez sur play_circle Exécuter.

  4. Dans l'onglet Résultats, cliquez sur chat_spark Chat.

Discuter avec une source de données

Après avoir cliqué sur l'option Chat pour votre source de données, vous pouvez démarrer votre conversation. Pour ce faire :

  1. Dans le champ Poser une question, saisissez votre question et choisissez un mode :

    • Réflexion (par défaut) : raisonnement détaillé.
    • Rapide : idéal pour la plupart des questions.

  2. Cliquez sur send_spark Envoyer.

    L'API Conversational Analytics traite votre question et renvoie les résultats. Lorsque cela est approprié pour les données, la réponse fournit des images, des graphiques, des tableaux et d'autres visualisations.

  3. Pour voir chaque étape suivie par l'agent de données pour répondre à votre question, développez l'option Afficher le raisonnement dans la réponse.

    Ouvrir les résultats de l'option "Afficher le raisonnement"

  4. Pour en savoir plus sur le calcul des résultats, cliquez sur Comment ce résultat a-t-il été calculé ?.

    Détails du calcul de l'API, y compris la requête générée et le résultat de la requête.

    La section Résumé inclut la requête générée, suivie du résultat de la requête. Vous pouvez également ouvrir la requête dans l'éditeur de requête.

Créer un agent de données à partir d'une conversation

Vous pouvez créer un agent de données à partir d'une conversation avec une table ou une vue. Vous ne pouvez pas créer d'agent personnalisé à partir d'une conversation avec un ensemble de données.

Pour créer un agent de données à partir d'une conversation :

  1. Dans le panneau Détails d'une conversation, cliquez sur Créer un agent.

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

  3. 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 à savoir quand il s'agit de l'agent de données approprié avec lequel discuter (par exemple, Ask questions about customer orders and revenue).

  4. Dans la section Sources de connaissances, vérifiez l'entrée Sources de connaissances. Vous pouvez personnaliser la source de données existante ou cliquer sur Ajouter une source pour ajouter d'autres sources de données. Si votre source de données n'apparaît pas dans la liste, vous pouvez la rechercher.

  5. Une fois les modifications effectuées, cliquez sur Enregistrer le brouillon.

  6. Cliquez sur Publier.

Gérer les conversations

Vous pouvez ouvrir, renommer ou supprimer une conversation sur la page Agents, et gérer les conversations dans l'explorateur BigQuery Studio.

Ouvrir une conversation existante

  1. Dans la console Google Cloud , accédez à la page Agents de BigQuery.

    Accéder aux agents

  2. 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 Agents de BigQuery.

    Accéder aux agents

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

  3. Cliquez sur Afficher les actions > Renommer.

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

  5. Cliquez sur Renommer.

Supprimer une conversation

Les résultats des questions posées dans une conversation sont conservés même si les sources de données sous-jacentes sont supprimées. Pour supprimer une conversation et tous les résultats qu'elle contient, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Agents de BigQuery.

    Accéder aux agents

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

  3. Cliquez sur Afficher les actions > Supprimer.

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

Si vous ne mettez pas à jour une conversation pendant 180 jours, BigQuery la supprime automatiquement.

Gérer les conversations à l'aide de l'explorateur BigQuery Studio

Gérez les conversations à l'aide de l'explorateur BigQuery Studio. Cette liste de conversations vous permet de rechercher, d'ouvrir ou de créer des conversations de manière centralisée. Vous pouvez également copier l'ID de la conversation ou actualiser la liste des conversations.

Pour gérer vos conversations, procédez comme suit :

  1. Accédez à la page de l'explorateur BigQuery Studio.

    Accéder à l'explorateur

  2. Dans le volet Explorateur, développez le nom d'un projet.

  3. Cliquez sur Conversations.

    1. Pour filtrer la liste des conversations, saisissez un nom ou une valeur de propriété dans le champ de filtre.
    2. Pour ouvrir une conversation, cliquez sur Afficher les actions > Ouvrir.
    3. Pour copier un ID de conversation, cliquez sur Afficher les actions > Copier l'ID.
    4. Pour créer une conversation, cliquez sur Créer une conversation dans la barre de menu.
    5. Pour actualiser la liste, cliquez sur Actualiser dans la barre de menu.

Étapes suivantes