Créer et gérer des agents de données Explore

Les agents de données vous permettent de personnaliser l'expérience d'analyse conversationnelle pour vos utilisateurs. Avec les agents, vous pouvez fournir à l'analyse conversationnelle du contexte et des instructions pour lui permettre de répondre plus efficacement aux questions pour des cas d'utilisation spécifiques. Les agents permettent aux analystes de mapper les termes commerciaux à des champs spécifiques, de spécifier les meilleurs champs pour le filtrage et de définir des calculs personnalisés.

Cette page vous guide tout au long des processus suivants :

Découvrez comment et quand Gemini pour Google Cloud utilise vos données.

Avant de commencer

L'utilisation de Conversational Analytics est gérée par une combinaison d'accès au contenu, aux données et aux fonctionnalités. Considérez un agent de données comme un autre type de contenu Looker, comme un tableau de bord, un Look ou un dossier. Pour interagir avec les agents de données, vous devez disposer d'un rôle Looker qui inclut les autorisations requises pour les modèles qui sous-tendent l'exploration individuelle ou que l'agent de données interrogera. Dans certains cas, vous aurez également besoin d'accéder à l'agent lui-même.

Pour en savoir plus sur les autorisations et l'accès requis pour gérer et utiliser les agents de données, consultez le tableau des autorisations sur la page de documentation Configurer Conversational Analytics dans Looker.

Les agents Explorer Conversational Analytics sont disponibles lorsqu'un administrateur Looker a activé les fonctionnalités suivantes sur la page d'administration Gemini dans Looker :

  • Conversational Analytics
  • Activer les fonctionnalités de testeur de confiance
    • Workflows agentiques [Aperçu]: pour créer des workflows agentiques qui indiquent à votre agent de surveiller les modifications apportées à vos données.
    • Requêtes validées [Aperçu]: définissez des requêtes validées, c'est-à-dire des paires de questions en langage naturel et de requêtes Explorer correspondantes, comme contexte pour votre agent. Cette fonctionnalité bêta n'est disponible que dans Looker (Original).
    • Publier sur Gemini Enterprise [Aperçu]: pour publier votre agent sur Gemini Enterprise, ce qui rend le contexte et les données analytiques prédéfinis de votre agent disponibles pour une audience plus large.

Créer et modifier des agents de données

Pour créer un agent de données, procédez comme suit :

  1. Accédez à la page Conversations.
  2. Dans l'onglet Agents, sélectionnez + New agent (Nouvel agent). Vous pouvez également sélectionner sparkGérer les agents dans le panneau de gauche, puis + Nouvel agent.

  3. Sur la page Nouvel agent, fournissez les informations suivantes sur votre agent de données.

    • Nom de l'agent : saisissez un nom pour l'agent. Le nom doit être unique et descriptif.
    • Description de l'agent : décrivez brièvement ce que cet agent peut faire et les données qu'il utilise. Les utilisateurs verront cette description lorsqu'ils sélectionneront l'agent pour démarrer une conversation ou lorsque vous le partagerez avec eux. Assurez-vous donc que la description explique clairement l'objectif de l'agent et comment il peut être utile.
    • Données : suivez ces étapes pour vous connecter à un maximum de cinq explorations Looker existantes :
      1. Dans le champ Données, cliquez sur + Sélectionner des explorations.
      2. Dans la fenêtre Rechercher des explorations, cliquez sur les explorations que vous souhaitez inclure dans l'agent de données. Ces explorations s'affichent dans le panneau Explorations sélectionnées de la fenêtre.
      3. Pour ajouter l'exploration sélectionnée à l'agent de données, cliquez sur Enregistrer.

  4. Instructions : fournissez du contexte pour aider Conversational Analytics à comprendre comment interagir avec vos données et fournir des réponses précises et pertinentes. Pour obtenir des exemples de types de contexte que vous pouvez fournir, consultez Rédiger des instructions pour l'agent.

  5. Si vous le souhaitez, vous pouvez activer l'analyse avancée pour toutes les conversations avec votre agent en sélectionnant Activer l'analyse avancée.

  6. Vous pouvez également sélectionner Options avancées pour développer la section et configurer les paramètres suivants :

    • Afficher le raisonnement : activez cette option pour afficher les étapes de raisonnement de l'agent, les requêtes Looker générées et les tables de données sous-jacentes dans les réponses.
    • Afficher les informations de débogage : activez cette option pour afficher les étapes exécutées par l'agent par réponse afin de faciliter le dépannage.

  7. Vous pouvez également tester votre agent pour affiner vos instructions et ses paramètres.

  8. Pour enregistrer votre nouvel agent de données, cliquez sur Enregistrer.

Une fois l'agent de données enregistré, vous pouvez le partager avec d'autres utilisateurs et démarrer une conversation avec lui.

Rédiger des instructions pour l'agent

Lorsque vous créez un agent de données, vous pouvez ajouter des instructions en texte libre qui définissent le comportement de base de votre agent de données et lui fournissent un contexte fondamental à prendre en compte avant de traiter une requête utilisateur.

Voici quelques exemples de types de contexte que vous pouvez fournir dans le champ Instructions :

  • Champs clés : champs les plus importants pour l'analyse
  • Champs exclus : champs que l'agent de données doit éviter
  • Filtrage et regroupement : champs que l'agent doit utiliser pour filtrer et regrouper les données
  • Persona : rôle, expertise, personnage ou ton que vous attribuez à l'agent

Pour obtenir des conseils et connaître les bonnes pratiques concernant la rédaction d'instructions pour les agents, consultez la page de documentation Bonnes pratiques pour configurer Conversational Analytics dans Looker.

Définir des requêtes validées

Les requêtes validées (également appelées requêtes de référence dans certaines documentations Google) sont des paires prédéfinies de questions en langage naturel et de leurs requêtes Explorer Looker exactes correspondantes. Ces paires de questions et de requêtes servent de "références" vérifiées pour la vérité. Elles apprennent à votre agent comment traiter les demandes commerciales complexes sans deviner. Des requêtes validées bien définies peuvent améliorer la précision des réponses de votre agent de données Explore.

Limites des requêtes validées

Lorsque vous utilisez des requêtes validées, gardez à l'esprit les limites suivantes :

  • Les requêtes validées ne sont disponibles que pour les agents de données Explore. Elles ne sont pas disponibles pour les conversations autonomes ni pour les agents de données de tableau de bord.
  • Vous devez utiliser une exploration déjà définie pour l'agent. Si vous faites référence à une exploration qui n'est pas utilisée par l'agent de données, le message d'erreur This query will not be used as it references an Explore that has not been defined in this agent. For best results, make sure that verified queries are based on Explores used in this agent. s'affiche.
  • Les requêtes validées ne sont pas compatibles avec les requêtes "Explorer" qui contiennent des champs ou des tableaux croisés dynamiques personnalisés.
  • Bien qu'il n'y ait pas de limite au nombre de requêtes validées que vous pouvez ajouter, nous vous recommandons de ne pas inclure plus de 30 à 50 paires question-requête par agent.

Créer une requête validée

Pour ajouter une requête validée à un agent de données nouveau ou existant, procédez comme suit :

  1. Créez un agent de données ou modifiez un agent de données existant qui utilise au moins une exploration comme source de données.
  2. Sur la page de création ou de modification de l'agent, sélectionnez + Ajouter une requête validée.
  3. Sous Ajouter une requête validée, saisissez la question en langage naturel et la réponse correspondante :
    • Question : saisissez une question en langage naturel qu'un utilisateur peut poser.
    • Réponse : collez l'URL de l'exploration qui capture la requête ou la visualisation correcte.
  4. Pour vérifier la requête Explorer, cliquez sur Aperçu.
    • Autre option : Laissez le champ Réponse vide et cliquez sur Prévisualiser pour créer une requête de A à Z dans l'explorateur, puis enregistrez l'URL obtenue pour l'utiliser.
  5. Cliquez sur Enregistrer.

Modifier une requête validée

Pour modifier une requête validée existante, procédez comme suit :

  1. Dans votre conversation avec l'agent, sélectionnez Modifier l'agent.
  2. Sous Requêtes validées, recherchez la requête validée que vous souhaitez modifier.
  3. Cliquez sur Modifier la requête validée.
  4. Dans la boîte de dialogue Modifier la requête validée, modifiez la question ou la réponse.
  5. Cliquez sur Enregistrer.

Supprimer une requête validée

Pour supprimer une requête validée, procédez comme suit :

  1. Dans votre conversation avec l'agent, sélectionnez Modifier l'agent.
  2. Sous Requêtes validées, recherchez la requête validée que vous souhaitez supprimer.
  3. Cliquez sur Supprimer la requête validée.

Tester un agent

Lorsque vous créez ou modifiez un agent, la page d'informations de l'agent inclut le volet Prévisualiser votre agent. Vous pouvez tester les paramètres et les instructions de l'agent en démarrant une conversation avec lui.

Vous devez cliquer sur Mettre à jour pour que les modifications soient reflétées dans l'aperçu. Si l'état d'enregistrement est Not saved, les modifications apportées aux paramètres ne seront pas reflétées dans l'aperçu.

Modifier un agent de données existant

Pour modifier un agent de données existant, procédez comme suit :

  1. Sur la page Conversations, sélectionnez sparkGérer les agents.
  2. Sur la page Gérer les agents, sélectionnez l'agent de données que vous souhaitez modifier.
  3. Modifiez les informations sur l'agent si nécessaire. Vous pouvez modifier les détails que vous avez spécifiés lorsque vous avez créé l'agent, y compris les paramètres Nom de l'agent, Description de l'agent, Données, Instructions et Options avancées. Vous pouvez également choisir d'activer l'interprète de code pour votre agent.
  4. Pour enregistrer vos modifications, cliquez sur Mettre à jour.

Partager des agents de données

Le partage permet à d'autres utilisateurs de discuter avec votre agent et ses explorations. Vous pouvez partager un agent de données avec d'autres utilisateurs en leur accordant l'accès au contenu de l'agent. Seul un utilisateur disposant des autorisations et de l'accès au contenu appropriés peut partager un agent. Une fois l'agent créé, il peut s'écouler quelques minutes avant qu'il ne puisse être partagé.

Pour partager un agent de données, procédez comme suit :

  1. Sur la page Conversations, sélectionnez sparkGérer les agents dans le panneau de gauche.
  2. Ouvrez le menu de l'agent choisi en cliquant sur son icône Plus d'options, puis cliquez sur Partager.
  3. Une fois que vous avez ajouté une personne ou des groupes à la section Qui peut accéder à cet agent ? et choisi le niveau d'autorisation à leur accorder, cliquez sur Ajouter pour les placer dans la liste partagée.
  4. Si vous souhaitez que les nouveaux utilisateurs ou groupes reçoivent une notification par e-mail, cochez la case Envoyer un e-mail aux personnes que vous venez d'ajouter.
  5. Une fois toutes les modifications effectuées, cliquez sur Enregistrer.

Vous pouvez également partager un agent que vous venez de créer ou que vous êtes en train de modifier. Pour ce faire, cliquez sur Partager sur la page des paramètres de l'agent, puis suivez les étapes mentionnées ci-dessus.

Révoquer l'accès à un agent de données

Pour révoquer l'accès à un agent, procédez comme suit :

  1. Sur la page Conversations, cliquez sur sparkGérer les agents dans le panneau de gauche.
  2. Ouvrez le menu de l'agent choisi en cliquant sur son icône Plus d'options, puis cliquez sur Partager.
  3. Cliquez sur le X à côté des utilisateurs ou des groupes dont vous souhaitez supprimer l'accès.
  4. Une fois toutes les modifications effectuées, cliquez sur Enregistrer.

Si les utilisateurs supprimés ont une conversation en cours, ils y auront toujours accès pendant une ou deux minutes le temps que les modifications soient appliquées.

Si un utilisateur tente de poser d'autres questions une fois l'accès à un agent supprimé, le message The agent in this conversation may not be shared with you, or may have been deleted. You can view any past conversations with the agent, but can't ask new questions. s'affiche.

Publier un agent de données

Vous pouvez publier votre agent de données dans Gemini Enterprise. Le contexte et les données analytiques prédéfinis de votre agent seront ainsi disponibles pour une audience plus large, y compris pour les utilisateurs qui ne connaissent pas l'interface Looker. Gemini Enterprise sert de hub central où les utilisateurs peuvent gérer les agents de données créés dans les applications Google Cloud . Cela les aide à trouver l'agent le mieux adapté à leurs besoins analytiques.

Avant de commencer

La procédure de création d'un agent de données dans Looker et de mise à disposition des utilisateurs dans Gemini Enterprise implique des tâches effectuées dans l'instance Looker, sur la page Gemini Enterprise de la console Google Cloud et dans l'instance Gemini Enterprise.

Les utilisateurs disposant des rôles suivants doivent suivre les étapes décrites dans les sections associées :

  1. Éditeurs d'agents de données (fonctionnalité Looker) : publiez l'agent dans Looker.
  2. Administrateur Discovery Engine (rôle IAM) : accordez l'accès à l'agent dans la console Google Cloud .
  3. Utilisateur Gemini Enterprise (rôle IAM) ; utilisateur de l'agent de données (fonctionnalité Looker) : discuter avec l'agent dans l'instance Gemini Enterprise.

Avant de pouvoir publier un agent, vous devez remplir les conditions suivantes :

  • Un administrateur Looker doit activer le paramètre Publier dans Gemini Enterprise sur la page Gemini dans Looker du panneau Administration.
  • Un administrateur Looker doit vous attribuer un rôle contenant l'autorisation publish_agent_externally. Vous devez également pouvoir modifier un agent de données.
  • Le compte de service Looker du projet Google Cloud qui héberge le moteur Gemini Enterprise doit disposer du rôle IAM Administrateur Discovery Engine. L'attribution de ce rôle permet d'attribuer une licence Gemini Enterprise au compte lorsque le premier agent de données est publié. Si aucune licence Gemini Enterprise n'est disponible pour être attribuée au compte de service Looker, l'erreur "Échec de l'allocation de quota pour la création de l'agent" s'affiche sur la page du moteur Gemini Enterprise dans la console Google Cloud . Un utilisateur disposant du rôle IAM Administrateur Discovery Engine doit ensuite provisionner une nouvelle licence Gemini Enterprise ou réattribuer une licence existante pour le compte de service Looker.

Publier un agent de données dans Gemini Enterprise

Pour effectuer les étapes décrites dans cette section, vous devez disposer d'un rôle Looker contenant l'autorisation publish_agent_externally et des autorisations et de l'accès au contenu appropriés pour modifier les agents de données.

Pour publier un agent, procédez comme suit :

  1. Modifiez l'agent.
  2. Sélectionnez Paramètres de publication pour ouvrir la fenêtre Paramètres de publication de l'agent.
  3. Dans la fenêtre Paramètres de publication de l'agent, activez le paramètre Gemini Enterprise, puis sélectionnez Mettre à jour. Si vous activez ce paramètre, l'agent est publié dans l'instance Gemini Enterprise affichée sur la page Gemini dans Looker du panneau Admin.
  4. Une fois votre agent publié, vous pouvez sélectionner Partager pour autoriser d'autres utilisateurs Looker à accéder à votre agent de données, ou sélectionner Démarrer une conversation pour ouvrir une nouvelle conversation avec l'agent de données.

Accorder aux utilisateurs l'accès à l'agent dans Gemini Enterprise

Pour effectuer les étapes décrites dans cette section, vous devez disposer du rôle Identity and Access Management Administrateur Discovery Engine pour le projet Google Cloud contenant le moteur Gemini Enterprise.

Pour pouvoir discuter avec un agent dans Gemini Enterprise, un utilisateur doit avoir accès à l'instance Gemini Enterprise et à l'agent concerné.

Pour accorder à un utilisateur l'accès à l'instance Gemini Enterprise, un administrateur Discovery Engine doit lui attribuer le rôle IAM Utilisateur Gemini Enterprise pour le projet Google Cloud contenant le moteur Gemini Enterprise.

Pour accorder à un utilisateur l'accès à un agent individuel, l'administrateur Discovery Engine doit procéder comme suit dans la console Google Cloud  :

  1. Accédez au projet Google Cloud contenant le moteur Gemini Enterprise.
  2. Ouvrez la page produit Gemini Enterprise.
  3. Sélectionnez la page Applications dans la navigation principale, puis sélectionnez le nom de l'instance Gemini Enterprise.
  4. Dans le menu de navigation principal, sélectionnez Agents.
  5. Sélectionnez l'agent auquel vous souhaitez accorder l'accès.
  6. Sélectionnez l'onglet Autorisations utilisateur.
  7. Sélectionnez Ajouter un utilisateur.
  8. Dans la fenêtre Ajouter des rôles avec des autorisations utilisateur à l'agent, ajoutez chaque utilisateur et attribuez-lui le rôle Utilisateur de l'agent.

Discuter avec l'agent dans Gemini Enterprise

Pour suivre les étapes décrites dans cette section, vous devez disposer du rôle Identity and Access Management Utilisateur Gemini Enterprise pour le projet Google Cloud contenant le moteur Gemini Enterprise. Vous devez également disposer des autorisations et de l'accès au contenu appropriés pour discuter avec l'agent dans l'instance Looker.

Pour discuter avec un agent de données dans une instance Gemini Enterprise, procédez comme suit :

  1. Ouvrez votre instance Gemini Enterprise.
  2. Sélectionnez Agents dans la navigation principale.
  3. Sur la page Agents, sélectionnez l'agent avec lequel vous souhaitez discuter. Lorsque vous sélectionnez un agent, une fenêtre de conversation s'ouvre pour vous permettre de poser des questions sur vos données.

La première fois que vous discutez avec un agent, vous devez autoriser l'accès de l'agent à votre identité Looker.

Supprimer un agent de données

Pour supprimer un agent de données, procédez comme suit :

  1. Sur la page Conversations, cliquez sur sparkGérer les agents dans le panneau de gauche.
  2. Ouvrez le menu de l'agent de votre choix en cliquant sur son icône Autres options, puis sur Supprimer.
  3. Dans la fenêtre Supprimer l'agent ?, cliquez sur Placer dans la corbeille pour supprimer l'agent de données.

Les agents placés dans la corbeille seront supprimés définitivement au bout de 30 jours. Vous pouvez supprimer définitivement un agent de données manuellement ou restaurer un agent de données à partir de la corbeille avant qu'il ne soit définitivement supprimé. Si vous ne faites rien, l'agent sera automatiquement supprimé définitivement au bout de 30 jours.

Supprimer définitivement un agent de données

Pour supprimer définitivement un agent de données, procédez comme suit :

  1. Accédez à la page Conversations.
  2. Dans le panneau de navigation de gauche, développez la section Corbeille.
  3. Pour ouvrir le menu de l'agent choisi, sélectionnez son icône , puis cliquez sur Supprimer définitivement.
  4. Dans la fenêtre Êtes-vous sûr ?, cliquez sur Supprimer définitivement.

Restaurer un agent de données depuis la corbeille

Pour restaurer un agent de données à partir de la corbeille :

  1. Accédez à la page Conversations.
  2. Dans le panneau de navigation de gauche, développez la section Corbeille.
  3. Pour ouvrir le menu de l'agent choisi, sélectionnez son icône , puis cliquez sur Restaurer.