メインコンテンツまでスキップ

Genieスペースを埋め込む

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。「Databricks プレビューの管理」を参照してください。

Genieスペースは、外部のウェブサイトやアプリケーションにiframeとして埋め込むことができます。これにより、ビジネスユーザーはDatabricksにアクセスすることなく、社内ツールやポータル内でGenieと直接やり取りできるようになります。

要件

Genieスペースを埋め込むには、以下の条件を満たしている必要があります。

  • ワークスペース管理者 :Genieのアクセス管理設定で、許可する埋め込みサーフェスを設定する必要があります。
  • スペース作成者 :Genieスペースに対して少なくともCAN MANAGE権限を持っている必要があります。
  • エンドユーザー :Genieスペースおよびそれが使用する基盤となるデータ資産への明示的なアクセス権が必要です。Databricksにサインインしていないユーザーは、埋め込みスペースを操作する前に認証を求められます。
注記

組み込み型Genieスペースのユーザーはプロンプトを送信することはできますが、スペースの設定を編集することはできません。

ステップ 1: 機能プレビューを有効にする

ワークスペースでこの機能が利用可能になるには、ワークスペース管理者が プレビューページ から Embed Genieをiframeとして 有効にする必要があります。

ステップ 2: 許可される埋め込みサーフェスを構成する

Genieスペースを埋め込むには、ワークスペース管理者が埋め込みを許可するサーフェスを設定する必要があります。ダッシュボードとGenieスペースの埋め込みの管理を参照してください。

ステップ 3: iframe コードを生成する

管理者が許可するサーフェスを設定した後、スペース作成者はiframe埋め込みコードを生成できます。

  1. 埋め込みたいGenieスペースを開きます。
  2. [共有] をクリックします。
  3. 共有ダイアログで、 [スペースを埋め込む] をクリックします。
  4. 生成されたiframeコードをコピーしてください。

ステップ 4: iframe をアプリケーションに追加する

iframeコードを外部ウェブサイトまたはアプリケーションに貼り付けてください。

CSVデータのコピーや会話リンクのコピーなど、すべての機能を有効にするには、iframe要素にallow="clipboard-write"属性を追加してください。

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

ベストプラクティス

  • 明示的なデータアクセスを許可する :エンドユーザーがGenieスペースと、そのスペースで使用されるすべての基盤となるデータ資産の両方にアクセスできることを確認します。ユーザーは、アクセス権限を持つデータのみを閲覧できます。
  • クリップボードへのアクセスを有効にする :ユーザーがクエリ結果や会話リンクをコピーできるように、iframe要素にallow="clipboard-write"を含めます。
  • 許可するサーフェスを制限する :信頼でき、管理できるドメインのみを許可された埋め込みサーフェスのリストに追加してください。