Agents Genie avec des tableaux de bord

Les tableaux de bord publiés incluent un Genie Agent par default pour permettre aux utilisateurs métier d'explorer les données en langage naturel. Un Genie Agent est une interface sans code qui fournit un bouton « Demander à Genie » sur les tableaux de bord publiés, permettant aux spectateurs de discuter avec les données au lieu de ne se fier qu'à des visualisations prédéfinies. Le bouton « Demander à Genie » est disponible pour les spectateurs à la fois dans le Workspace et lorsque les tableaux de bord sont intégrés à l'aide de l'intégration de base. Consultez les Agents Genie.

Lorsque vous publiez votre tableau de bord, l'option Activer Genie est activée par default, et Databricks génère automatiquement un Genie Agent basé sur les datasets et les visualisations de votre tableau de bord. Alternativement, vous pouvez Link un Genie Agent existant ou désactiver la bascule pour désactiver Genie.

Les agents compagnons Genie utilisent les concepts des agents Genie, ce qui permet à Genie de raisonner à travers plusieurs étapes et sources de données pour répondre à des questions complexes.

Pour plus d'informations sur les Agents Genie, consultez Agents Genie.

remarque

Ask Genie est uniquement disponible en intégration de base. Ask Genie n'est pas pris en charge dans Ask Genie n'est pas disponible en intégration externe. Pour les scénarios d'intégration externe, utilisez l'API Genie Conversation pour intégrer les capacités de requête en langage naturel.

Contrôler l'accès à l'agent Genie de votre tableau de bord

Pour activer ou configurer un Genie Agent pour votre tableau de bord publié :

1. Ouvrez votre tableau de bord.
2. Dans le panneau de droite, cliquez sur **Paramètres**. Ou, cliquez sur le menu kebab > **Paramètres** pour ouvrir les paramètres.
3. Cliquez sur Général .
4. Le bouton bascule Activer Genie est activé par default. Désactivez le bouton bascule si vous souhaitez désactiver le Genie Agent pour les spectateurs du tableau de bord.
5. (Facultatif) Pour link un Genie Agent existant, sélectionnez le bouton radio Link un Genie Agent existant et collez l'URL associée. Si vous ne sélectionnez pas cette option, Databricks génère automatiquement un nouveau Genie Agent basé sur votre tableau de bord lorsque vous publiez.

important

Lorsque les utilisateurs utilisent Genie, leurs questions reçoivent une réponse à partir des résultats complets du dataset query. Si un dataset query inclut des colonnes ou des lignes sensibles, ces données deviennent disponibles pour Genie même si elles ne sont pas affichées dans les visualisations. Définissez vos datasets pour inclure uniquement les champs et les lignes auxquels vous souhaitez que les utilisateurs aient accès. Consultez Permissions pour les Genie Agents.

remarque

Les Agents Genie compagnons n'apparaissent pas dans votre navigateur de fichiers ni dans la page de listing Genie. Lorsque vous republiez votre tableau de bord avec des modifications, le Genie Agent associé se met automatiquement à jour pour refléter les nouveaux datasets et visualisations.

Ouvrir l'agent Genie Agent

Pour ouvrir le Genie Agent publié dans une nouvelle fenêtre :

1. Cliquez sur le menu kebab dans le coin supérieur droit de la fenêtre de chat.
2. Cliquez sur Ouvrir Genie Agent .

remarque

Vous ne pouvez pas modifier les instructions des Genie Agents générés automatiquement depuis l'interface utilisateur de Genie Agent. Le Genie Agent se met à jour lorsque vous republiez le tableau de bord avec des modifications.

Interroger Genie à propos d'un graphique spécifique

Pour interroger Genie à propos d'un graphique de tableau de bord spécifique :

1. Cliquez sur Demander à Genie à partir d'un tableau de bord publié et activé pour Genie.
2. Cliquez sur un graphique de tableau de bord pour le sélectionner. Genie affiche le titre du graphique sélectionné dans la fenêtre de chat.
3. Posez des questions sur les données représentées dans le graphique sélectionné.

Demander à Genie d'expliquer les changements de graphique

Vous pouvez demander à Genie d'expliquer les changements directement à partir du graphique pour les visualisations de séries chronologiques en barres, linéaires et de zones (y compris les graphiques multi-séries et empilés), les cellules de tableau croisé dynamique, les histogrammes horizontaux, les graphiques circulaires et les cartes thermiques. Genie entre en mode Agent pour analyser le changement et identifier les principaux drivers.

Pour expliquer un changement de graphique :

1. Cliquez sur Demander à Genie à partir d'un tableau de bord publié et activé pour Genie.
2. Cliquez avec le bouton droit sur une visualisation prise en charge.
3. Sélectionnez l'option pour demander à Genie d'expliquer le changement.

Genie analyse le changement sélectionné et fournit une explication avec les principaux facteurs contributifs.

Autorisations pour les agents Genie

Les autorisations dépendent du fait que le Genie Agent ait été auto-généré ou lié.

Les agents Genie générés automatiquement suivent le modèle d'informations d'identification du tableau de bord :

• Si le tableau de bord utilise des informations d'identification intégrées (permission de partage de données), le Genie Agent utilise également des informations d'identification intégrées. Genie utilise les informations d'identification de l'éditeur pour accéder aux données, de sorte que les spectateurs peuvent interagir avec Genie même s'ils n'ont pas d'accès direct aux données sous-jacentes.
• Si le tableau de bord utilise les identifiants du visualiseur, le Genie Agent utilise également les identifiants du visualiseur. Les autorisations d'accès aux données propres à chaque utilisateur s'appliquent.

Les Genie Agents liés utilisent toujours les paramètres d'identification configurés sur le Genie Agent lui-même. Les paramètres d'identification du tableau de bord n'ont aucun effet sur un Genie Agent lié.

Dans tous les cas, les spectateurs doivent être membres du workspace pour interagir avec les agents Genie. Pour en savoir plus sur les types d'accès, consultez Gérer l'accès aux tableaux de bord et à Genie.

Modifier la description du Genie Agent de votre tableau de bord

Databricks génère automatiquement une description basée sur le contenu de votre tableau de bord. Vous pouvez modifier la description à tout moment.

Pour modifier la description :

1. Ouvrir le Genie Agent.
2. Cliquez sur Configurer .
3. Cliquez sur l'icône de modification à côté de **Description**.
4. Saisissez ou modifiez la description, puis cliquez sur Enregistrer .

Expressions SQL incompatibles

Les agents Genie liés ne peuvent pas utiliser de datasets contenant les expressions SQL suivantes :

• Clause d'identificateur avec une chaîne non constante, comme dans l'exemple suivant.

  SQL

  SELECT * FROM identifier(:param)

• Vues ou fonctions temporaires dans des datasets multi-énoncés, comme dans l'exemple suivant.

  SQL

  CREATE OR REPLACE TEMPORARY VIEW taxis AS SELECT * FROM samples.nyctaxis.trips;
  
  SELECT * FROM taxis;

• Référencement d'un volume dans la requête SQL qui définit le dataset, comme dans l'exemple suivant.

  SQL

  SELECT * FROM csv.`/Volumes/catalog/schema/volume/my-data.csv`

remarque

Si seulement certains jeux de données de votre tableau de bord utilisent des expressions non prises en charge, Genie utilise les jeux de données pris en charge et ignore ceux qui ne le sont pas au lieu d'échouer. Par exemple, si un dataset utilise IDENTIFIER() ou une UDF, Ask Genie répond toujours aux questions des datasets pris en charge restants.

OpenSharing

Les datasets partagés à l'aide d'OpenSharing ne sont pas pris en charge dans les agents Genie qui utilisent des identifiants intégrés (autorisation de données partagées). OpenSharing utilise un système d'informations d'identification qui est incompatible avec la délégation d'informations d'identification de Genie. Pour utiliser ces dataset avec Genie, utilisez les identifiants de l'invité au lieu des identifiants intégrés.

Limitations

• Ask Genie n'est pas pris en charge dans l'intégration externe. Pour les scénarios d'intégration externe, utilisez l'API de conversation Genie. Consultez Ask Genie n'est pas disponible dans l'intégration externe.
• Vous ne pouvez pas modifier les instructions des agents Genie générés automatiquement depuis l'interface utilisateur de Genie Agent.
• Les agents Genie compagnons prennent en charge jusqu'à 30 jeux de données de tableau de bord. Si votre tableau de bord utilise plus de 30 datasets, seuls 30 sont inclus dans le Genie Agent.
• Les filtres du tableau de bord ne sont pas reportés dans le contexte du chat lors de l'utilisation d'un Genie Agent lié. Les filtres du tableau de bord fonctionnent comme prévu avec les Genie Agents autogénérés.
• Ask Genie ignore les jeux de données qui contiennent des clauses d'identifiant avec des chaînes non constantes, des vues ou fonctions temporaires, ou des références de volume, et répond à partir des jeux de données pris en charge restants. Voir Expressions SQL incompatibles.
• Les jeux de données partagés via OpenSharing ne sont pas pris en charge dans les agents Genie qui utilisent des identifiants intégrés. See OpenSharing.