您可以使用 HTML iframe 标记将对话式分析界面嵌入到网站或应用中,就像嵌入其他 Looker 内容类型一样。对话式分析界面包括信息中心数据智能体对话窗格和对话 页面,您可以在其中与连接到多个 Looker 探索的数据智能体聊天,也可以与独立探索聊天。
对话式分析支持私有嵌入(用户使用 Looker 登录信息进行身份验证)和签名嵌入(用户通过您自己的应用进行身份验证)。
本页面介绍了如何将对话式分析界面嵌入到 iframe 中。
了解 Gemini for 如何以及何时使用您的数据。 Google Cloud
准备工作
如需嵌入对话式分析,必须满足以下要求:
- 您的实例必须由 Looker 托管。
- 用户需要与使用非嵌入式对话式分析时所需的权限相同的权限。
- 如需嵌入使用对话式分析信息中心数据智能体的 Looker 信息中心,管理员必须启用 信息中心数据智能体 (预览版)。在 Gemini in Looker 管理页面上,在启用可信测试员功能 设置下,开启启用信息中心智能体 设置。还必须启用启用可信测试员功能 设置。
嵌入对话式分析的限制
嵌入对话式分析内容时,请注意以下限制:
嵌入式主题在嵌入对话式分析时会部分受支持。“常规选项”主题适用于对话式分析界面。系统不支持其他主题设置选项。嵌入式主题在嵌入式信息中心的数据智能体对话体验中受支持。
创建对话式分析嵌入网址
创建对话式分析嵌入网址的过程与嵌入其他内容类型(例如信息中心或 Look)的过程相同,即在实例名称后、内容文件夹和内容 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。