您可以使用 HTML iframe 标记将对话式分析界面嵌入到网站或应用中,就像嵌入其他 Looker 内容类型一样。对话式分析界面包括信息中心数据代理对话窗格和会话页面,您可以在其中与连接到多个 Looker 探索的数据代理聊天,也可以与探索直接聊天。
对话式分析支持私密嵌入(用户使用 Looker 登录信息进行身份验证)和签名嵌入(用户通过您自己的应用进行身份验证)。
本页介绍了如何将对话式分析界面嵌入到 iframe 中。
了解 Gemini for Google Cloud 如何以及何时使用您的数据。
准备工作
如需嵌入对话式分析,必须满足以下要求:
- 您的实例必须由 Looker 托管。
- 用户需要与使用非嵌入式对话式分析相同的权限。
- 如需嵌入使用对话式分析信息中心数据代理的 Looker 信息中心,管理员必须启用 信息中心数据代理。在 Gemini in Looker 管理页面上,在对话式分析 下,开启信息中心代理 设置。
嵌入对话式分析的限制
嵌入对话式分析内容时,请注意以下限制:
嵌入式主题在嵌入对话式分析时会部分受支持。“常规选项”主题适用于对话式分析界面。系统不支持其他主题选项。嵌入式主题在嵌入式信息中心内的数据代理对话式体验中受支持。
创建对话式分析嵌入网址
创建对话式分析嵌入网址的过程与嵌入其他内容类型(例如信息中心或 Look)的过程相同,即在实例名称后、内容文件夹和 Content ID 前添加 /embed/。
如需嵌入与探索数据代理的对话或与探索的直接聊天,请找到对话或代理的非嵌入式网址,并在 conversations 或 agents 文件夹前添加 /embed/。例如:
- 对于对话 页面,嵌入网址将类似于
https://my_looker_instance.looker.com/embed/conversations。 - 对于代理 页面,嵌入网址将类似于
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,并使用对话式分析嵌入网址作为 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 星光图标(用于从信息中心打开数据智能体对话窗格)对用户可见或隐藏。默认情况下,有权与信息中心代理互动的用户可以看到与信息中心数据代理开始对话的选项。如需从特定信息中心隐藏 Gemini 星光图标并移除与信息中心数据智能体开始对话的功能,请将
ca_chat=false 参数添加到签名嵌入网址中。例如:https://my_looker_instance.looker.com/embed/dashboards/1?ca_chat=false。