Intégrez un Genie Agent dans une application externe

Intégrez un Genie Agent en tant qu'iframe dans un site Web ou une application externe afin que les utilisateurs puissent interagir avec Genie au sein de vos outils ou portails internes sans naviguer vers Databricks. Les administrateurs de Workspace configurent les surfaces d'intégration autorisées ; les utilisateurs intégrés peuvent envoyer des invites mais ne peuvent pas modifier la configuration de l'agent.

remarque

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

Exigences

Avant de pouvoir intégrer un Genie Agent, les éléments suivants doivent être en place :

• Administrateur de workspace : doit configurer les surfaces d'intégration autorisées dans les paramètres de gestion des accès Genie.
• **Auteur de l'agent** : Doit avoir au moins l'autorisation CAN MANAGE sur le Genie Agent.
• Utilisateurs finaux : Doivent avoir un accès explicite au Genie Agent et aux assets de données sous-jacents qu'il utilise. Les utilisateurs qui ne sont pas connectés à Databricks sont invités à s'authentifier avant de pouvoir interagir avec l'agent intégré.

remarque

Les utilisateurs d'un Genie Agent intégré peuvent envoyer des invites, mais ne peuvent pas modifier la configuration de l'agent.

Étape 1 : Configurer les surfaces d'intégration autorisées

Un administrateur de workspace doit configurer les surfaces d'intégration autorisées avant qu'un Genie Agent puisse être intégré. Voir Gérer l'intégration des tableaux de bord et des Genie Agent.

Étape 2 : générez le code iFrame

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

1. Ouvrez le Genie Agent que vous souhaitez intégrer.
2. Cliquez sur « Partager » .
3. Dans la boîte de dialogue Partager, cliquez sur Incorporer l'espace .
4. Copiez le code iframe généré.

Étape 3 : Ajoutez l'iframe à votre application

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

Pour activer toutes les fonctionnalités, y compris la copie des données CSV et la copie des Link de conversation, ajoutez l'attribut allow="clipboard-write" à l'élément iframe :

Html

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

Bonnes pratiques

• Accordez un accès explicite aux données : assurez-vous que les utilisateurs finaux ont accès à la fois au Genie Agent et à tous les assets de données sous-jacents utilisés par l'agent. Vous ne voyez que les données auxquelles vous avez la permission d'accéder.
• Activer l'accès au presse-papiers : incluez allow="clipboard-write" sur l'élément iframe afin que les utilisateurs puissent copier les résultats de requête et les Link de conversation.
• Limiter les surfaces autorisées : n'ajoutez des domaines à la liste des surfaces d'intégration autorisées que si vous leur faites confiance et les contrôlez.