您可以使用 HTML iframe 代碼,將對話式數據分析介面嵌入網站或應用程式,就像其他 Looker 內容類型一樣。對話式數據分析介面包含資訊主頁資料代理對話窗格和「對話」頁面,您可以在這裡與連結至多個 Looker 探索的資料代理對話,或直接與探索對話。
對話式數據分析支援私人嵌入 (使用者透過 Looker 登入驗證) 和簽署嵌入 (使用者透過您的應用程式驗證)。
本頁面說明如何將 Conversational Analytics 介面嵌入 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,並使用 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。