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.

De manière générale, un agent de données est une combinaison de persona, d'un ensemble de sources de données et d'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 précision élevée pour des questions métier spécifiques. Le contexte créé est le principal facteur 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 des données.
  • Flexibilité : vous pouvez rédiger 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 Google Cloud projet.

  2. Activez Spanner, l'API Data Analytics avec Gemini et Gemini pour les Google Cloud API.

    Rôles requis pour activer les API

    Pour activer les API, vous avez besoin du rôle IAM Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

    Activer les API

Rôles requis

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

  • Interroger des données à partir de sources de base 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 : propriétaire d'agent des données des analyses de données Gemini (roles/geminidataanalytics.dataAgentOwner) au niveau du projet.
  • Créer 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 accorde automatiquement le rôle de 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.
  • Afficher tous les agents de données du projet : lecteur d'agent des données des analyses de données Gemini (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 :

Pour utiliser les ressources Spanner, consultez la section Rôles et autorisations Spanner.

Créer un agent de données

Les sections suivantes décrivent 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 Google Cloud console, accédez à la page Spanner.

    Accéder à Spanner

  2. Sélectionnez une instance dans la liste, puis sélectionnez une base de données.

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

  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 New agent (Nouvel agent) s'ouvre.

  7. Dans la section Editor (Éditeur), dans le champ Agent name (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 Agent description (Description de l'agent), saisissez une description de l'agent de données. Une bonne description explique ce que fait l'agent, les données qu'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? (Quels sont les 10 produits les plus vendus au deuxième trimestre ?)).

  9. Dans la section Knowledge sources (Sources de connaissances), cliquez sur Add source (Ajouter une source). La page Add data (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 Show more (Afficher plus).

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

Personnaliser les descriptions des tables et des champs

Pour améliorer la précision des agents de données conversationnels, vous pouvez éventuellement fournir des métadonnées de table supplémentaires. Seul l'agent de données utilise ces métadonnées, qui n'affectent pas la table source. Vous pouvez ajouter les métadonnées suivantes :

  • Descriptions de schéma : ajoutez des descriptions pour vos tables et vos 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 plutôt qu'à votre définition d'agent de données. Ainsi, les autres agents bénéficieront é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. Une fois que vous avez 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 configurer les descriptions des tables et des champs, procédez comme suit :

  1. Dans l'onglet Agent Catalog (Catalogue d'agents), ouvrez l'agent que vous souhaitez personnaliser.
  2. Cliquez sur Edit Agent (Modifier l'agent).
  3. Dans Knowledge Sources (Sources de connaissances), recherchez la table que vous souhaitez personnaliser, puis cliquez sur Customize (Personnaliser).
  4. Saisissez une description de la table.
  5. Pour modifier la description d'un champ, cliquez sur Modifier à côté du champ. Le volet Edit field (Modifier le champ) s'ouvre.
    1. Dans le champ ID, saisissez une description du champ.
    2. Pour enregistrer la description du champ, cliquez sur Update (Mettre à jour).
  6. Pour enregistrer la description et les mises à jour des champs, cliquez sur Update (Mettre à jour). La page du nouvel agent s'ouvre à nouveau.
  7. Répétez ces étapes pour chaque table que vous souhaitez personnaliser.

Ajouter des libellés aux agents de données

Dans la section Agent Settings (Paramètres de l'agent), vous pouvez créer des libellés pour organiser vos Google Cloud ressources. Les libellés sont des paires clé/valeur qui vous permettent de regrouper des objets associés ou de les combiner à d'autres Google Cloud ressources.

  1. Dans l'onglet Agent Catalog (Catalogue d'agents), ouvrez l'agent auquel vous souhaitez ajouter un libellé.
  2. Cliquez sur Edit Agent (Modifier l'agent).
  3. Dans la section Agent Settings (Paramètres de l'agent), cliquez sur Add label (Ajouter un libellé). Le volet Manage labels (Gérer les libellés) s'ouvre.
  4. Cliquez sur Add label (Ajouter un libellé).
  5. Dans les champs key (clé) et value (valeur), saisissez votre paire clé/valeur pour le libellé.
  6. Si vous souhaitez ajouter d'autres libellés, cliquez à nouveau sur Add label (Ajouter un libellé).
  7. Pour supprimer un libellé, cliquez sur Supprimer.
  8. Lorsque vous avez terminé, cliquez sur Add (Ajouter). La page du nouvel agent s'ouvre à nouveau.

Passez à la section suivante pour placer l'agent en mode brouillon ou le publier.

Prévisualiser et publier l'agent

  1. Dans la section Preview (Aperçu), saisissez un exemple de question dans le champ Ask a question (Poser une question), puis appuyez sur Enter (Entrée).

    Pour vérifier que l'agent de données renvoie les données attendues, examinez la réponse de l'agent. Si la réponse ne correspond pas à vos attentes, modifiez les paramètres de la section Editor (É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 Save (Enregistrer).

  3. Pour placer l'agent de données en mode brouillon, que vous pourrez modifier ultérieurement, cliquez sur Go back pour revenir à la page Agent Catalog. Comme votre agent est désormais en mode brouillon, il apparaît dans la section My draft agents (Mes agents brouillons) de l'onglet Agent Catalog (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 Publish (Publier). La publication de l'agent permet aux autres utilisateurs ayant accès aux mêmes tables de base de données de consulter votre agent et de converser 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 Agents de la Google Cloud console. 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 Your agent has been published (Votre agent a été publié), cliquez sur Share (Partager) pour partager l'agent de données avec d'autres utilisateurs.

    1. Dans le volet Share permissions (Partager les autorisations), cliquez sur Add principal (Ajouter un compte principal).
    2. Dans le champ New principals (Nouveaux comptes principaux), saisissez un ou plusieurs comptes principaux.
    3. Cliquez sur la liste Select a role (Sélectionner un rôle).
    4. Dans la liste Role (Rôle), sélectionnez l'un des rôles suivants :
      • Utilisateur d'agent des données des analyses de données Gemini (roles/geminidataanalytics.dataAgentUser) : accorde l'autorisation de discuter avec l'agent de données.
      • Éditeur d'agent des données des analyses de données Gemini (roles/geminidataanalytics.dataAgentEditor) : accorde l'autorisation de modifier l'agent de données.
      • Lecteur d'agent des données des analyses de données Gemini (roles/geminidataanalytics.dataAgentViewer) : accorde l'autorisation de consulter l'agent de données.

  6. Cliquez sur Save (Enregistrer).

  7. Pour revenir à la page du nouvel agent, cliquez sur Close (Fermer). Une fois que vous avez enregistré ou publié votre agent, vous pouvez le voir dans le Agent Catalog (Catalogue d'agents).

Gérer les agents de données

Vous pouvez trouver les agents existants dans l'onglet Agent Catalog (Catalogue d'agents), qui comporte trois sections :

  • My agents (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.
  • My draft agents (Mes agents brouillons) : agents que vous n'avez pas encore publiés. Vous ne pouvez pas partager d'agents brouillons.
  • Shared by others in your organization (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 Google Cloud console, accédez à la page Spanner.

    Accéder à Spanner

  2. Sélectionnez une instance dans la liste, puis sélectionnez une base de données.

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

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

  5. Cliquez sur l'onglet Agent Catalog (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'agents, cliquez sur Open actions (Ouvrir les actions), puis sur Edit (Modifier) sur la fiche de l'agent.

  8. Modifiez la configuration de l'agent de données selon vos besoins.

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

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

  11. Pour revenir au volet Agents, cliquez sur Go back (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 Google Cloud console, accédez à la page Spanner.

    Accéder à Spanner

  2. Sélectionnez une instance dans la liste, puis sélectionnez une base de données.

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

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

  5. Cliquez sur l'onglet Agent Catalog (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'agents, cliquez sur Open actions > Edit sur la fiche de l'agent.

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

  9. Dans le volet Share permissions (Partager les autorisations), cliquez sur Add principal (Ajouter un compte principal).

  10. Dans le champ Add principals (Ajouter des comptes principaux), saisissez un ou plusieurs comptes principaux.

  11. Cliquez sur Select a role (Sélectionner un rôle).

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

    • Utilisateur d'agent des données des analyses de données Gemini (roles/geminidataanalytics.dataAgentUser) : accorde l'autorisation de discuter avec l'agent de données.
    • Éditeur d'agent des données des analyses de données Gemini (roles/geminidataanalytics.dataAgentEditor) : accorde l'autorisation de modifier l'agent de données.
    • Lecteur d'agent des données des analyses de données Gemini (roles/geminidataanalytics.dataAgentViewer) : accorde l'autorisation de consulter l'agent de données.

  13. Cliquez sur Save (Enregistrer).

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

  15. Pour revenir au volet Agents, cliquez sur Go back (Retour).

Supprimer un agent de données

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

    Accéder à Spanner

  2. Sélectionnez une instance dans la liste, puis sélectionnez une base de données.

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

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

  5. Sélectionnez l'onglet Agent Catalog (Catalogue d'agents).

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

  7. Cliquez sur Open actions > Delete.

  8. Dans la boîte de dialogue Delete agent? (Supprimer l'agent ?), cliquez sur Delete (Supprimer). La suppression de l'agent le supprime définitivement du projet.

    Une fois que vous avez supprimé un agent, les conversations existantes sont disponibles en mode lecture seule. Vous ne pouvez plus poser de nouvelles questions à l'agent supprimé.

Emplacements

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

Étape suivante