Aller au contenu principal

Améliorer la qualité de Genie Agent

Améliorez la précision et la fiabilité de Genie Agent en ajoutant des exemples de requêtes SQL, des fonctions Unity Catalog, des instructions en texte brut et des extraits de magasin de connaissances (descriptions de tables, relations JOIN et expressions SQL pour la sémantique métier).

remarque

Les agents Genie étaient auparavant appelés Genie space.

Ajouter des exemples et des instructions SQL

Vous pouvez ajouter des exemples de requêtes SQL, des fonctions Unity Catalog et des instructions en texte brut pour aider à générer des réponses précises. Cliquez sur Configurer > Instructions . Utilisez l' SQL Queries tab pour gérer les requêtes et les fonctions Unity Catalog. Utilisez l'onglet tab pour ajouter des instructions en texte brut.

Chaque Genie Agent a deux limites distinctes :

  • Instructions (100 par agent) : Chaque exemple de query SQL, chaque fonction SQL et le bloc de texte complet des instructions générales comptent comme une seule instruction.
  • Extraits du magasin de connaissances (200 par agent) : les descriptions de table, les relations de jointure et les expressions SQL (mesures, filtres et dimensions) partagent cette limite. Consultez Afficher les colonnes, Définir les relations de jointure et Définir les expressions SQL.

Un Genie Agent vise à fournir des réponses cohérentes et prévisibles basées sur des instructions claires et précises. Étant donné que Genie fonctionne de manière non déterministe, il est important de fournir des instructions exemptes d'informations conflictuelles ou ambiguës afin de minimiser le risque de réponses indésirables. Lors de la configuration de l'agent, une tâche clé consiste à examiner et à résoudre les incohérences. Cela permet d'obtenir des résultats fiables.

Ajoutez des exemples de requêtes et de fonctions SQL

Utilisez l'onglet SQL tab pour ajouter ce qui suit :

  • **Exemples de queries (Recommandé) :** Les exemples de queries SQL aident Genie à générer le SQL correct pour répondre aux questions courantes des utilisateurs. Les requêtes peuvent être statiques ou paramétrées. Pour chaque exemple de requête SQL, fournissez le code SQL et utilisez la formulation la plus courante de la question de l'utilisateur comme titre. Ceci améliore la capacité de Genie à faire correspondre les invites à l'exemple. Genie peut soit utiliser la query exemple directement, soit en tirer des leçons pour gérer des questions similaires. Les utilisateurs disposant des privilèges CAN EDIT dans l'agent peuvent afficher la query utilisée pour générer la réponse, ce qui facilite le dépannage et l'affinage.

  • Fonctions SQL : pour les questions auxquelles il n’est pas possible de répondre avec une query SQL statique ou paramétrée, vous pouvez enregistrer une fonction personnalisée dans Unity Catalog. Les fonctions peuvent être partagées entre vos équipes et utilisées par Genie pour répondre à des questions spécifiques. Pour en savoir plus sur l’utilisation des fonctions SQL dans votre Genie Agent, consultez les assets approuvés.

Comment Genie utilise les exemples de requêtes

Les queries d’exemple montrent à Genie comment utiliser les données disponibles pour répondre aux questions. Saisissez une question d'exemple dans le champ de texte, puis saisissez une query SQL qui répond à cette question. Rédigez l'exemple de question telle qu'un utilisateur la poserait naturellement. Lorsque Genie reçoit une question correspondante, il peut utiliser la query d'exemple directement pour fournir une réponse. Lorsque Genie reçoit une question similaire, il utilise les indices de la query d’exemple pour apprendre et structurer le SQL fourni dans la réponse. Concentrez-vous sur la fourniture d'exemples qui mettent en évidence la logique unique à votre organisation et à vos données, comme dans l’exemple suivant :

SQL
  -- Return our current total open pipeline by region.
-- Opportunities are only considered pipelines if they are tagged as such.
SELECT
a.region__c AS `Region`,
sum(o.amount) AS `Open Pipeline`
FROM
sales.crm.opportunity o
JOIN sales.crm.accounts a ON o.accountid = a.id
WHERE
o.forecastcategory = 'Pipeline' AND
o.stagename NOT ILIKE '%closed%'
GROUP BY ALL;

Ajouter des parameters de query

Les requêtes d’exemple paramétrées permettent aux utilisateurs de l’agent de spécifier une valeur qui est insérée dans la requête au moment de l’exécution. Avec les paramètres, Genie peut prendre des entrées spécifiques des questions de l’utilisateur et réutiliser la structure d’une requête d’exemple pour fournir des réponses vérifiées.

Pour ajouter un parameter à une query :

  1. Placez votre curseur à l’endroit où vous souhaitez insérer le paramètre.

  2. Cliquez sur Ajouter un paramètre .

    Ceci crée un nouveau paramètre avec le nom default parameter. Pour modifier le nom, remplacez-le dans l'éditeur de query. Vous pouvez également ajouter un parameter en tapant un deux-points suivi d'un nom de parameter (:parameter_name) directement dans l'éditeur.

Pour modifier un paramètre, cliquez sur Icône d'engrenage. à côté du nom du paramètre. Une boîte de dialogue **Détails du paramètre** comprend les options suivantes :

  • Mot-clé : Mot-clé représentant le parameter dans la query. Vous pouvez uniquement le modifier en éditant directement le texte de la query.
  • **Type de données** : Les types pris en charge incluent **Chaîne**, **Date**, **Date et heure**, **Décimal** et **Entier**. The default is String .
  • Commentaire : Une description des valeurs ou limites possibles pour le paramètre. Utilisez ceci pour fournir un contexte qui aide Genie à sélectionner la bonne valeur.
remarque

Si la valeur d’entrée ne correspond pas au type sélectionné, Genie la traite comme un type incorrect, ce qui peut entraîner des résultats inexacts.

En mode conversationnel, lorsque le texte exact d'une query paramétrée est utilisé dans une réponse, Genie fournit une réponse vérifiée. Voir Assets de confiance.

Assets de confiance

Les actifs fiables sont des exemples de requêtes SQL et de fonctions SQL qui fournissent des réponses vérifiées aux questions que vous anticipez de la part des utilisateurs. Lorsque Genie utilise un actif fiable pour répondre à une question, il fournit une réponse vérifiée, ce qui donne aux utilisateurs de l'agent une couche de confiance supplémentaire quant à l'exactitude du résultat.

Les assets de confiance incluent :

  • Exemples de query SQL paramétrées : En mode conversation, lorsque le texte exact d’une query paramétrée est utilisé pour générer une réponse, Genie fournit une réponse vérifiée. Les utilisateurs Agent peuvent modifier la valeur du parameter et réexécuter la query. Voir Ajouter des paramètres de query.
  • **Fonctions SQL** : les fonctions SQL enregistrées dans Unity Catalog peuvent être ajoutées à un Genie Agent. Voir Comment Genie utilise-t-il les fonctions SQL ?.

Les utilisateurs disposant au minimum de la permission CAN EDIT sur un Genie Agent peuvent ajouter ou supprimer des assets de confiance. Les utilisateurs d'agents doivent disposer de la permission EXECUTE sur toutes les fonctions SQL utilisées comme assets de confiance.

Fournir des conseils d'utilisation

Vous pouvez fournir à Genie un contexte supplémentaire pour expliquer quand un exemple de query est particulièrement pertinent.

Guide d'utilisation de la saisie de texte.

Pour ajouter des conseils d'utilisation :

  1. Cliquez sur Configurer > Instructions > SQL Queries pour accéder à la liste des exemples de queries.
  2. Cliquez sur un exemple de query.
  3. Cliquez sur Conseils d’utilisation près du bas de l'écran.
  4. Saisissez les détails sur la manière et le moment d'utiliser cette query d'exemple.

Comment Genie utilise-t-il les fonctions SQL ?

Les fonctions SQL sont utiles lorsqu'une question implique une logique complexe qui ne peut pas être saisie avec une requête statique ou paramétrée. Ils sont stockés dans Unity Catalog et peuvent être appelés par Genie à l’aide de paramètres fournis par l’utilisateur. Genie ne peut pas afficher ou modifier le SQL utilisé dans la fonction, ce qui rend cette approche bien adaptée à une logique qui ne devrait pas être exposée ou modifiée. Pour obtenir des conseils sur l'enregistrement d'une fonction dans Unity Catalog, consultez Créer une fonction de table SQL et Fonctions définies par l'utilisateur (UDF) SQL et Python dans Unity Catalog.

Fournir des instructions

Cliquez sur l'onglet tab pour rédiger des instructions en texte brut qui aident Genie à comprendre comment répondre à des questions spécifiques concernant votre entreprise. Vous pouvez mettre en forme les instructions comme une seule note complète ou les classer par sujet pour une meilleure organisation.

Les instructions aident à guider les réponses de Genie afin qu'il puisse traiter le jargon, la logique et les concepts uniques d'un domaine donné. Les instructions textuelles générales s'appliquent à tous les prompts. Si une instruction n'est pertinente que pour un sous-ensemble de prompts, elle doit être incluse en tant qu'exemple de query ou de fonction, ou documentée dans la table pertinente en tant que commentaires ou métadonnées. Les instructions textuelles ne sont uniquement destinées qu'au contexte devant être appliqué globalement et ne rentrant pas dans les autres formats.

L'exemple suivant inclut les informations que vous pourriez inclure dans les instructions générales :

- **Company-specific business information**:
- Fiscal year starts in February, for example fiscal year 26 or FY26 is February 1, 2026 through January 31, 2027
- **Formatting**:
- Always respond in Spanish
- If no other specification exists, round all decimals to two places
- Omit commas in results for any column including "Id" or "id" or "\_id"

Construire une base de connaissances

Le magasin de connaissances Genie vous permet d’organiser et d’améliorer votre agent grâce à des métadonnées localisées, à la correspondance d’invites et à des instructions SQL structurées. Ces fonctionnalités aident Genie à comprendre vos données et à générer des réponses plus précises et pertinentes.

Qu'est-ce qu'un magasin de connaissances ?

Un magasin de connaissances est une collection de définitions sémantiques organisées qui améliore la compréhension de vos données par Genie et la précision des réponses.

La base de connaissances se compose de :

  • Personnalisation des métadonnées au niveau de l'agent : descriptions spécifiques à l'agent pour les tables, les colonnes, les termes commerciaux et les synonymes.
  • Personnalisation des données au niveau de l'agent : datasets simplifiés et ciblés sans modifier les tables Unity Catalog sous-jacentes.
  • Correspondance des invites : Exemples qui aident Genie à faire correspondre les valeurs les plus pertinentes par rapport à la question de l'utilisateur et à corriger les problèmes d'orthographe dans les invites de l'utilisateur. Cela inclut l'assistance au format et la correspondance des entités.
  • Relations de jointure : Relations de table définies pour des instructions JOIN précises.
  • Expressions SQL : Définitions structurées de mesures, de filtres et de dimensions qui capturent la logique métier.
remarque

Chaque Genie Agent prend en charge un maximum de 200 extraits de base de connaissances. Les descriptions de tables, les relations de jointure et les expressions SQL (mesures, filtres et dimensions) sont prises en compte dans cette limite. Les instructions textuelles, les exemples de requêtes SQL, les fonctions SQL, les descriptions de colonnes et les paramètres de correspondance des invites ne sont pas pris en compte dans cette limite.

Toutes les configurations de la base de connaissances sont limitées à votre Genie Agent et n'affectent pas les métadonnées du Unity Catalog ou d'autres actifs Databricks.

Gérer les métadonnées du magasin de connaissances

Enseignez à Genie les données de votre agent en fournissant des descriptions de tables et de colonnes locales et en ajoutant des synonymes de colonnes qui s'alignent sur les termes commerciaux courants. Simplifiez les datasets en masquant les colonnes inutiles ou en double pour que Genie reste concentré.

Ces pratiques améliorent la convivialité pour les utilisateurs qui n'ont pas d'autorisations directes sur les tables sous-jacentes, et elles prennent également en charge des itérations plus rapides lors de la mise à jour des versions d'instructions.

Pour accéder aux métadonnées au niveau de l'agent, cliquez sur Configurer > Données dans votre Genie Agent. Cliquez ensuite sur le nom d'une table pour afficher ses métadonnées et ses colonnes.

Afficher les colonnes

Cliquez sur un nom de table pour afficher un aperçu des noms de colonnes et des détails. L'exemple suivant présente un échantillon d'une table nommée accounts.

Aperçu du tableau présentant la description des métadonnées et les détails des colonnes tels que décrits ci-dessous.

  • Description : Genie utilise les métadonnées pour comprendre vos données et générer des réponses précises. La description de table default indique les métadonnées Unity Catalog associées à votre data asset. Modifiez cette description pour ajouter des instructions spécifiques qui aident Genie à générer du SQL pour votre agent. Cliquez sur Reset pour restaurer la description de Unity Catalog.

  • Colonnes : les noms et descriptions des colonnes sont inclus dans la liste des colonnes. Chaque colonne est étiquetée avec des tags qui indiquent si elle inclut l' assistance au format ou la correspondance des entités . Consultez la vue d'ensemble de la correspondance d'invites.

Masquer ou afficher les colonnes pertinentes

Masquer une colonne la retire du contexte de l’agent Genie, ainsi Genie ne la référencera pas lors de la génération de SQL ou de la réponse aux questions. Ceci est utile pour exclure les colonnes inutiles, en double ou potentiellement confuses, afin que Genie reste concentré sur les données importantes. Masquer une colonne n’affecte pas les données sous-jacentes ou les autorisations de Unity Catalog. La colonne existe toujours dans la table et reste visible pour les utilisateurs ayant un accès direct à la table.

Les colonnes peuvent être gérées individuellement ou en bloc. Utilisez les instructions suivantes pour masquer ou afficher des colonnes.

  • Masquer une seule colonne : cliquez sur Icône d'œil à côté du nom de la colonne.

  • Masquer plusieurs colonnes :

    • Cochez les cases des colonnes que vous souhaitez masquer.
    • Dans le menu Actions , sélectionnez Masquer les colonnes sélectionnées .
  • Annuler les modifications : répétez les mêmes étapes pour afficher une colonne qui a été masquée.

Modifier les métadonnées de colonne

Vous pouvez personnaliser les éléments suivants pour chaque colonne :

  • Description : Descriptions de colonne spécifiques à l'agent qui améliorent la compréhension de Genie.
  • Synonymes : Termes commerciaux et mots-clés qui aident à faire correspondre le langage de l'utilisateur aux noms de colonnes.
  • Paramètres avancés : Contrôles de correspondance de prompt.
    • Aide au formatage : activez ou désactivez l’échantillonnage des valeurs représentatives.
    • Correspondance d'entités : Activez ou désactivez la correspondance d'entités pour les colonnes catégorielles.

Pour modifier les métadonnées de colonne :

  1. Cliquez sur l'Icône de crayon. icône en forme de crayon à côté du nom d'une colonne.
  2. Modifier la description et les synonymes de la colonne.
  3. Si nécessaire, cliquez sur Paramètres avancés pour ouvrir les contrôles de correspondance de prompt.
  4. Cliquez sur Enregistrer pour conserver vos modifications et fermer la boîte de dialogue.

Aperçu de la correspondance d'invite

La correspondance des invites permet à Genie de faire correspondre les colonnes et les valeurs les plus pertinentes à la question de l'utilisateur, et de corriger les problèmes d'orthographe dans les invites de l'utilisateur. Cela améliore la précision de Genie et aide à générer des requêtes SQL plus fiables.

Lorsqu'un utilisateur pose une question dans Genie, la formulation est souvent conversationnelle et peut inclure des erreurs telles que des fautes d'orthographe. Dans ces cas, les valeurs de l'invite peuvent ne pas correspondre à la structure ou aux valeurs des données. Cela peut amener Genie à mal interpréter la question et à générer un SQL incorrect.

Exemple

Examinez l'exemple suivant :

« Montrez-moi les ventes de voitures en Floride pour le T1. »

Si les données utilisent des abréviations d'état (telles que FL), et que Genie ne peut pas accéder aux valeurs de cette colonne, Genie pourrait générer du SQL qui inclut ILIKE '%Florida%', ce qui ne renvoie aucun résultat.

L'activation de la correspondance d'entités sur la colonne state permet à Genie d'accéder à des valeurs représentatives. Avec ce contexte, Genie peut reconnaître que FL correspond à « Florida » et générer un SQL plus précis.

Sans correspondance d'entités

Avec la correspondance d'entités

WHERE state ILIKE '%Florida%'

WHERE state = 'FL'

Sans correspondance d'entités

Avec la correspondance d'entités

WHERE state ILIKE '%Florida%'

WHERE state = 'FL'

Composants de correspondance de Prompt

  • Assistance de formatage : L'assistance de formatage fournit des valeurs représentatives pour toutes les colonnes éligibles, aidant Genie à comprendre les types de données et les modèles de formatage. Les valeurs représentatives pour la correspondance des invites sont générées en utilisant les autorisations de données de l'auteur. Ces valeurs font partie du contexte partagé de l'agent et aident Genie à interpréter les invites des utilisateurs plus précisément pour tous ceux qui utilisent l'agent.
  • Correspondance des entités : la correspondance des entités fournit des listes organisées de valeurs distinctes pour un maximum de 120 colonnes où les utilisateurs sont susceptibles de faire référence à des entrées spécifiques, telles que les états et les catégories de produits. Ceci aide Genie à faire correspondre la terminologie de l'utilisateur aux valeurs de données réelles. Chaque colonne peut inclure jusqu'à 1 024 valeurs distinctes, chacune d'une longueur maximale de 127 caractères. Les données de correspondance d'entités sont stockées dans le compartiment de stockage de votre Workspace.

Genie fournit automatiquement une assistance de formatage et une correspondance d'entités pour les colonnes éligibles lorsque vous ajoutez des tables à l'agent. Les tables avec filtres de lignes ou masques de colonnes sont exclues de la correspondance rapide.

Gérer la correspondance d'invite

Contrôlez les colonnes qui fournissent une assistance au format et la correspondance des entités afin d'optimiser la compréhension de Genie de vos données. La correspondance des invites est activée par default pour tous les agents Genie.

Gérer l'aide au formatage

L'assistance au formatage est appliquée automatiquement lorsque vous ajoutez des tables à un Genie Agent.

Pour désactiver l'aide au formatage pour une colonne :

  1. Cliquez sur **Configurer > Données** dans votre Genie Agent.
  2. Cliquez sur un nom de table pour afficher ses colonnes.
  3. Cliquez sur l'icône de crayon Icône de crayon. à côté du nom de la colonne.
  4. Cliquez sur Avancé .
  5. Désactivez l' assistance de formatage .

Cette action désactive également automatiquement la correspondance des entités pour cette colonne. Si nécessaire, utilisez ce paramètre pour réactiver l' aide au formatage .

Configurer la correspondance d'entités

Genie génère des réponses en utilisant votre invite, les métadonnées de table pertinentes, les capacités de correspondance d'invite, les signaux d'erreur, et tout code ou requêtes d'entrée. Lorsqu'une colonne a la correspondance d'entités activée, Genie exploite les valeurs stockées pour faire correspondre plus précisément les invites d'utilisateurs aux données réelles. Cela produit des requêtes SQL plus fiables. La correspondance d'entités améliore significativement la précision de Genie, surtout lorsqu'elle est combinée à des requêtes d'exemple claires et à des instructions bien conçues. Consultez Curate an effective Genie Agent pour plus de conseils.

Genie vous empêche d'activer la correspondance des entités sur les tables avec des filtres de lignes ou des masques de colonnes. Cependant, les auteurs d'agents doivent désactiver la correspondance des entités pour les vues qui référencent des tables avec des filtres de lignes ou des masques de colonnes, ou pour les vues dynamiques.

La correspondance d'entités prend uniquement en charge les colonnes de chaînes. La liste suivante inclut des exemples des types de données qui fonctionnent bien avec l'appariement d'entités :

  • Codes d'État ou de pays
  • Catégories de produit
  • Codes de statut
  • Noms des départements

Pour activer la correspondance d'entités, l' Assistance de format doit être activée. Ensuite, utilisez les étapes suivantes :

  1. Cliquez sur **Configurer > Données** dans votre Genie Agent.
  2. Cliquez sur un nom de table pour afficher ses colonnes.
  3. Cliquez sur l'icône de crayon Icône de crayon. à côté du nom de la colonne.
  4. Cliquez sur Avancé .
  5. Activez la correspondance d’entités .
  6. Pour désactiver la correspondance d’entités pour une colonne, désactivez la correspondance d’entités .

Une colonne de type chaîne avec le bouton de dictionnaire de valeurs à droite.

remarque

Lorsque les utilisateurs filtrent sur une colonne avec la correspondance d'entités activée, le filtre s'affiche comme un menu déroulant modifiable rempli des valeurs stockées de la colonne.

refresh ou supprimer les données de correspondance de prompt

L’actualisation des données de correspondance d’invite met à jour les valeurs stockées d’une colonne. refresh values si :

  • De nouvelles valeurs ont été ajoutées à la colonne.
  • Le format des valeurs existantes a changé.

Pour refresh les données de correspondance d'invite, cliquez sur Icône du menu kebab. le menu kebab dans la vue de colonne, puis sur Refresh la correspondance d'invite .

Options refresh ou de suppression des valeurs dans l’interface utilisateur

Définir les relations de jointure

Aidez Genie à créer des instructions JOIN précises en définissant les relations de table :

  1. Cliquez sur Jointures .

  2. Cliquez sur **Ajouter**.

  3. Sélectionnez les tables gauche et droite dans les menus déroulants.

  4. Saisissez une **condition de jointure** (par exemple,)accounts.id = opportunity.accountid

    • Pour des conditions de jointure plus complexes, cliquez sur **Utiliser l'expression SQL**, puis enregistrez la condition de jointure comme une expression SQL.
  5. Sélectionner un type de relation :

    • Plusieurs vers un : plusieurs lignes de gauche correspondent à une seule ligne de droite
    • Un à plusieurs : une ligne gauche correspond à plusieurs lignes droites
    • Un à un : une ligne gauche correspond à au plus une ligne droite

Instructions de jointure montrant une relation de jointure identifiée.

remarque

Lorsque plusieurs jointures existent entre les mêmes tables ou que des auto-jointures sont utilisées, Genie génère automatiquement des alias pour la table de droite afin d'éviter toute ambiguïté.

Définir des expressions SQL

Interface des expressions SQL affichant les mesures, les filtres et les champs

Dans l'expérience de création, les expressions SQL sont regroupées avec des exemples de queries SQL afin que vous puissiez les définir et les gérer au même endroit. Voir Ajouter des exemples de queries SQL et de fonctions.

Les expressions SQL offrent un moyen structuré et guidé d'enseigner à Genie les termes métier courants tels que les KPI, les attributs et les conditions. Genie utilise ensuite ces définitions lorsqu'un utilisateur interroge ces termes métier.

Les expressions SQL complètent les exemples de requêtes SQL, spécifiées dans les instructions. Les expressions SQL définissent des concepts métier réutilisables, mais les exemples de requêtes SQL sont plus utiles pour enseigner à Genie comment aborder les formats d’invite utilisateur courants. Par exemple, si les utilisateurs demandent souvent « une ventilation des performances », un exemple de requête SQL peut montrer que cela signifie les ventes fermées par région, par représentant commercial et par responsable.

Les expressions SQL fonctionnent mieux lorsque vous devez :

  • Fournir des définitions structurées pour les indicateurs de performance clés (KPI) et les métriques, tels que la marge bénéficiaire ou le taux de conversion
  • Donnez à Genie un contexte explicite sur la manière de calculer les valeurs importantes.
  • Définissez des champs supplémentaires pour le jeu de données, tels que le mois ou le segment de clients
  • Apprenez à Genie les filtres pour les conditions commerciales, telles que les commandes importantes ou les commandes avant une heure spécifique

Types d'expressions SQL

Vous pouvez définir les types d'expressions SQL suivants :

  • **Filtres** : conditions de filtrage courantes. Définissez le nom, la logique de filtre SQL et les synonymes.
  • Mesures : Indicateurs clés de performance (KPI) et métriques. Définir le nom, le calcul SQL et les synonymes.
  • Champs : Attributs pour le regroupement et l'analyse des données. Définissez le nom, l'expression SQL et les synonymes.

Pour ajouter une expression SQL :

  1. Cliquez sur Configurer > Instructions > Expressions SQL

  2. Cliquez sur **Ajouter**. Sélectionnez Filtre , Mesure ou Champ .

  3. Dans le champ Nom , saisissez un nom pour l'expression.

  4. Dans le champ **Code**, entrez l'expression SQL.

    • Les expressions de filtre sont évaluées comme une condition booléenne.
    • Les expressions de mesure calculent une agrégation sur plusieurs lignes de la table.
    • Les expressions de champ modifient la valeur de chaque ligne à partir des données existantes.
  5. Dans le champ Synonymes , saisissez les façons courantes dont les utilisateurs pourraient faire référence aux expressions de manière familière.

  6. Dans le champ Instructions , saisissez des instructions spécifiques qui indiquent à Genie à quoi sert l'expression et comment l'utiliser.

Exemples d'expressions SQL

Les exemples suivants montrent une expression de chaque type. La définition de la logique métier sous forme d'expressions SQL produit des résultats plus cohérents que les instructions textuelles, car Genie applique la logique exactement telle qu'elle est écrite plutôt que de l'interpréter à partir du langage naturel.

Filtrer : commandes à forte valeur

  • Nom : Commandes à forte valeur
  • Code : orders.amount > 10000
  • Synonymes : grosses commandes, grandes affaires, commandes importantes
  • Instructions : appliquer lorsque les utilisateurs se renseignent sur des commandes importantes ou de grande valeur. Le threshold est de 10 000 $.

Mesure : Taux de réussite

  • Nom : Taux de victoire
  • Code : COUNT(CASE WHEN stage = 'Closed Won' THEN 1 END) / NULLIF(COUNT(*), 0)
  • **Synonymes** : taux de clôture, taux de conversion
  • **Instructions** : Renvoie la fraction des opportunités remportées. Les résultats sont un nombre décimal entre 0 et 1 ; multipliez par 100 pour afficher en pourcentage.

Champ : taille de l'affaire

  • Nom : Taille de l'affaire
  • Code : CASE WHEN amount < 10000 THEN 'Small' WHEN amount < 50000 THEN 'Medium' ELSE 'Large' END
  • Synonymes : niveau d'affaire, taille du contrat, taille de l'opportunité
  • Instructions : Regroupe les opportunités en petites, moyennes ou grandes en fonction du montant en dollars. À utiliser lorsque les utilisateurs demandent de décomposer les résultats par taille de transaction.

Recommandations d'exploration des connaissances

L'exploration des connaissances contribue à améliorer Genie en suggérant automatiquement des mises à jour du magasin de connaissances, en réduisant la curation manuelle et en améliorant la précision des réponses.

Premièrement, Genie analyse les métadonnées du Unity Catalog pour les tables et les vues connectées à votre agent. Les clés primaires et étrangères définies dans votre schéma sont automatiquement enregistrées comme relations de jointure dans le Genie Agent.

Examinez les extraits de connaissances dans Genie.

Genie apprend également des interactions des auteurs dans les conversations. Lorsqu’un auteur approuve une réponse ou download les résultats d'une query, Genie analyse la query. Il identifie une logique utile qui peut améliorer la précision des questions futures. Genie pourrait suggérer de nouvelles expressions SQL (mesures, filtres ou champs) et des relations de jointure supplémentaires à ajouter à la base de connaissances.

Envoyer des commentaires à Genie.

Étapes suivantes

Utilisez les Link suivants pour continuer à créer votre Genie Agent.