Incorporer un espace Genie

Important

Cette fonctionnalité est en version bêta. Les administrateurs d’espace de travail peuvent contrôler l’accès à cette fonctionnalité à partir de la page Aperçus . Consultez les aperçus Manage Azure Databricks.

Vous pouvez incorporer un espace Génie en tant qu’iframe dans un site web ou une application externe. Cela permet aux utilisateurs professionnels d’interagir avec Genie directement dans vos outils ou portails internes sans accéder à Azure Databricks.

Exigences

Avant de pouvoir incorporer un espace Génie, les éléments suivants doivent être en place :

  • Administrateur de l’espace de travail : doit configurer les surfaces d’incorporation autorisées dans les paramètres de gestion des accès Génie.
  • Auteur de l’espace : doit disposer au moins de l’autorisation CAN MANAGE sur l’espace Génie.
  • Utilisateurs finaux : doit avoir un accès explicite à l’espace Génie et aux ressources de données sous-jacentes qu’il utilise. Les utilisateurs qui ne sont pas connectés à Azure Databricks sont invités à s’authentifier avant de pouvoir interagir avec l’espace incorporé.

Note

Les utilisateurs embedded Genie Space peuvent envoyer des invites, mais ne peuvent pas modifier la configuration de l’espace.

Étape 1 : Activer la préversion des fonctionnalités

Un administrateur d’espace de travail doit activer Embed Genie en tant qu’iframe à partir de la page Aperçus avant que la fonctionnalité soit disponible dans l’espace de travail.

Étape 2 : Configurer les surfaces d’incorporation autorisées

Un administrateur d’espace de travail doit configurer les surfaces d’incorporation autorisées avant qu’un espace Génie puisse être incorporé. Consultez Gérer le tableau de bord et l’incorporation de Génie Space.

Étape 3 : Générer le code iframe

Une fois qu’un administrateur a configuré des surfaces autorisées, les auteurs d'espaces peuvent générer le code d'intégration iframe.

  1. Ouvrez l’espace Génie que vous souhaitez incorporer.
  2. Cliquez sur Partager.
  3. Dans la boîte de dialogue Partager, cliquez sur Incorporer de l’espace.
  4. Copiez le code iframe généré.

Étape 4 : Ajouter l’iframe à votre application

Collez le code iframe dans votre site web ou votre application externe.

Pour activer toutes les fonctionnalités, notamment la copie de données CSV et la copie de liens de conversation, ajoutez l’attribut allow="clipboard-write" à l’élément iframe :

<iframe src="<your-genie-space-url>" allow="clipboard-write" width="100%" height="600"></iframe>

Bonnes pratiques

  • Accorder un accès explicite aux données : assurez-vous que les utilisateurs finaux ont accès à l’espace Génie et à toutes les ressources de données sous-jacentes utilisées par l’espace. Les utilisateurs voient uniquement les données qu’ils ont l’autorisation d’accéder.
  • Activer l’accès au Presse-papiers : inclure l'attribut allow="clipboard-write" dans l’élément iframe afin que les utilisateurs puissent copier les résultats des requêtes et les liens de conversation.
  • Limiter les surfaces autorisées : ajoutez uniquement des domaines à la liste des surfaces d’incorporation autorisées que vous approuvez et contrôlez.
  • Last updated on