Important
這項功能位於 測試版 (Beta) 中。 要使用此功能,工作區管理員必須從預覽頁面開啟受控代理式應用程式建置。 請參閱 管理 Azure Databricks 預覽。
Genie App Builder 讓你能在 Azure Databricks 介面中透過自然語言描述來建置 Databricks 應用程式。 描述你想要的應用程式,Genie App Builder 會用 Databricks AppKit(Azure Databricks 為資料與 AI 應用設計的框架)生成。 你先檢視一個可用的預覽版,透過後續提示來精煉它,然後部署它。
Genie App Builder 會在 App Space 內建立應用程式。 應用程式空間是一個治理邊界,管理員在此定義誰可以創建和使用應用程式、這些應用程式擁有哪些權限,以及適用哪些支出政策。 受控的代理式應用程式建置預覽版會啟用 Genie App Builder 和 App Spaces。 請參見 App Spaces。
使用 Genie 應用程式建構器,快速建立內部資料和 AI 應用程式,無需寫程式碼。 要自己控制應用程式程式碼、執行時或擴展,可以從 範本建立應用程式 ,或是 建立自訂應用程式 。
Requirements
要使用 Genie App Builder,你需要以下條件:
支援區域內的工作空間:
australiaeast、brazilsouth、canadacentral、centralindia、centralus、eastus、eastus2、francecentral、germanywestcentral、japaneast、northcentralus、northeurope、southcentralus、southeastasia、uksouth、westeurope、westus、westus2Azure 中國區域不支援。
合作夥伴驅動的 AI 功能在帳號層級和工作區層級都啟用了。 請參閱 合作夥伴支援的 AI 功能。
如果你的工作區 Geo 需要,則會開啟跨地理處理。 請參閱 啟用跨地理位置處理。
CAN CREATE APP在應用程式空間上的權限。 請參閱 應用程式空間權限。使用者的瀏覽器能夠存取
*.databricksapps.com,編輯器和預覽都在那裡運行。 工作空間的 IP 存取清單與前端 Private Link 設定會套用於此流量。 使用前端 Private Link,databricksapps.com必須解析到你的私人端點。 詳見Ingress 控制。
建立應用程式
用自然語言描述應用程式,然後用後續提示來精煉,直到它達到你想要的效果。
- 在你的 Azure Databricks 工作區中,打開應用程式首頁,並點擊左側導覽中的建置標籤。
- 選擇要在其中建置的應用程式空間。
- (可選)輸入應用程式名稱。
- 輸入一個自然語言提示,描述該應用程式。 請參考 獲得更佳結果的秘訣。
- Genie 應用程式建構器會產生應用程式的預覽。 當提示時,點擊「登入」,並在新的瀏覽器分頁中完成登入。請參閱「登入預覽版」。
- 透過後續提示進一步完善 App。
- 當應用程式如你所願運作時,就部署它。
部署的應用程式在閒置時會縮減至零個執行個體,使用者請求時會重新啟動。 請參見 應用程式執行階段。
要持續改進已部署的應用程式,請點擊應用程式詳細資料頁面上的 Genie App Builder。
登入預覽版
預覽是從與工作區不同的網域載入,所以你需要另外登入該預覽。 登入會在新的瀏覽器分頁開啟。如果你的瀏覽器封鎖了工作區的彈出視窗,請允許它們並點擊 「再試一次」。
預覽也需要第三方 Cookie。 如果瀏覽器封鎖這些 Cookie,請在瀏覽器設定中允許工作區的第三方 Cookie,或點擊「在新分頁開啟」以在獨立分頁查看預覽。
分享應用程式
部署應用程式後,請分享給其他使用者使用:
- 在 App 詳情頁面,按一下 分享。
- 新增使用者或群組,並選擇權限等級:
-
CAN USE:執行並與應用程式互動。 -
CAN MANAGE編輯、分享並刪除應用程式。
-
App Space 的使用者授權設定限制了誰可以使用該應用程式。 如果空間使用 Any role,你可以與任何使用者共享應用程式。 如果該空間使用 僅限所選角色,你只能與能擔任該角色的使用者分享,且他們必須使用該角色才能使用該應用程式。 請參見 角色型存取控制 與 為 Databricks 應用程式設定權限。
數據存取
使用 Genie App Builder 建置的應用程式會透過兩種方式之一存取資料:
- 作為已登入使用者:在使用者授權下,應用程式會以登入使用者的身份來操作。 應用程式只能存取使用者已能存取的資料與資源,且僅限於應用程式空間允許的範圍內。 如果空間需要角色,應用程式會根據該角色的權限來行動。 詳見 Scopes。
- 在應用程式中:管理員可以將 共享資料(如 Unity 目錄資料表和磁碟區)以及 共享資源(如 SQL 倉庫和服務端點)加入應用程式空間。 這個領域裡的每個應用程式都可以用這些元素展現自己的識別。 請參閱 將資源新增至 Databricks 應用程式。
例如,當使用者開啟使用使用者授權的儀表板應用程式時,該應用程式只會查詢使用者有權限閱讀的 Unity 目錄資料表。
改善效果的建議
要獲得更好的 Genie App Builder 效果,請遵循以下建議:
- 從簡單開始,然後逐步改進:先用簡短的提示開始,然後用後續提示加入功能,而不是在一個大提示中描述整個應用程式。 短週期迭代效果最好,尤其是剛開始時。
- 具體說明使用者介面與行為:描述應用程式應有的頁面、使用者輸入的輸入、要顯示的圖表或表格,以及使用者可採取的動作。 也說明應用程式應該如何運作,包括要套用哪些篩選器、使用哪些預設值,以及應用程式寫入資料的位置。
例如:
- 一般: "建立銷售儀表板。"
- 具體說明:「建立一個只有一頁的銷售儀表板。 顯示按地區劃分的月營收條狀圖,以及按營收排名前十的帳戶表。 新增一個預設為EMEA的區域過濾器。」
應用程式執行時
使用 Genie App Builder 建置的應用程式運行於隔離的隨需無伺服器運算系統上。 每個應用程式最多運行一個實例,並在一段時間未活動後縮減為零個實例。 應用程式縮小後的第一個請求會花比較久時間,因為應用程式正在啟動。
當應用程式縮減時,記憶體或本地磁碟中的狀態會遺失。 若要在縮減時保持狀態,可以存放在 Lakebase 資料表、Unity Catalog 磁碟區或其他外部儲存庫中。 請參閱 應用程式狀態。 如果你需要持續開啟的應用程式或水平縮放,建議用範本或自己的程式碼建立應用程式。 請參見 Databricks 應用程式的水平縮放。
Limitations
使用 Genie App Builder 建置的應用程式有以下限制:
- 應用程式沒有一般公開的對公用網際網路的輸出連線。 出站存取權限僅限於 Azure Databricks 工作空間以及由 Azure Databricks 管理的 npm 和 PyPI 套件代理。
- 工作區層級的安全出口閘道(Secure Egress Gateway)和無伺服器 Private Link 設定不適用於這些應用程式。 請參閱 設定 Databricks Apps 的網路。
- 套件僅透過 Azure Databricks 管理的套件代理安裝。 不支援自訂套件倉庫。
故障排除 Genie 應用程式建構器
本節將介紹你在開發應用程式時可能遇到的問題。
編輯器卡在連線中
如果編輯器在「正在連線至運算資源」停留超過幾分鐘,或顯示 「我們無法聯絡您的編輯器」。重新嘗試......,您的瀏覽器可能無法存取編輯器在 *.databricksapps.com 上的位址。 工作區的網路設定通常會導致這種情況:
-
IP 存取清單:工作空間的 IP 存取清單必須允許你所在的網路。 該列表同樣適用於
*.databricksapps.com。 如果你的瀏覽器是透過 Private Link 進入工作區,但databricksapps.com是透過公共網際網路連線,請參考下一項。 -
Front-end Private Link:如果你的工作區使用 front-end Private Link,
databricksapps.com必須像工作區 URL 一樣解析到你的私人端點。 在瀏覽器的開發者工具中,找到編輯器的地址,在對*.databricksapps.com的失敗請求中,從瀏覽器運行的機器或網路執行nslookup <editor-address>。 如果回傳的是公共 IP 位址,請為 Private Link 在你的 DNS 設定中加入databricksapps.com。 請參見 DNS 設定。
定價
在測試期間,Genie App Builder、App Spaces 或使用 Genie App Builder 建立的應用程式均免費。 Beta 版本的價格可能會有所變動。