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