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 des 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 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 le contexte créé, vous pouvez obtenir une grande précision pour des questions métier spécifiques. Le contexte créé est le principal facteur clé que les créateurs d'agents peuvent utiliser pour améliorer la précision. Il inclut des descriptions de schémas, 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 visualisation des données.
  • Flexibilité : vous pouvez créer des agents pour vos tests personnels ou les publier pour les rendre disponibles aux 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 projet Google Cloud .

  2. Activez les API AlloyDB pour PostgreSQL, 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éez vos propres agents de données dans le projet : rôle 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.
  • 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.
  • 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 :

Pour travailler avec des ressources AlloyDB, comme afficher des tables ou exécuter des requêtes, consultez Rôles et autorisations IAM pour AlloyDB.

Créer un agent de données

Les sections suivantes expliquent 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 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 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 Nouvel agent s'ouvre.

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

  8. 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 à 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?).

  9. Dans la section Sources de connaissances, cliquez sur Ajouter une source. La page 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 Afficher plus.

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

Personnaliser les descriptions des tables et des champs

Pour améliorer la précision de l'agent de données conversationnel, 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'ont aucune incidence sur la table source. Vous pouvez ajouter les métadonnées suivantes :

  • Descriptions du 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 celles des définitions de vos 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. Cela permet de s'assurer que les autres agents bénéficient é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 Catalogue d'agents, ouvrez l'agent que vous souhaitez personnaliser.
  2. Cliquez sur Modifier l'agent.
  3. Dans Sources de connaissances, recherchez le tableau que vous souhaitez personnaliser, puis cliquez sur 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 Modifier le champ s'ouvre.
    1. Dans le champ ID, saisissez une description du champ.
    2. Pour enregistrer la description du champ, cliquez sur Mettre à jour.
  6. Pour enregistrer la description et les modifications apportées aux champs, cliquez sur Mettre à jour. La nouvelle page de l'agent se rouvre.
  7. Répétez ces étapes pour chaque tableau que vous souhaitez personnaliser.

Ajouter des libellés aux agents de données

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

  1. Dans l'onglet Catalogue d'agents, ouvrez l'agent auquel vous souhaitez ajouter un libellé.
  2. Cliquez sur Modifier l'agent.
  3. Dans la section Paramètres de l'agent, cliquez sur Ajouter un libellé. Le volet Gérer les libellés s'ouvre.
  4. Cliquez sur Ajouter une étiquette.
  5. Dans les champs key et value, saisissez la paire clé/valeur pour le libellé.
  6. Si vous souhaitez ajouter d'autres libellés, cliquez à nouveau sur Ajouter un libellé.
  7. Pour supprimer un libellé, cliquez sur Supprimer.
  8. Lorsque vous avez terminé, cliquez sur 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 Prévisualisation, saisissez un exemple de question dans le champ Poser une question, puis appuyez sur Entrée.

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

  3. Pour placer l'agent de données en mode brouillon, que vous pourrez modifier ultérieurement, cliquez sur Retour pour revenir à la page Catalogue d'agents. Comme votre agent est désormais en mode brouillon, il apparaît dans la section Mes agents en brouillon de l'onglet 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 pour utilisation dans le projet, cliquez sur Publier. La publication de l'agent permet à d'autres utilisateurs ayant accès aux mêmes tables de base de données de consulter votre agent et de discuter 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 console Google Cloud . 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 Votre agent a été publié, cliquez sur Partager pour partager l'agent de données avec d'autres utilisateurs.

    1. Dans le volet Autorisations de partage, cliquez sur Ajouter un compte principal.
    2. Dans le champ Nouveaux comptes principaux, saisissez un ou plusieurs comptes principaux.
    3. Cliquez sur la liste Sélectionner un rôle.
    4. Dans la liste 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 d'afficher l'agent de données.

  6. Cliquez sur Enregistrer.

  7. Pour revenir à la page du nouvel agent, cliquez sur Fermer. Une fois votre agent enregistré ou publié, vous pouvez le voir dans le catalogue d'agents.

Gérer les agents de données

Vous trouverez les agents existants dans l'onglet Catalogue d'agents, qui se compose de trois sections :

  • 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.
  • Mes brouillons d'agents : agents que vous n'avez pas encore publiés. Vous ne pouvez pas partager de brouillons d'agents.
  • Partagés par d'autres membres de votre organisation : agents créés et partagés avec vous par d'autres utilisateurs. 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 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 Agents.

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

  5. Cliquez sur l'onglet 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'agent, cliquez sur Ouvrir les actions, puis sur Modifier sur la fiche de l'agent.

  8. Modifiez la configuration de l'agent de données si nécessaire.

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

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

  11. Pour revenir au volet Agents, cliquez sur 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 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 Agents.

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

  5. Cliquez sur l'onglet 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'agent, cliquez sur Ouvrir les actions > cliquez sur Modifier sur la fiche de l'agent.

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

  9. Dans le volet Autorisations de partage, cliquez sur Ajouter un compte principal.

  10. Dans le champ Ajouter des comptes principaux, saisissez un ou plusieurs comptes principaux.

  11. Cliquez sur Sélectionner un rôle.

  12. Dans la liste 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) : permet 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 d'afficher l'agent de données.

  13. Cliquez sur Enregistrer.

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

  15. Pour revenir au volet Agents, cliquez sur Retour.

Supprimer un agent de données

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

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

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

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

  7. Cliquez sur Ouvrir les actions > Supprimer.

  8. Dans la boîte de dialogue Supprimer l'agent ?, cliquez sur Supprimer. Si vous supprimez définitivement l'agent, il sera retiré du projet.

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

Emplacements

Comme l'analyse conversationnelle a un mode de fonctionnement mondial, vous ne pouvez pas choisir la région à utiliser.

Étapes suivantes