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, telles que des tables ou des vues, que vous sélectionnez.

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. Un agent peut déterminer les sources de données à interroger et profiter des optimisations, telles que les partitions de table, lorsqu'il construit une réponse. La réponse de chat contient la réponse à votre question sous forme de texte et de code, et inclut le raisonnement qui sous-tend les résultats. La réponse peut également inclure des images et des graphiques, le cas échéant.

Vous pouvez créer une conversation avec un agent de données ou une conversation directe avec une ou plusieurs tables. 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 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 des conversations

Vous pouvez créer une conversation avec un agent de données personnalisé existant. Vous pouvez également créer une conversation directement avec une seule source de données pour obtenir des réponses rapides à des questions ponctuelles.

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

  4. Cliquez sur Démarrer une conversation. Un nouveau panneau de chat s'ouvre.

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

Pour créer une conversation avec une source de données dans la console Google Cloud , sélectionnez l'une des options suivantes :

Page "Agents"

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, dans le volet Interrogez vos données, cliquez sur Sources de données.

  3. Sélectionnez une ou plusieurs sources de données, puis cliquez sur Créer une conversation.

Éditeur BigQuery

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

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

    Accéder à BigQuery

  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. L'aperçu de l'ensemble de données s'ouvre.

  4. Sélectionnez une source de données, comme un tableau, une vue ou un graphique. La ressource s'ouvre.

  5. Dans la barre de menu, cliquez sur Créer une conversation.

  6. Facultatif : Pour créer une conversation à partir des résultats de votre requête lorsque vous exécutez une requête, cliquez sur Créer une conversation dans le volet Résultats de la requête. La source de données est la table temporaire des résultats mis en cache, qui persiste généralement pendant 24 heures. Une fois les résultats mis en cache expirés, vous ne pouvez plus poser de questions sur les données.

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

  1. Dans le volet Données d'une conversation, dans la section Actions rapides, cliquez sur Créer un agent.
  2. Suivez la procédure pour créer un agent.

Avoir une conversation

Dans le champ Poser une question, saisissez une question pour l'agent de données. Vous pouvez également cliquer sur l'une des questions suggérées par Gemini pour commencer.

L'API Conversational Analytics traite votre question et 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.

Ouvrir les résultats de la fonctionnalité "Afficher le raisonnement"

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

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

Lorsque cela est approprié pour les données, la réponse fournit des images, des graphiques, des tableaux et d'autres visualisations.

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.

Emplacements

Comme l'analyse conversationnelle a un mode de fonctionnement mondial, vous ne pouvez pas choisir la région à utiliser. Il est possible que vos conversations ne soient pas stockées dans la même région que leurs sources de données.

Étapes suivantes