您可以像使用其他 Looker 内容类型一样,使用 HTML iframe 标签将对话分析界面嵌入到网站或应用程序中。对话分析界面包括仪表板数据代理对话窗格和 对话 页面,您可以在其中与连接到多个 Looker Explore 的数据代理聊天,或与独立的 Explore 聊天。
对话分析支持 私有嵌入,用户通过 Looker 登录进行身份验证;也支持 签名嵌入,用户通过您自己的应用程序进行身份验证。
本页介绍如何将对话分析界面嵌入到 iframe 中。
了解 Gemini for Google Cloud 如何以及何时使用您的数据。
准备工作
要嵌入对话分析功能,必须满足以下要求:
- 您的实例必须由 Looker 托管。
- 用户需要与使用非嵌入式功能相同的权限。对话分析。
- 要嵌入使用对话分析仪表板数据代理的 Looker 仪表板,管理员必须启用 仪表板数据代理 [预览。在 Gemini in Looker 管理员页面上,在启用可信测试员功能设置下,开启启用信息中心代理设置。还必须启用启用可信测试员功能设置。
嵌入“对话式分析”的限制
嵌入对话分析内容时,请注意以下限制:
当您嵌入对话分析时,嵌入式主题 仅部分受支持。常规选项主题适用于对话分析界面。不支持其他主题选项。嵌入式主题在嵌入式信息中心的数据代理对话体验中受支持。
创建对话式分析嵌入网址
为对话式分析创建嵌入网址的过程与嵌入其他类型的内容(例如信息中心或 Look)的过程相同,即在实例名称后、内容文件夹和内容 ID 前添加 /embed/。
要嵌入与 Explore 数据代理或独立 Explore 的对话,请找到对话或代理的非嵌入 网址,并在 conversations 或 agents 文件夹前添加 /embed/。例如:
- 对于对话页面,嵌入网址将类似于
https://my_looker_instance.looker.com/embed/conversations。 - 对于 Agents 页面,嵌入 网址 将类似于
https://my_looker_instance.looker.com/embed/agents。 - 对于特定对话,嵌入网址将类似于
https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c。在此示例中,c9f370ac830b4669aeb494396422004c是对话 ID。 - 对于使用对话分析信息中心数据代理 [预览版] 的信息中心,嵌入网址将类似于
https://my_looker_instance.looker.com/embed/dashboards/1。
私密嵌入对话式分析
对于私密嵌入,请创建一个 iframe 并使用 Conversational Analytics 嵌入网址作为 iframe 来源,如以下示例所示:
<iframe
src="https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c"
width="1000"
height="2000"
frameborder="0">
</iframe>
然后,将 iframe 嵌入到您的网页或应用中。
对话式分析的签名嵌入
对话式分析的签名嵌入流程与其他内容类型相同。在对签名嵌入网址进行编码时,请使用对话式分析嵌入网址。
嵌入式用户需要获得相应的权限。使用对话分析, 例如chat_with_explore或者chat_with_agent。因此,您必须将这些权限添加到已签名的嵌入网址中。
您可以添加 网址 参数 来使从仪表板打开数据代理对话窗格的 Gemini spark 对用户可见或隐藏。默认情况下,有权与信息中心代理互动的用户会看到与信息中心数据代理开始对话的选项。如需在特定信息中心内隐藏 Gemini Spark,并移除与信息中心数据代理对话的功能,请向已签名的嵌入网址添加
ca_chat=false 参数。例如:https://my_looker_instance.looker.com/embed/dashboards/1?ca_chat=false。