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