他の Looker コンテンツ タイプと同様に、HTML iframe タグを使用して、会話型分析インターフェースをウェブサイトやアプリケーションに埋め込むことができます。会話型分析のインターフェースには、ダッシュボードのデータ エージェントの会話ペインと [会話] ページがあります。このページでは、複数の Looker Explore に接続されているデータ エージェントとチャットしたり、スタンドアロンの Explore とチャットしたりできます。
会話型分析は、ユーザーが Looker ログインを使用して認証されるプライベート埋め込みと、ユーザーが独自のアプリケーションを通じて認証される署名付き埋め込みの両方をサポートしています。
このページでは、Conversational Analytics インターフェースを iframe に埋め込む方法について説明します。
Gemini for Google Cloud がデータを使用する方法とタイミングに関する説明をご覧ください。
始める前に
会話型分析を埋め込むには、次の要件を満たす必要があります。
- インスタンスは Looker ホスト型である必要があります。
- ユーザーには、埋め込み以外の会話型分析を使用するために必要な権限と同じ権限が必要です。
- Conversational Analytics ダッシュボード データ エージェントを使用する Looker ダッシュボードを埋め込むには、管理者がダッシュボード データ エージェント [プレビュー] を有効にする必要があります。[Gemini in Looker] 管理ページの [Trusted Tester の機能を有効にする] 設定で、[ダッシュボード エージェントを有効にする] 設定をオンにします。[Trusted Tester の機能を有効にする] の設定も有効にする必要があります。
会話型分析の埋め込みに関する制限事項
Conversational Analytics のコンテンツを埋め込む場合は、次の制限事項に注意してください。
会話型分析を埋め込む場合、埋め込みテーマは部分的にサポートされます。[全般オプション] のテーマは、会話分析のインターフェースに適用されます。他のテーマ設定オプションはサポートされていません。埋め込みテーマは、埋め込みダッシュボードのデータ エージェントの会話機能でサポートされています。
会話型分析の埋め込み 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。