您可以使用 HTML iframe 标记将对话式分析界面嵌入网站或应用中,就像嵌入其他 Looker 内容类型一样。对话式分析界面包括信息中心数据代理对话窗格和对话页面,您可以在其中与连接到多个 Looker 探索的数据代理对话,也可以与独立探索对话。
对话式分析支持私密嵌入(用户通过 Looker 登录信息进行身份验证)和签名嵌入(用户通过您自己的应用进行身份验证)。
本页介绍了如何将 Conversational Analytics 界面嵌入到 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 并使用 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。因此,您必须将这些权限添加到已签名的嵌入网址中。
您可以添加 URL 参数,以控制用户是否能看到从信息中心打开数据代理对话框的 Gemini 星火。默认情况下,有权与信息中心代理互动的用户会看到与信息中心数据代理开始对话的选项。如需在特定信息中心内隐藏 Gemini Spark,并移除与信息中心数据代理对话的功能,请向已签名的嵌入网址添加
ca_chat=false 参数。例如:https://my_looker_instance.looker.com/embed/dashboards/1?ca_chat=false。