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

Les agents de données vous permettent de gérer l'expérience Conversational Analytics pour vos données. Grâce aux agents, vous pouvez fournir à Conversational Analytics le contexte et les instructions nécessaires pour répondre plus efficacement aux questions dans des cas d'utilisation spécifiques. Les agents permettent aux analystes d'associer des 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

Considérez un agent de données comme un autre type de contenu Looker, tel qu'un tableau de bord, une présentation ou un dossier.

L'utilisation d'un agent de données est gérée par une combinaison d'accès au contenu, d'accès aux données et d'accès aux fonctionnalités. Pour effectuer les tâches décrites dans le tableau suivant, vous devez disposer d'un rôle Looker qui dispose des autorisations requises pour les modèles que votre agent de données interrogera et, dans certains cas, d'un accès à l'agent lui-même.

Tâche Autorisations Looker requises Niveau d'accès requis pour l'agent de données
Créer, modifier, partager et supprimer des agents Ajouté 25.18 admin_agents Aucun accès au contenu ne doit être accordé
Créer, modifier, partager et supprimer des agents Ajouté 25.18 save_agents

Les utilisateurs peuvent créer des agents qui n'utilisent que les explorations pour lesquelles ils ont reçu cette autorisation sur le modèle sous-jacent. Pour modifier, supprimer ou partager un agent de données créé par un autre utilisateur, les utilisateurs doivent disposer d'un rôle contenant cette autorisation sur chaque modèle utilisé par l'agent.		 Gérer l'accès ; Modifier (cet accès est accordé automatiquement si l'utilisateur crée l'agent. Sinon, l'accès Gérer l'accès ; Modifier doit être accordé par le créateur de l'agent en partageant l'agent)
Discuter avec un agent de données depuis l'onglet Agents de Conversational Analytics access_data (sur chaque modèle contenant les explorations utilisées par l'agent de données)

Ajouté 25.18 chat_with_agent (sur chaque modèle contenant les explorations utilisées par l'agent de données)		 Accès Afficher
Discuter avec une exploration Looker depuis l'onglet Explorations de Conversational Analytics access_data (sur chaque modèle contenant les explorations utilisées par l'agent de données)

Ajouté 25.18 chat_with_explore

Looker dispose également des rôles par défaut suivants, qui contiennent des sous-ensembles de ces autorisations pour tous les modèles de l'instance :

  • Gestionnaire d'agents Conversational Analytics : avec ce rôle, un utilisateur peut créer, modifier, partager, supprimer et discuter avec des agents pour lesquels il dispose d'un accès Gérer l'accès ; Modifier et discuter avec des explorations.
  • Utilisateur Conversational Analytics : avec ce rôle, un utilisateur peut discuter avec un agent pour lequel il dispose d'un accès Afficher.
  • Administrateur : par défaut, ce rôle (administrateur Looker) dispose de toutes les autorisations et de l'accès au contenu de l'instance.

Un administrateur Looker peut accorder ces rôles et autorisations sur la page Rôles de la section Admin de l'instance Looker. Pour en savoir plus sur les rôles Looker, consultez la page de documentation Paramètres d'administration – Rôles.

Le créateur de l'agent de données peut gérer l'accès des utilisateurs individuels à l'agent en partageant l'agent.

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 + Nouvel agent. Vous pouvez également, dans le panneau de gauche, sélectionner sparkGérer les agents, 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 partagerez l'agent avec eux. Assurez-vous donc que la description explique clairement l'objectif de l'agent et comment il peut être utile.
    • Données : procédez comme suit 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 un 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 les agents.

  5. Si vous le souhaitez, pour activer l'interpréteur de code pour toutes les conversations avec votre agent, sélectionnez Activer l'analyse avancée.

  6. Si vous le souhaitez, vous pouvez tester votre agent pour affiner vos instructions et ses paramètres.

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

Lorsque vous créez un agent de données, vous pouvez fournir les types de contexte suivants dans le champ Instructions :

  • Champs clés : champs les plus importants pour l'analyse
  • Champs exclus : champs que l'agent de données doit exclure
  • Filtrage et regroupement : champs que l'agent doit utiliser pour filtrer et regrouper les données
  • Synonymes : termes alternatifs pour les champs clés

Voici quelques exemples d'instructions à ajuster et à tester avec votre agent :

  • Sauf indication contraire, filtrez toujours les données sur Order Items Created Year = 2024
  • Nous considérons que les clients "fidèles" sont ceux dont Order Items Count > 5
  • Si quelqu'un parle de "Lieu", cela signifie "Ville de l'utilisateur"
  • Si la question mentionne "Seniors", il s'agit des utilisateurs dont User Age > 65
  • Si une question concerne les revenus, utilisez "Ventes totales"
  • Lorsque quelqu'un dit "par produit", sauf s'il précise "nom", regroupez par product category
  • Les commandes "réussies" signifient que l'état des éléments de commande est "Terminé"
  • Chaque fois qu'il y a une question concernant une chronologie ou une période, utilisez toujours Order Item Created Date comme champ de regroupement

Tester un agent

Lorsque vous créez ou modifiez un agent, la page de détails 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 qu'une modification soit reflétée 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 informations que vous avez spécifiées lors de la création de l'agent, y compris les champs Nom de l'agent, Description de l'agent, Données et Instructions. Vous pouvez également choisir d'activer l'interpréteur 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 un 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 un 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'autorisations dont ils doivent disposer, cliquez sur Ajouter pour les placer dans la liste partagée.
  4. Si vous souhaitez que les nouveaux utilisateurs ou groupes reçoivent un e-mail de notification, 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 modifiez en cliquant sur Partager sur la page des paramètres de l'agent et en suivant 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é de l'utilisateur ou des groupes dont l'accès doit être supprimé.
  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 pendant la propagation des modifications.

Si un utilisateur tente de poser d'autres questions une fois l'accès à un agent supprimé, le message suivant s'affiche : 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.

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. 1. Ouvrez le menu de l'agent choisi en cliquant sur son icône Plus d'options, puis cliquez sur Supprimer. 1. 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 sont supprimés définitivement au bout de 30 jours. Vous pouvez supprimer définitivement un agent de données manuellement ou vous pouvez le restaurer à partir de la corbeille avant qu'il ne soit définitivement supprimé. Si vous ne faites rien, l'agent sera 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 à partir de la corbeille

Pour restaurer un agent de données à partir de la corbeille, 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 Restaurer.