將 Genie 代理嵌入外部應用程式中

將 Genie 代理嵌入外部網站或應用程式中的 iframe，讓使用者能在內部工具或入口網站中與 Genie 互動，無需直接進入 Azure Databricks。 Workspace 管理員會設定允許的嵌入表面;嵌入式使用者可以發送提示，但無法編輯代理設定。

Note

精靈特工過去被稱為精靈空間。

要求

在你能嵌入精靈代理人之前，必須具備以下條件：

• Workspace 管理員：必須在 Genie 存取管理設定中設定允許的嵌入表面。
• Agent 作者：必須至少擁有 Genie Agent 的「可管理」權限。
• 終端使用者：必須明確存取 Genie 代理及其所使用的底層資料資產。 未登入 Azure Databricks 的使用者會被提示先驗證，才能與內嵌代理互動。

Note

嵌入的 Genie 代理使用者可以發送提示，但無法編輯代理設定。

步驟 1：設定允許的嵌入表面

工作空間管理員必須先設定允許的嵌入表面，才能嵌入 Genie 代理。 請參見 管理儀表板與 Genie 代理嵌入。

步驟 2：產生 iframe 程式碼

管理員設定允許的表面後，代理作者即可產生 iframe 嵌入程式碼。

1. 打開你想嵌入的 Genie Agent。
2. 按一下 [分享]。
3. 在分享對話框中，點擊 嵌入空間。
4. 複製產生的 iframe 程式碼。

步驟 3：將 iframe 加入你的申請

將 iframe 程式碼貼到你的外部網站或應用程式中。

要啟用完整功能，包括複製 CSV 資料和複製對話連結，請在 iframe 元素中加入以下 allow="clipboard-write" 屬性：

<iframe src="<your-genie-space-url>" allow="clipboard-write" width="100%" height="600"></iframe>

最佳做法

• 授權明確的資料存取權：確保最終使用者同時擁有 Genie 代理及其所用的所有底層資料資產的存取權。 使用者只會看到他們有權限存取的資料。
• 啟用剪貼簿存取：在 iframe 元素中加入 allow="clipboard-write" ，讓使用者能複製查詢結果與對話連結。
• 限制允許曲面：只將你信任且控制的領域加入允許的嵌入曲面清單。