使用 Databricks Assistant

Databricks Assistant 是一個內容感知 AI 助理，可協助您處理 Databricks 筆記本、SQL 編輯器、作業、Lakeview 儀錶板和檔案編輯器。 當您使用交談介面尋求協助時，Databricks Assistant 可協助您處理數據和程序代碼。

您可以使用 Databricks Assistant 做什麼

Databricks Assistant 可協助執行下列工作：

• 產生、偵錯、優化及說明程序代碼。
• 從數據建立視覺效果。 請參閱 使用 Databricks Assistant 建立視覺效果。
• 偵錯作業 （公開預覽功能）。
• 撰寫程式代碼並編輯 SQL 查詢。
• 在 Azure Databricks 檔中尋找相關說明。

助理會使用 Unity 目錄元數據來了解整個公司的數據表、數據行、描述和熱門數據資產，以提供個人化的回應。

啟用 Databricks Assistant

Databricks Assistant 預設為啟用。 請參閱 如需帳戶：啟用或停用 Databricks Assistant 功能。

在筆記本數據格中使用 Databricks Assistant

在筆記本中，Databricks Assistant 可在 [小幫手] 窗格或程序代碼單元格內嵌使用。

若要直接在程式代碼數據格中使用 Databricks Assistant，請在 MacOS 上按 Cmd + i，或在 Windows 上按 Ctrl + i。 文字框會出現在儲存格中。 您可以使用英文輸入問題或批注，然後按 Enter 鍵（而非 Shift+Enter，就像您要執行單元格一樣），讓助理產生回應。

單元格動作提示

提示快捷方式可協助您建立常見的提示。

提示文字	小幫手的用途
/	顯示一般命令
/doc	在差異檢視中批注程序代碼
/explain	提供儲存格中程式代碼的說明
/fix	建議修正差異檢視中的任何程式代碼錯誤

當您使用 /fix 或 /doc時，在差異視窗中，選取 [ 接受 ] 以接受建議的變更或 [拒絕 ] 以保留原始程序代碼。 如果您接受建議的程式代碼，程式代碼不會自動執行。 您可以在執行程式碼之前先檢閱程式代碼。 如果產生的程式代碼不是您想要的程式碼，請再試一次，將更多詳細數據或資訊新增至批注。 請參閱 使用 Databricks Assistant 的秘訣。

針對程式代碼自動完成，效能可能比在筆記本數據格中使用 [小幫手] 窗格更好。

如果您 接受 或 拒絕 產生的程式代碼，小幫手會自動關閉。

使用 [小幫手] 窗格

本節描述 [小幫手] 窗格的默認體驗。

若要開啟 [小幫手] 窗格，請按下 左側提要字段。

在 [小幫手] 窗格底部的文本框中輸入問題，然後按 Enter 鍵或按下 文字框右側。 小幫手會顯示其答案。 下列螢幕快照顯示您在小幫手窗格中產生程式代碼之後可以採取的動作。

您可以再次執行相同的查詢，以產生另一個答案。 若要這樣做，請將游標暫留在答案上方，然後按下 。

若要關閉窗格，請再次按下圖示，或單擊 單元格右上角。 您可以按下 ，將窗格展開為全角;按下 即可將窗格傳回預設寬度。

即使您關閉窗格或筆記本，小幫手窗格仍會追蹤您的交談。 若要清除先前的交談，請按下 [小幫手] 窗格右上方的 。

線程和提示歷程記錄

交談線程會保存在 Databricks Assistant 可供使用的不同內容中。 從 [助理] 窗格中，您可以建立新的交談線程、檢視問題和提示歷程記錄，以及管理 Databricks Assistant 體驗。

Databricks Assistant 會根據提示的內容來標題線程，因此您可以流覽助理交談的歷程記錄。 下列範例來自筆記本的相關問題。

以 AI 為基礎的自動完成

重要

這項功能處於公開預覽狀態。

AI 型自動完成會在您在 Databricks 筆記本、SQL 編輯器和檔案編輯器中輸入時，提供內嵌程式代碼建議。 內嵌程式代碼建議適用於 Python 和 SQL。

注意

內嵌程式代碼建議不適用於具有 FedRAMP 合規性的 Azure Government 區域或工作區。

取得內嵌程式代碼建議：Python 和 SQL 範例

當您輸入時，建議會自動出現。 按 Tab 以接受建議。 若要手動觸發建議，請按 Option + Shift + Space （在 macOS 上） 或 [控件 + Shift + 空間 ] （在 Windows 上）。

AI 型自動完成也可以從批注產生程式代碼：

偵錯程式代碼：Python 和 SQL 範例

若要使用 Databricks Assistant 來修正程式代碼，請執行下列任一動作：

• 在 [小幫手] 窗格中提出問題。
• 按兩下發生錯誤時出現在儲存格結果中的 [ 診斷錯誤 ] 按鈕。
• 按兩下 [ 偵 錯] 以互動方式逐行逐步執行程式代碼、設定斷點、檢查變數，以及分析程序的執行。

下列索引標籤顯示 Python 和 SQL 程式代碼中的範例：

Python

SQL

說明程序代碼

Databricks Assistant 可以提供代碼段的詳細說明。 /explain使用提示，並包含「簡潔」或「說明程式代碼逐行」等字詞，以要求您想要的詳細數據層級。 您也可以要求 Databricks Assistant 將批註新增至程序代碼。

從 Azure Databricks 檔取得資訊

在筆記本編輯器中，Databricks Assistant 可以根據 Databricks 檔回答問題。 在提示方塊中輸入您的問題或提示。

使用 Databricks Assistant 的秘訣

本節包含使用 Databricks Assistant 時的一些一般秘訣和最佳做法。

Databricks Assistant 會使用內容來提供更好的答案

Databricks Assistant 可以存取數據表和數據行架構和元數據。 這可讓您使用自然語言併產生更精確的查詢。 例如，如果數據表有一 個名為 State 的數據行，您可以要求 Databricks Assistant 產生位於密歇根州的使用者清單。

Databricks Assistant 使用下列內容：

• 目前筆記本數據格或 Databricks SQL 編輯器索引標籤中的程式碼或查詢。
• 數據表和數據行名稱和描述。
• 先前的提示問題。
• 我的最愛和作用中數據表。
• 針對診斷錯誤功能，來自錯誤輸出的堆疊追蹤。

從 DataFrame 選取資料行時，您可以藉由提供啟動查詢來取得更精確的結果。 例如，提供類似 的 SELECT * FROM <table_name>語句。 這可讓 Databricks Assistant 取得數據行名稱，而不需要猜測。

由於 Databricks Assistant 會使用交談歷程記錄來提供更好的更精確的答案，因此您可以要求 Databricks Assistant 改變先前回應的輸出，而不需要重寫整個提示。 使用小幫手的聊天記錄，在 [助理] 窗格中反復清除、探索、篩選和配量 DataFrame。

要具體

Databricks Assistant 提供的結構和詳細數據不時有所不同，即使出現相同的提示也一樣。 請嘗試盡可能提供小幫手的指引，以協助其傳回您想要的格式、詳細程度等資訊。 例如：

• 「在幾個句子中說明此程序代碼」或「逐行說明此程序代碼」。
• 「使用 MatPlotLib 建立視覺效果」或「使用 Seaborn 建立視覺效果」。

提供數據列層級數據值的範例

由於 Databricks Assistant 不會使用數據列層級數據，因此您可能需要提供更詳細的資訊來提示以取得最精確的答案。 使用目錄總管中的數據表或數據行批注來新增一行範例數據。 例如，假設高度資料行的格式 feet-inches為 。 若要協助助理解譯數據，請新增批註，例如「高度數據行是字串格式，並以連字元分隔。 範例：『6-2』。 如需數據表和數據行批注的相關信息，請參閱 將批註新增至數據和 AI 資產。

如果您需要使用資料行資料類型轉換來執行作業，您可能需要提供詳細數據。 例如：「將此程式代碼從 pandas 轉換為 PySpark，包括將 pandas DataFrame 轉換成 PySpark DataFrame 所需的程式代碼，以及將數據行變換的數據類型從布爾值變更為整數」 。

使用 Shift+Enter 在聊天文字框中新增一行

使用 Shift+Enter 在 [助理聊天] 文字框中新增一行。 這可讓您輕鬆地將訊息格式化及組織到 Databricks Assistant。

在 Databricks Assistant 聊天窗格中編輯和執行程式碼

在 [小幫手] 窗格中執行程序代碼，以驗證它，或使用它作為臨時板。 若要執行程式碼，請按兩下 [小幫手] 窗格中程式代碼方塊左上角的 。

下列索引標籤顯示 Python 和 SQL 程式代碼的範例：

Python

SQL

當您在 [小幫手] 窗格中執行程序代碼時，會顯示輸出，且變數可在筆記本中使用。

您也可以編輯 Databricks Assistant 直接在 [小幫手] 聊天方塊中產生的程式代碼，再將程式代碼移至筆記本。

其他資訊

下列文章包含使用 Databricks Assistant 的其他資訊：

• 什麼是 Databricks Assistant？
• DatabricksIQ 信任和安全性