您可以使用 HTML iframe 標記,將對話式分析介面嵌入網站或應用程式,就像其他 Looker 內容類型一樣。對話式數據分析介面包含資訊主頁資料代理對話窗格和「對話」頁面,您可以在這裡與連結至多個 Looker 探索的資料代理對話,或與獨立的探索對話。
對話式數據分析支援私人嵌入 (使用者透過 Looker 登入驗證) 和簽署嵌入 (使用者透過自有應用程式驗證)。
本頁說明如何將對話式數據分析介面嵌入 iframe。
瞭解 Gemini for Google Cloud 如何使用您的資料。
事前準備
如要嵌入對話式數據分析,必須符合下列條件:
- 執行個體必須由 Looker 代管。
- 使用者必須具備使用非嵌入式對話式數據分析所需的權限。
- 如要嵌入使用對話式數據分析資訊主頁資料代理程式的 Looker 資訊主頁,管理員必須啟用資訊主頁資料代理程式 (預先發布版)。在「Gemini in Looker」管理頁面中,開啟「啟用『信任的測試人員』功能」設定下方的「啟用資訊主頁代理程式」設定。此外,您也必須啟用「啟用『信任的測試人員』功能」設定。
嵌入對話式數據分析的限制
嵌入對話式數據分析內容時,請注意下列限制:
嵌入對話式數據分析時,系統會部分支援內嵌主題。「一般選項」主題會套用至對話式數據分析介面。系統不支援其他主題選項。在嵌入式資訊主頁的資料代理程式對話體驗中,系統支援嵌入式主題。
建立對話式數據分析嵌入網址
建立 Conversational Analytics 嵌入網址的程序,與嵌入其他內容類型 (例如資訊主頁或 Look) 的程序相同,都是在執行個體名稱後、內容資料夾和內容 ID 前加入 /embed/。
如要嵌入與 Explore 資料代理程式的對話,或嵌入獨立的 Explore,請找出對話或代理程式的非嵌入網址,並在 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 Spark,開啟資料代理程式對話窗格。根據預設,如果使用者有權與資訊主頁代理互動,系統就會顯示與資訊主頁資料代理展開對話的選項。如要從特定資訊主頁隱藏 Gemini Spark,並移除與資訊主頁資料代理程式展開對話的功能,請在已簽署的嵌入網址中加入
ca_chat=false 參數。例如:https://my_looker_instance.looker.com/embed/dashboards/1?ca_chat=false。