Créer et gérer un agent Génie

Créez, partagez et gérez un Agent Genie, l’interface de conversation en langage naturel que les utilisateurs professionnels utilisent pour poser des questions sur leurs données dans Azure Databricks. Les analystes de données configurent chaque agent avec Unity Catalog, exemples de requêtes SQL, instructions et ressources approuvées ; les utilisateurs professionnels l’interrogent via l’interface utilisateur de conversation.

Note

Les agents génie étaient anciennement appelés Génie Spaces.

Exigences et limites techniques

Les exigences et limites suivantes s’appliquent lors de l’utilisation des agents Génie :

  • Catalogue Unity : Les données de l’agent Genie doivent être inscrites dans le catalogue Unity. Vous pouvez ajouter jusqu’à 30 tables ou vues à un Agent Genie.
  • Calcul : Les agents Genie nécessitent un entrepôt SQL Pro ou Serverless. Lorsque vous créez ou configurez un agent Génie, vous devez disposer au moins de l’autorisation CAN USE sur l’entrepôt sélectionné. Vos informations d’identification de calcul sont incorporées dans l’Agent Genie et utilisées pour traiter toutes les requêtes pour tous les utilisateurs.
  • Capacité: Chaque agent Genie peut prendre en charge jusqu’à 10 000 conversations, et chaque conversation peut inclure jusqu’à 10 000 messages.

Autorisations requises

Pour créer ou modifier un Agent Genie, vous devez disposer des autorisations et droits suivants :

  • Droits : Vous devez disposer du droit de l’espace de travail Databricks SQL. Consultez Gérer les droits d’utilisation.
  • Compute :: une autorisation CAN USE sur au moins un entrepôt SQL pro ou serverless.
  • Accès aux données :SELECT privilèges sur les données utilisées dans l’agent.
  • ACL de Genie Agent : Au moins l’autorisation CAN EDIT pour Genie Agent. Les créateurs de l’agent Génie disposent automatiquement des autorisations CAN MANAGE sur les agents qu’ils créent. Consultez les listes de contrôle d’accès de l’agent Genie.

Note

La configuration des données et de l’accès au calcul nécessite des autorisations élevées, généralement limitées à un administrateur. Consultez Créer un entrepôt SQL et gérer des privilèges dans le catalogue Unity.

Gérer l’accès Genie

Genie utilise des fonctionnalités IA optimisées par les partenaires, qui doivent être activées au niveau du compte et de l’espace de travail. Pour savoir comment gérer ces fonctionnalités pour votre compte, consultez les fonctionnalités d’IA optimisées par les partenaires.

Note

Vous devez être administrateur de compte pour gérer l’accès à cette fonctionnalité. Si vous désactivez les fonctionnalités d’IA optimisées par le partenaire, les utilisateurs disposant du droit SQL Databricks peuvent toujours cliquer sur l’icône Agents Genie dans la barre latérale, mais ils ne peuvent pas accéder à n’importe quel agent Genie.

Créer un agent Génie

Pour créer un agent Genie :

  1. Cliquez sur Agents Genie dans la barre latérale.
  2. Cliquez sur Nouveau dans le coin supérieur droit de l’écran.
  3. Choisissez les sources de données que vous souhaitez inclure dans votre Agent Genie. Cliquez ensuite sur Créer.

Boîte de dialogue de connexion de données avec les sources de données sélectionnées.

Configurer un agent avec Genie Code

Lorsque vous créez un agent, Genie Code démarre automatiquement. Il lit vos données et suggère un contexte qui aide Genie à répondre avec précision aux questions, telles que les descriptions de vos tables et exemples de requêtes. Passez en revue les suggestions et acceptez celles que vous souhaitez conserver. Pour combler un écart spécifique, décrivez le contexte que vous souhaitez ajouter à Genie Code.

Tip

Indiquez au code Genie de procéder ainsi pour vous :

Create a Genie agent for our sales team that answers questions about weekly revenue, units sold, and returns by store and region. Use the sales and store tables in the retail catalog.

Vous pouvez également demander à Genie Code de créer un agent pour vous lorsque vous ne savez pas encore quelles tables utiliser. Décrivez votre domaine métier, les questions auxquelles vous souhaitez que l’agent réponde et les données qu’il doit utiliser. Genie Code identifie les données pertinentes, confirme les sources avec vous et génère l’agent avec ce même contexte de départ.

Avant de partager l’agent avec des utilisateurs, Databricks recommande d’ajouter des exemples de requêtes SQL, des instructions et des configurations de la base de connaissances pour améliorer la précision de la réponse. Consultez la qualité de Tune Genie Agent.

Passer en revue les suggestions de requête

Pour en savoir plus sur les données de votre agent, Genie accède aux informations de votre espace de travail pour mieux comprendre les relations entre les tables et la sémantique de votre entreprise. Lorsque vous ajoutez des ressources de données à un agent, Genie recherche automatiquement les requêtes d’espace de travail populaires pertinentes associées à ces ressources. Vos informations d’identification utilisateur sont utilisées pour rechercher les requêtes pertinentes pour lesquelles vous disposez au moins des autorisations CAN VIEW. Si la recherche retourne des requêtes, une notification s’affiche sous l’onglet Données du panneau Instructions . Cliquez sur Révision pour afficher les requêtes suggérées.

Pour plus d’informations sur les autorisations d’accès aux requêtes, consultez listes de contrôle d’accès des requêtes.

Passez en revue la notification des requêtes suggérées.

Utilisez la boîte de dialogue Vérifier les requêtes suggérées pour passer en revue, modifier, accepter ou rejeter les requêtes suggérées. D’autres utilisateurs disposant au moins d’un accès CAN EDIT sur l’agent Genie peuvent passer en revue les requêtes, à condition qu’ils aient au moins l’accès CAN VIEW sur la requête elle-même.

Boîte de dialogue des requêtes suggérées de la révision annotée. Les sections numérotées indiquent comment utiliser les requêtes suggérées.

  1. Le texte Titre est prérempli avec une question. Révisez ou modifiez la question en la tapant dans le champ Titre.
  2. Le champ Code contient le texte complet de la requête SQL suggérée. Ce champ n’est pas modifiable. Pour afficher la requête complète, cliquez sur ... plus de lignes.
  3. Si vous disposez d’autorisations suffisantes sur la requête, vous pouvez cliquer sur requête SQL pour ouvrir la requête dans l’interface utilisateur de l’historique des requêtes. Consultez l'historique des requêtes Afficher.
  4. Après avoir déterminé si la requête est pertinente pour votre agent, cliquez sur Accepter ou Rejeter pour l’ajouter à votre agent ou ignorer la suggestion en conséquence.
  5. Cliquez sur les autres suggestions pour développer et examiner.

Les requêtes acceptées apparaissent dans le contexte requêtes SQL de l’agent. Une fois qu’ils sont ajoutés à l’agent, les requêtes suggérées et les questions associées sont entièrement modifiables. Consultez Ajouter des exemples de requêtes et de fonctions SQL.

Si aucune requête suggérée n’est retournée :

  • Vous n’avez peut-être pas suffisamment d’accès aux requêtes pertinentes.
  • Il peut n’y avoir aucune donnée pertinente. Si les requêtes n’ont pas été exécutées sur vos tables incluses, la recherche risque de ne pas retourner les résultats.
  • Les requêtes non pertinentes pour l’agent Génie ne sont pas prises en compte. Par exemple, les requêtes qui effectuent uniquement des opérations d’écriture de base sur les ressources incluses ne sont pas considérées comme des exemples pertinents pour Genie.
  • Genie ne suggère pas de requêtes sur des tables qui ne sont pas ajoutées à l’agent. Si vous avez créé des tables ou des vues jointes spécifiquement pour l’Agent Genie, mais que les requêtes Databricks SQL pertinentes s’exécutent généralement sur une autre table source, Genie ne retourne pas ces requêtes dans les résultats.

Gérer les objets de données

Pour gérer les objets de données inclus dans un Agent Genie, cliquez sur Configurer les>données. Cliquez sur le bouton Ajouter pour ajouter d’autres tables. Cliquez sur l’icône Corbeille. À droite du nom de la table pour supprimer une table de l’agent.

Pour afficher des détails sur un objet de données, cliquez sur le nom de l’objet. La vue d’objet de données affiche deux onglets :

  • Vue d’ensemble : affiche les colonnes de l’objet de données, y compris les noms de colonnes, les types de données et les descriptions.
  • Exemples de données : affiche des exemples de données de la table pour vous aider à comprendre le contexte et le contenu des données.

Note

Genie peut interroger des tables au-delà de celles ajoutées explicitement à un agent. L’accès est contrôlé par les autorisations du catalogue Unity, et non par l’agent Genie lui-même. Bien que Genie utilise les tables et vues jointes par défaut, les utilisateurs peuvent interroger d’autres tables en demandant des jointures ou en modifiant DIRECTEMENT SQL. De même, si des instructions ou des métadonnées font référence à des tables situées hors de l’agent, Genie peut les inclure dans les requêtes générées.

Configurer les paramètres

Personnalisez votre agent Génie en configurant des paramètres supplémentaires. Cliquez sur Configurer>les paramètres pour accéder aux paramètres suivants :

  • Titre : le titre apparaît dans le navigateur de l’espace de travail avec d’autres objets d’espace de travail. Choisissez un titre qui aidera les utilisateurs finaux à découvrir votre agent Génie.
  • Entrepôt par défaut : cette ressource de calcul alimente les instructions SQL générées dans l’agent Genie. Lorsque vous enregistrez une sélection d’entrepôt, vos informations d’identification de calcul sont incorporées dans l’Agent Genie et utilisées pour traiter toutes les requêtes Genie pour tous les utilisateurs. Vous devez avoir au moins les autorisations CAN EDIT pour l’agent afin de modifier l’entrepôt. Si un autre auteur modifie l’entrepôt ultérieurement, leurs informations d’identification de calcul sont incorporées à la place. Un Agent Genie peut utiliser un entrepôt SQL pro ou serverless. Pour des performances optimales, Databricks recommande d’utiliser un entrepôt SQL Serverless.
  • Balises : utilisez des balises pour organiser et catégoriser les agentsGenie pour faciliter la gestion. Voir Ajouter des balises.
  • Vignette: Ajoutez une image de vignette à Genie Agent. Les miniatures apparaissent sur la page de conversation initiale de l’Agent Genie et dans Genie One.
  • Description : les utilisateurs voient la description lorsqu’ils ouvrent l’Agente Génie. Utilisez cette zone de texte pour décrire l’objectif de l’agent. Le champ Description prend en charge la mise en forme Markdown afin de pouvoir mettre en forme votre texte et fournir des liens vers un contexte et des références utiles. Pour plus d’informations sur la syntaxe markdown, consultez la aide-mémoire du Guide Markdown.
  • Questions courantes : Les questions courantes sont des exemples facultatifs des types de questions que les utilisateurs peuvent poser. Ils apparaissent sur la page d’accueil du chat de l’agent et peuvent être ajoutés lors de la création ou plus tard dans les Settings de l’agent. Les questions courantes définies par l’auteur sont prioritaires et apparaissent en premier. Lorsque vous fournissez suffisamment de questions courantes pour remplir la page d’accueil de conversation, seules vos questions s’affichent. Lorsque vous fournissez moins, Genie remplit les emplacements restants avec des questions générées automatiquement.

Attendez-vous à itérer sur votre Agent Genie en fonction des tests et de l’utilisation. Pour obtenir des conseils sur les bonnes pratiques pour créer et faire évoluer un Agent Genie, consultez Concevoir un Agent Genie efficace.

Ajouter des balises

Vous devez disposer au moins des autorisations CAN EDIT sur un Agent Genie pour ajouter une balise. Pour ajouter une balise régie, vous devez également disposer de l’autorisation ASSIGN sur la balise régie. Pour plus d’informations sur les étiquettes, consultez Appliquer des balises aux objets sécurisables du catalogue Unity.

Important

Cette fonctionnalité est disponible en préversion publique.

  1. Cliquez sur Configurer>les paramètres.

  2. Cliquez sur Général.

  3. Sous Balises, ajoutez ou mettez à jour une balise :

    • S’il n’y a pas de balises, cliquez sur le bouton Ajouter des balises.
    • S’il existe des balises, cliquez sur l’icône Icône ModifierAjouter/modifier des balises.

  4. Sélectionnez une clé et une valeur de balise existantes ou entrez le nom d’une nouvelle balise.

    • Les balises qui sont sous réglementation se trouvent dans l’en-tête de section Gouverné et ont une icône de verrouillage..
    • Des clés de balise sont requises. Si une valeur d’étiquette est requise dépend de la clé de balise.

Partager un agent Genie

Note

Les agents Génie utilisent les identifiants de calcul intégrés de l’auteur ayant configuré l’entrepôt. Toutes les requêtes s’exécutent à l’aide de ces informations d’identification de calcul incorporées. Toutefois, les utilisateurs finaux de l’agent ont leurs propres informations d’identification de données appliquées aux requêtes. Ils voient donc uniquement les données qu’ils sont censés voir. Toute question sur les données qu’ils ne peuvent pas accéder génère une réponse vide.

Pour restreindre les données que chaque utilisateur peut voir dans le même Agent Genie, appliquez la sécurité au niveau des lignes aux tables sous-jacentes du catalogue Unity. Les filtres de lignes et les masques de colonne définis dans le catalogue Unity sont appliqués automatiquement par utilisateur, quelle que soit la façon dont l’agent Genie est partagé. Consultez les filtres de lignes et les masques de colonne.

Lorsque vous partagez un agent Genie, les utilisateurs doivent disposer des autorisations suivantes pour interagir avec l’agent :

  • Droits : Les droits d'accès du consommateur ou l'autorisation de l'espace de travail Databricks SQL. Consultez Gérer les droits d’utilisation.
  • Calculer : Les requêtes s’exécutent avec les informations d’identification de calcul intégrées par l’auteur qui a configuré l’entrepôt. Les utilisateurs finaux n’ont pas besoin d’autorisations directes d’entrepôt.
  • Accès aux données : Au moins SELECT des privilèges sur tous les objets de données Du catalogue Unity utilisés dans l’agent. Les utilisateurs voient uniquement les données qu’ils ont l’autorisation d’accéder.
  • Listes de contrôle d’accès (ACL) de l’agent Genie : Disposer au minimum des autorisations CAN VIEW/CAN RUN sur l’agent Genie. Consultez les listes de contrôle d’accès de l’agent Genie.

Les nouveaux agents Genie sont enregistrés dans votre dossier utilisateur par défaut. Comme les autres objets d’espace de travail, ils héritent les autorisations du dossier où ils se trouvent. Vous pouvez utiliser la structure de dossiers de votre espace de travail pour les partager avec d’autres utilisateurs. Voir Navigateur d’espace de travail.

Vous pouvez également spécifier certains utilisateurs ou groupes (y compris tous les utilisateurs de compte) à partager avec un niveau d’autorisation donné : CAN MANAGE, CAN EDIT, CAN RUN et CAN VIEW.

Pour partager avec des utilisateurs ou des groupes spécifiques :

  1. Cliquez sur Partager.
  2. Entrez les utilisateurs ou les groupes avec lesquelles vous souhaitez partager l’agent. Ensuite, cliquez sur Ajouter et définir les niveaux d’autorisation appropriés. Les utilisateurs individuels et les membres de petits groupes reçoivent une notification par e-mail confirmant que l’agent a été partagé.
  3. Utilisez le bouton Copier le lien en bas de la boîte de dialogue Partager pour obtenir un lien partageable vers l’agent Genie. Les utilisateurs privilégiés peuvent cliquer sur le lien pour ouvrir l’agent Genie dans un nouvel onglet et poser des questions.

Pour partager avec tous les utilisateurs de compte :

  1. Cliquez sur Partager.
  2. Sélectionnez Tous les utilisateurs de compte.
  3. Définissez le niveau d’autorisation approprié.

Les utilisateurs de l’agent peuvent également partager des conversations individuelles. Consultez Partager une conversation.

Pour partager un agent Genie avec des utilisateurs externes à votre organisation à l’aide d’OpenSharing, consultez Partager un agent Genie à l’aide d’OpenSharing.

Cloner un agent Génie

Le clonage d’un agent Genie crée une copie qui inclut tous les contextes d’installation et instructions. Le clonage est utile lorsque vous souhaitez tester les modifications dans un agent distinct ou réutiliser le contexte d’origine dans un nouveau. Une fois qu’un agent est cloné, le nouvel agent est indépendant de l’original. Vous pouvez apporter des modifications et des ajustements sans impacter celui d’origine.

Les éléments suivants sont copiés dans un agent Genie cloné :

  • Tables et paramètres
  • Instructions générales
  • Exemples de requêtes SQL
  • Fonctions SQL

Les threads de conversation et les données existants de l’onglet Moniteur ne sont pas copiés vers le nouvel agent.

Pour cloner un Agent Genie, procédez comme suit :

  1. Ouvrez l’agent Genie que vous souhaitez cloner.
  2. Cliquez sur le menu Kebab. Icône du menu Kebab dans l’angle supérieur droit de l’agent.
  3. Cliquez sur Cloner.
  4. (Facultatif) Dans la boîte de dialogue Cloner , spécifiez un nouvel emplacement de nom et de dossier d’espace de travail pour l’agent Genie cloné.
  5. Cliquez sur Clone pour créer l’agent.

Exporter un agent Genie sous forme de vue de métrique

Vous pouvez exporter le contexte depuis un agent Genie sous forme de vue de métrique. Cela crée une vue de métrique basée sur les données et le contexte sémantique configurés dans l’agent.

Pour exporter un Agent Genie en tant qu’affichage des métriques, procédez comme suit :

  1. Ouvrez l’agent Genie que vous souhaitez exporter.
  2. Cliquez sur le menu Kebab. Icône du menu Kebab dans l’angle supérieur droit de l’agent.
  3. Sélectionnez Exporter en mode métrique.
  4. Sélectionnez le chemin d’accès de la nouvelle vue métrique.
  5. (Facultatif) Cliquez sur l’icône de code Sparkle genie. Dans le coin supérieur droit de la page, ouvrez Le code Genie et affinez la définition de la vue des métriques.
  6. Cliquez sur Créer.

Ressources additionnelles

  • Last updated on