Résoudre les problèmes liés aux espaces Génie

Cette page explique comment résoudre les problèmes courants lors de la création et de la maintenance des espaces Génie.

Jargon métier mal compris

La plupart des entreprises ou des domaines utilisent des raccourcis spécifiques pour communiquer sur des événements spécifiques à l’entreprise. Par exemple, quand il est fait référence à une année, il peut s’agir systématiquement de l’année d’exercice, et cet exercice peut commencer en février ou mars au lieu de janvier. Pour permettre à Genie de répondre à ces questions de manière naturelle et précise, incluez des instructions qui mappent explicitement votre jargon métier aux mots et concepts compréhensibles par Genie. Consultez Fournir des instructions.

Utilisation de tables ou de colonnes incorrectes

Si Genie tente d’extraire des données d’une table incorrecte ou d’exécuter une analyse sur des colonnes incorrectes, vous pouvez ajuster les données d'une des manières suivantes :

• Fournissez des descriptions claires et précises : vérifiez vos tables et métadonnées associées pour vérifier que la terminologie utilisée correspond à la terminologie des utilisateurs dans les questions soumises. Si ce n’est pas le cas, affinez la description ou ajoutez une instruction qui mappe la terminologie utilisée dans la table à celle utilisée dans la question.
• Ajoutez des exemples de requêtes : fournissez des exemples de requêtes SQL que Genie peut utiliser pour apprendre à répondre à certaines questions. Consultez Fournir des instructions.
• Supprimez certaines tables ou colonnes de l’espace : certaines tables peuvent inclure des colonnes ou des concepts qui se chevauchent, ce qui empêche Genie de savoir quelles sont les données à utiliser dans une réponse. Si possible, supprimez les tables ou colonnes inutiles ou qui se chevauchent. Pour masquer les colonnes de l’interface utilisateur de l’espace Genie sans modifier les objets de données sous-jacents, consultez Masquer ou afficher les colonnes pertinentes.

Erreurs de filtrage

Les requêtes générées incluent souvent une clause WHERE pour filtrer les résultats en fonction d’une valeur spécifique. Lorsque Genie n’a pas de visibilité sur les valeurs de données, il peut définir la WHERE clause pour filtrer la valeur incorrecte. Par exemple, il peut essayer de faire correspondre le nom « Californie » lorsque la table utilise des abréviations telles que « CA ».

Pour les situations telles que celles-ci, vérifiez que les colonnes pertinentes ont des exemples de valeurs et des dictionnaires de valeurs activés . Si de nouvelles données ont été ajoutées aux tables pertinentes, actualisez les valeurs. Consultez Créer une base de connaissances pour obtenir des espaces Génie plus fiables.

Jointures incorrectes

Si les références de clé étrangère ne sont pas définies dans le catalogue Unity, votre espace peut ne pas savoir comment joindre différentes tables.

Essayez d'appliquer une ou plusieurs des solutions suivantes :

• Définissez des références de clés étrangères dans votre Unity Catalog quand cela est possible. Consultez la clause CONSTRAINT.
• Si les relations de clé étrangère de vos tables ne sont pas spécifiées dans le catalogue Unity, définissez les relations de jointure dans la base de connaissances de votre espace Génie. Cette stratégie est utile pour les scénarios de jointure plus complexes comme les jointures autonomes, ou si vous n’avez pas suffisamment d’autorisation pour modifier les tables sous-jacentes. Consultez Définir des relations de jointure.
• Fournissez des exemples de requêtes où vous joignez des tables de manière standard.

Si aucune de ces solutions ne résout le problème, vous pouvez joindre au préalable la table dans une vue, puis l’utiliser en tant qu’entrée pour l’espace à la place.

Commentaires de colonne non synchronisés à partir de tables étrangères

Azure Databricks ne gère pas les métadonnées, les données ou la sémantique pour les écritures dans des tables étrangères. Selon la table source, les commentaires peuvent ne pas être accessibles à partir d’Azure Databricks. Pour rendre les commentaires disponibles, Azure Databricks recommande d’effectuer l’une des opérations suivantes :

• Modifiez les métadonnées de colonne dans l’interface utilisateur de l’espace Génie. Les métadonnées modifiées s’appliquent uniquement à l’espace Genie où elle est écrite. Consultez Modifier les métadonnées de colonne.
• Créez des vues matérialisées sur des tables fédérées. Vous pouvez ajouter et modifier des commentaires sur une vue matérialisée comme vous le feriez sur une table gérée. Vous pouvez réutiliser cette vue dans plusieurs espaces Genie. Pour plus d’informations sur le chargement de données de tables étrangères vers une vue matérialisée, consultez Charger des données à partir de tables étrangères avec des vues matérialisées. Pour en savoir plus sur l’utilisation des vues matérialisées, consultez Vues matérialisées.

Problèmes de calcul de métriques

La façon dont les métriques sont calculées et regroupées peut être arbitrairement compliquée et englober de nombreux détails métier que votre espace ne comprend pas. Cela peut donner lieu à des rapports incorrects.

Essayez d'appliquer une ou plusieurs des solutions suivantes :

• Définissez vos métriques en tant qu’expressions SQL dans la base de connaissances. Les expressions SQL fournissent des définitions réutilisables et précises pour les mesures, les filtres et les dimensions que Genie peut appliquer de manière cohérente. Consultez Définir des expressions SQL.
• Si vos métriques sont agrégées à partir de tables de base, fournissez des exemples de requêtes SQL calculant chaque valeur de cumul.
• Si vos métriques ont été précalculées, et si elles se trouvent dans des tables agrégées, expliquez-le dans les commentaires de la table. Spécifiez des agrégations valides pour chaque métrique si les métriques de cette table peuvent être cumulées davantage.
• Si le SQL que vous essayez de générer est très compliqué, essayez de créer des vues ayant déjà agrégé les indicateurs de votre espace.

Calculs temporels incorrects

Genie peut ne pas toujours être en mesure de déduire le fuseau horaire représenté dans les données ou le fuseau horaire dans lequel votre analyse doit être effectuée, sauf si vous fournissez explicitement des conseils supplémentaires.

Incluez des instructions plus explicites détaillant le fuseau horaire source d’origine, la fonction de conversion et le fuseau horaire cible. Les exemples suivants montrent comment modifier les instructions générales pour les conversions de fuseau horaire plus fiables :

• Toujours convertir des heures en fuseau horaire spécifique: dans cet exemple, supposons que l’horodatage source est UTC et que vous souhaitez obtenir des résultats dans le fuseau horaire America/Los_Angeles. Ajoutez les instructions suivantes, en remplaçant <timezone-column> par le nom de colonne approprié :
  • Les fuseaux horaires dans les tableaux sont indiqués en UTC.
  • Convertissez tous les fuseaux horaires à l’aide de la fonction suivante : convert_timezone('UTC', 'America/Los_Angeles', <timezone-column>).
• Convertir les formats datetime non UTC en utc : si le fuseau horaire par défaut de l’espace de travail est UTC mais que les utilisateurs de Los Angeles doivent référencer aujourd’hui pour un ensemble spécifique d’enregistrements, ajoutez les instructions générales suivantes à l’espace :
  • Pour faire référence à aujourd’hui, utilisez date(convert_timezone('UTC', 'America/Los_Angeles', current_timestamp())).

Pour plus d’informations et de syntaxe, consultez convert_timezone la fonction .

Ignorer les instructions

Même si vous avez inclus des explications sur vos tables et colonnes dans les commentaires, et fourni des instructions générales, il est possible que votre espace ne les utilise pas correctement.

Essayez d'appliquer une ou plusieurs des stratégies suivantes :

• Fournissez des exemples de requêtes qui utilisent correctement vos tables. Les exemples de requête sont particulièrement efficaces pour apprendre à votre espace comment utiliser vos données.
• Masquer les colonnes non pertinentes dans l’espace Génie. Voir Masquer ou afficher les colonnes pertinentes.
• Créez des vues à partir de vos tables qui fournissent une vue plus simple de vos données.
• Passez en revue vos instructions et essayez de cibler l’espace en supprimant les tables ou les instructions non pertinentes.
• Essayez de démarrer une nouvelle conversation. Les interactions précédentes peuvent influencer les réponses de Genie dans une conversation donnée, mais le démarrage d’une nouvelle conversation vous donne un point de départ vide pour tester de nouvelles instructions.

Problèmes de performance

Quand Genie doit générer des requêtes ou des réponses textuelles exceptionnellement longues, sa réponse peut prendre beaucoup de temps ou même expirer pendant la phase de réflexion.

Essayez d'effectuer une ou plusieurs des actions suivantes pour améliorer les performances :

• Vérifiez l’historique des requêtes pour identifier les requêtes lentes. De nombreux problèmes de performances peuvent être résolus en optimisant les requêtes SQL générées plutôt que de modifier la configuration de l’espace Génie. Passez en revue les temps d’exécution des requêtes et les plans de requête dans l’historique des requêtes de votre entrepôt SQL pour identifier les goulots d’étranglement et les opportunités d’optimisation.
• Utilisez des ressources ou des vues approuvées pour encapsuler les requêtes complexes. Consultez Utiliser les ressources approuvées dans les espaces AI/BI Genie.
• Réduisez la longueur de vos exemples de requêtes SQL dans la mesure du possible.
• Démarrez une nouvelle conversation si Genie commence à générer des réponses lentes ou défaillantes.

Réponses non fiables à des questions stratégiques

Utilisez des ressources approuvées pour fournir des réponses vérifiées aux questions spécifiques que vous attendez de la part des utilisateurs. Consultez Utiliser les ressources approuvées dans les espaces AI/BI Genie.

Avertissement de limite de jeton

Les jetons sont les unités de base du texte, que Genie utilise pour traiter et comprendre le langage. Les instructions de texte et les métadonnées dans un espace Genie sont converties en jetons. Si votre espace s'approche de la limite des jetons, un avertissement apparaît. Genie utilise le filtrage de contexte pour hiérarchiser les jetons qu’il considère comme les plus pertinents pour une question. Bien que les réponses soient toujours générées lorsqu’un avertissement s’affiche, la qualité peut être réduite si un contexte important est filtré. Lorsque la limite de jeton est dépassée, vous ne pouvez plus envoyer ni recevoir de messages dans l’espace Génie.

Tenez compte des pratiques suivantes pour réduire le nombre de jetons :

• Supprimez les colonnes inutiles : les colonnes inutiles de vos tables peuvent contribuer considérablement à l’utilisation des jetons. Si possible, créez des vues pour exclure les champs redondants ou non essentiels de vos tables brutes. Vous pouvez également masquer les colonnes inutiles dans un espace Génie. Voir Masquer ou afficher les colonnes pertinentes.
• Simplifiez les descriptions des colonnes : Bien que les descriptions des colonnes soient importantes, évitez de dupliquer les informations déjà spécifiées dans les noms des colonnes. Par exemple, si une colonne est nommée account_name, une description telle que « le nom de votre compte » peut être redondante et peut être omise.
• Modifier les métadonnées de colonne dans l’espace Génie : consultez Modifier les métadonnées de colonne pour savoir comment modifier les descriptions et fournir des synonymes dans les métadonnées de colonne.
• Exemples de requêtes SQL : incluez une plage variée d’exemples de requêtes SQL pour couvrir différents types de questions, mais supprimez des exemples superposés ou redondants.
• Simplifiez les instructions : vérifiez que vos instructions sont claires et concises. Évitez les mots inutiles.

Votre compte n’est pas activé pour un traitement intergéographique

Genie est un Service désigné géré par Azure Databricks. Les Services désignés utilisent les Géos Databricks pour gérer la résidence des données. Les données ne peuvent pas être traitées dans la même zone géographique que l’espace de travail pour certaines régions. Si votre espace de travail se trouve dans l’une de ces régions, le traitement intergéographique doit être activé par votre administrateur de compte.

Atteindre les limites de débit

Lors de l’accès aux espaces Genie via l’interface utilisateur Azure Databricks, le débit est limité à 20 questions par minute par espace de travail, sur tous les espaces Genie.

Lors de l’accès aux espaces Genie à l’aide du niveau gratuit de l’API Conversation (préversion publique), le débit est limité à cinq questions par minute et par espace de travail, sur tous les espaces Genie. Consultez Utiliser l’API Genie pour intégrer Genie dans vos applications.