他の Looker コンテンツ タイプと同様に、HTML iframe の タグを使用して、会話型分析インターフェースをウェブサイトまたはアプリケーションに埋め込むことができます。会話型分析インターフェースには、ダッシュボード データ エージェントの会話ペインと [会話] ページが含まれます。このページでは、複数の Looker Explore に接続されているデータ エージェントとチャットしたり、スタンドアロンの Explore とチャットしたりできます。
会話型分析では、ユーザーが Looker ログインを使用して認証されるプライベート埋め込みと、ユーザーが独自のアプリケーションを介して認証される署名付き埋め込みの両方がサポートされています。
このページでは、会話型分析インターフェースを iframe に埋め込む方法について説明します。
Gemini for がデータを使用する方法とタイミングに関する説明をご覧ください。 Google Cloud
始める前に
会話型分析を埋め込むには、次の要件を満たす必要があります。
- インスタンスは Looker でホストされている必要があります。
- ユーザーには、埋め込み以外の会話型分析を使用するために必要な権限と同じ権限が必要です。
- 会話型分析ダッシュボード データ エージェントを使用する Looker ダッシュボードを埋め込むには、管理者がダッシュボード データ エージェント（プレビュー版）を有効にする必要があります。[Gemini in Looker] 管理ページで、[Trusted Tester の機能を有効にする] 設定の [ダッシュボード エージェントを有効にする] 設定をオンにします。[Trusted Tester の機能を有効にする] 設定も有効にする必要があります。
会話型分析の埋め込みの制限事項
会話型分析コンテンツを埋め込む場合は、次の制限事項に注意してください。
埋め込みテーマは、会話型分析を埋め込む場合、部分的にサポートされます。[全般オプション] のテーマは、会話型分析インターフェースに適用されます。他のテーマ設定オプションはサポートされていません。埋め込みテーマは、埋め込みダッシュボードのデータ エージェントの会話エクスペリエンスでサポートされています。
会話型分析の埋め込み URL を作成する
会話型分析の埋め込み URL を作成するプロセスは、ダッシュボードや Look などの他のコンテンツ タイプを埋め込む場合と同じです。インスタンス名の後、コンテンツ フォルダとコンテンツ ID の前に /embed/ を追加します。
Explore データ エージェントまたはスタンドアロンの Explore との会話を埋め込むには、会話またはエージェントの埋め込み以外の URL を見つけて、conversations フォルダまたは agents フォルダの前に /embed/ を追加します。次に例を示します。
- [会話] ページの場合、埋め込み URL は
https://my_looker_instance.looker.com/embed/conversationsのようになります。 - [エージェント] ページの場合、埋め込み URL は
https://my_looker_instance.looker.com/embed/agentsのようになります。 - 特定の会話の場合、埋め込み URL は
https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004cのようになります。この例では、c9f370ac830b4669aeb494396422004cは会話 ID です。 - プレビュー: 会話型分析ダッシュボード データ エージェントを使用するダッシュボードの場合、埋め込み URL は
https://my_looker_instance.looker.com/embed/dashboards/1のようになります。
会話型分析のプライベート埋め込み
プライベート埋め込みの場合は、次の例に示すように、iframe を作成し、会話型分析の埋め込み URL を iframe ソースとして使用します。
<iframe
src="https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c"
width="1000"
height="2000"
frameborder="0">
</iframe>
次に、iframe をウェブページまたはアプリケーションに埋め込みます。
会話型分析の署名付き埋め込み
会話型分析の署名付き埋め込みのプロセスは、他のコンテンツ タイプの場合と同じです。署名付き埋め込み URL をコーディングするときは、会話型分析の埋め込み URL を使用します。
埋め込みユーザーは、会話型分析を使用するための適切な権限（chat_with_explore や chat_with_agent など）が必要です。そのため、これらの権限を署名付き埋め込み URLに追加する必要があります。
[URL パラメータ]を追加すると、ダッシュボードからデータ エージェントの会話ペインを開く 
Gemini スパークをユーザーに表示または非表示にできます。デフォルトでは、ダッシュボード エージェントを操作する権限を持つユーザーには、ダッシュボード データ
エージェントとの会話を開始するオプションが表示されます。特定のダッシュボードで Gemini スパークを非表示にして、ダッシュボード データ
エージェントとの会話を開始する機能を削除するには、署名付き埋め込み URL に ca_chat=false
パラメータを追加します。例: https://my_looker_instance.looker.com/embed/dashboards/1?ca_chat=false。