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