Incorporer un agent Genie dans une application externe

Incorporez un agent Genie en tant qu’iframe dans un site web ou une application externe afin que les utilisateurs puissent interagir avec Genie à l’intérieur de vos outils ou portails internes sans accéder à Azure Databricks. Les administrateurs d’espace de travail configurent les surfaces d’incorporation autorisées ; Les utilisateurs incorporés peuvent envoyer des invites, mais ne peuvent pas modifier la configuration de l’agent.

Note

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

Exigences

Avant de pouvoir incorporer un agent Genie, 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.
• Créateur de l’agent : doit disposer au minimum de l’autorisation CAN MANAGE sur Genie Agent.
• Utilisateurs finaux : doit avoir un accès explicite à l’Agent Genie 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’agent incorporé.

Note

Les utilisateurs de l’agent Génie incorporé peuvent envoyer des invites, mais ne peuvent pas modifier la configuration de l’agent.

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

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

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

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

1. Ouvrez l’agent Genie 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 3 : 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’Agent Genie et à toutes les ressources de données sous-jacentes utilisées par l’agent. 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.