会話分析を埋め込む

他の Looker コンテンツタイプと同様に、HTML iframe タグを使用して、会話型分析をウェブサイトやアプリケーションに埋め込むことができます。会話型分析は、ユーザーが Looker ログインを使用して認証されるプライベート埋め込みと、ユーザーが独自のアプリケーションを通じて認証される署名付き埋め込みの両方をサポートしています。

このページでは、Conversational Analytics を iframe に埋め込む方法について説明します。

Gemini for Google Cloud がデータを使用する方法とタイミングに関する説明をご覧ください。

始める前に

会話分析を埋め込む場合は、次の要件と制限事項に注意してください。

会話型分析を埋め込むには、インスタンスが Looker 26.2 以降である必要があります。
Looker 管理者は、会話分析を埋め込むラボ機能を有効にする必要があります。
ユーザーには、埋め込み以外の会話分析を使用するために必要な権限と同じ権限が必要です。
プレビュー期間中は、次の制限が追加で適用されます。
- 会話分析の埋め込みは、Looker（オリジナル）でのみサポートされています。Looker（Google Cloud コア）はサポートされていません。
- 埋め込みテーマはサポートされていません。
- 会話分析の署名付き埋め込みでは、Embed SDK はサポートされていません。

Conversational Analytics の埋め込み URL を作成する

会話分析の埋め込み URL を作成するプロセスは、ダッシュボードや Look などの他のコンテンツタイプを埋め込む場合と同じです。インスタンス名の後、コンテンツフォルダとコンテンツ ID の前に /embed/ を追加します。

会話分析の場合は、会話またはエージェントの埋め込み以外の 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 です。

会話分析の非公開埋め込み

限定公開の埋め込みの場合は、次の例に示すように、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 などの会話分析を使用するための適切な権限が必要です。そのため、これらの権限を署名付き埋め込み URL に追加する必要があります。