外部の Web サイトまたはアプリケーションに iframe として Genie エージェントを埋め込み、ユーザーが Azure Databricks に移動することなく、内部ツールまたはポータル内で Genie と対話できるようにします。 ワークスペース管理者は、許可された埋め込みサーフェスを構成します。埋め込みユーザーはプロンプトを送信できますが、エージェント構成を編集することはできません。
Note
Genie Agents は、以前は Genie Spaces として知られていました。
Requirements
Genie エージェントを埋め込む前に、次の手順を実行する必要があります。
- ワークスペース管理者: Genie のアクセス管理設定で、許可された埋め込みサーフェスを構成する必要があります。
- エージェントの作成者: Genie エージェントに対する CAN MANAGE 権限を少なくとも持っている必要があります。
- エンド ユーザー: Genie エージェントと、それが使用する基になるデータ資産への明示的なアクセス権が必要です。 Azure Databricksにサインインしていないユーザーは、埋め込みエージェントと対話する前に認証を求められます。
Note
埋め込み Genie エージェント ユーザーはプロンプトを送信できますが、エージェント構成を編集することはできません。
手順 1: 許可される埋め込みサーフェスを構成する
ワークスペース管理者は、Genie エージェントを埋め込む前に、許可された埋め込みサーフェスを構成する必要があります。 「ダッシュボードの管理」と「Genie Agent の埋め込み」を参照してください。
手順 2: iframe コードを生成する
管理者が許可されたサーフェスを構成した後、エージェントの作成者は iframe 埋め込みコードを生成できます。
- 埋め込む Genie エージェントを開きます。
- [共有] をクリックします。
- [共有]ダイアログボックスで、[ スペースを埋め込む]をクリックします。
- 生成された iframe コードをコピーします。
手順 3: iframe をアプリケーションに追加する
iframe コードを外部の Web サイトまたはアプリケーションに貼り付けます。
CSV データのコピーや会話リンクのコピーなど、完全な機能を有効にするには、 allow="clipboard-write" 属性を iframe 要素に追加します。
<iframe src="<your-genie-space-url>" allow="clipboard-write" width="100%" height="600"></iframe>
ベスト プラクティス
- 明示的なデータ アクセスを許可する: エンド ユーザーが Genie エージェントと、エージェントによって使用されるすべての基になるデータ資産の両方にアクセスできることを確認します。 ユーザーには、アクセス許可を持つデータのみが表示されます。
-
クリップボードへのアクセスを有効にする: ユーザーがクエリ結果と会話リンクをコピーできるように、iframe 要素に
allow="clipboard-write"を含めます。 - 許可されるサーフェスを制限する: 信頼して制御できる埋め込みサーフェスリストにドメインのみを追加します。
