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

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

要求

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

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

步驟 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" ，讓使用者能複製查詢結果與對話連結。
• 限制允許曲面：只將你信任且控制的領域加入允許的嵌入曲面清單。