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

Les agents de données vous permettent de personnaliser l'expérience Conversational Analytics pour vos données. Grâce aux 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

Considérez un agent de données comme un autre type de contenu Looker, comme 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, aux données et aux fonctionnalités. Pour effectuer les tâches décrites dans le tableau suivant, vous devez disposer d'un rôle Looker qui inclut les autorisations requises pour les modèles que votre agent de données interrogera et, dans certains cas, l'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

* Cette fonctionnalité est disponible pour les utilisateurs dont les instances Looker sont sur Looker 25.18.10 ou version ultérieure.		 Ajouté 25.18 save_agents 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		 Accès Afficher
Discuter avec une exploration Looker depuis l'onglet Explorations dans 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 propose également les 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 : ce rôle permet à un utilisateur de créer, modifier, partager et supprimer des agents pour lesquels il dispose d'un accès Gérer l'accès ; Modifier, et de discuter avec des explorations.
  • Utilisateur Conversational Analytics : ce rôle permet à un utilisateur de 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 à tous les contenus 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 :

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

  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, pour activer l'interpréteur de code pour toutes les conversations avec votre agent, sélectionnez Activer l'analyse avancée.

  6. Vous pouvez également 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 l'agent

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 éviter
  • Filtrer et regrouper : 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 qui ont Order Items Count > 5
  • Si quelqu'un mentionne "Localisation", cela signifie "Ville de l'utilisateur".
  • Si la question mentionne "Seniors", il s'agit des utilisateurs ayant User Age > 65
  • Si une question porte sur 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" sont celles dont l'état des articles commandés est défini sur "Terminée".
  • Chaque fois qu'une question porte sur une période ou une évolution au fil du temps, 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 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 champs Nom de l'agent, Description de l'agent, Données et Instructions. 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 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'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 en cliquant sur Partager sur la page des paramètres de l'agent, puis 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é 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.

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 de votre choix en cliquant sur son icône Autres options, puis 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 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.

  • Présentation de Conversational Analytics dans Looker : page de destination de Conversational Analytics avec une liste des principales fonctionnalités et des liens vers toute la documentation de Conversational Analytics.

  • Créer et gérer des agents de données : les agents de données vous permettent de personnaliser l'agent de requête de données optimisé par l'IA en fournissant un contexte et des instructions spécifiques à vos données. Cela aide Conversational Analytics à générer des réponses plus précises et contextuellement pertinentes.

  • Bonnes pratiques pour configurer Conversational Analytics dans Looker : stratégies et bonnes pratiques pour aider les administrateurs Looker et les développeurs LookML à configurer, déployer et optimiser Conversational Analytics.

  • Activer l'analyse avancée avec l'interpréteur de code : l'interpréteur de code de Conversational Analytics traduit vos questions en langage naturel en code Python et exécute ce code. Par rapport aux requêtes SQL standard, l'utilisation de Python par l'interpréteur de code permet des analyses et des visualisations plus complexes.