使用 Databricks AI 助理

Databricks Assistant 是內容感知 AI 助理，可協助您處理 Databricks 筆記本、SQL 編輯器、工作、AI/BI 儀表板和檔案編輯器。 當您使用交談介面尋求協助時，Databricks Assistant 可協助您處理資料和程式碼。

針對帳戶：停用或啟用 Databricks Assistant 功能

預設會啟用 Azure AI 支援的 Databricks Assistant 功能。 不過，帳戶管理員可以停用帳戶內所有工作區的 Azure AI 支援助理功能。 帳戶管理員也可以針對整個帳戶強制執行啟用 Databricks Assistant：

1. 身為帳戶管理員，登入帳戶主機。

   重要

   如果您的Microsoft Entra ID 租用戶中尚未登入帳戶主機的使用者，您或租用戶中的其他使用者必須以第一個帳戶管理員的身分登入。若要這樣做，您必須是Microsoft Entra ID 全域管理員，但只有在您第一次登入 Azure Databricks 帳戶主機時必須如此。 第一次登入時，您會成為 Azure Databricks 帳戶管理員，不再需要 Microsoft Entra ID 全域管理員角色來存取 Azure Databricks 帳戶。 身為第一個帳戶管理員，您可以將Microsoft Entra ID 租用戶中的使用者指派為其他帳戶管理員 (他們可以指派更多帳戶管理員)。 其他帳戶管理員不需要在 Microsoft Entra 中具有特定角色。 請參閱管理使用者、服務主體和群組。

2. 按一下 [設定] 。

3. 按下 [功能啟用]索引標籤。

4. 針對 [啟用 Azure AI 功能] 選項，select關閉 或 開啟。

5. 使用 [強制執行] 設定來防止工作區覆寫：

若要瞭解 Azure AI 支援的 Databricks 助理功能所使用的服務，請參閱合作夥伴支援的 AI 輔助功能設定所控管的功能。

針對工作區：停用或啟用助理功能

如果您的帳戶管理員啟用 Assistant，預設會在工作區中啟用它。 除非帳戶管理員選擇強制執行設定，否則工作區系統管理員可以停用其工作區的設定。

若要在工作區中停用 Databricks Assistant：

1. 按下 Databricks 工作區頂端列 >[設定] 中的使用者名稱。
2. 在 [工作區管理員] 下方的左窗格中，按下 [進階] 索引標籤。
3. 若要停用助理，請按下 [關閉] 以取得 Azure AI 支援的 AI 輔助功能。

完全停用或啟用 Databricks Assistant

若要完全停用 Databricks Assistant：

1. 系統管理員：請遵循指示來 停用或啟用帳戶的 Databricks Assistant 功能，。
2. 工作區系統管理員：請遵循指示，停用或啟用工作區的助理功能。

如果您只關閉 啟用 Azure AI 支援的 AI 輔助功能 選項，Databricks 掛載的模型仍會繼續提供以下功能：

• 自動完成
  • Unity Catalog 數據批注
  • 快速修復建議

[助理] 窗格導覽

本節描述 [助理] 窗格的預設體驗。

若要開啟 [助理] 窗格，請按下左側側邊欄中的 。

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

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

若要關閉窗格，請再次按下圖示，或按下儲存格右上角的 。 您可以按下 ，將窗格展開為完整寬度；按下 即可將窗格退回預設寬度。

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

對話和提示歷程記錄

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

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

在筆記本儲存格中使用 Databricks Assistant

在筆記本中，可在 [助理] 窗格或程式碼儲存格內嵌使用 Databricks Assistant。

若要直接在程式碼儲存格中使用 Databricks Assistant，請在 MacOS 上按 [Cmd + i]，或在 Windows 上按 [Ctrl + i]。 文字輸入框會出現在儲存格中。 您可以用英文輸入問題或留言，然後按 Enter（不是 Shift+Enter，就像您要執行單元格一樣），讓小幫手 generate 回應。

針對提示使用 Slash 命令

Slash 命令是建立常見提示的捷徑。

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

Get 代碼段的詳細說明。 使用 /explain 提示，並包含類似「簡潔」或「explain 程式代碼逐行」等詞語，以指定您所需的詳細程度。 您也可以要求 Databricks Assistant 將註解新增至程式碼。

針對程式碼自動完成，效能可能比在筆記本儲存格中使用 [助理] 窗格更好。

如果您接受或拒絕助理產生的程式碼，助理會自動關閉。

在提示中使用 @參考 tables

若要在助理提示中快速參考 tables，請使用 @（@）符號。

Get 程式代碼的說明

Databricks Assistant 可協助處理 SQL 和 Python 的程式碼：

• Databricks 筆記本、SQL 編輯器和檔案編輯器中的 AI 型自動完成。
• 使用自然語言提示進行資料篩選。
• 使用 診斷錯誤進行程式代碼偵錯 （公開預覽）。

使用自然語言提示篩選資料

使用 Databricks Assistant 以自然語言提示篩選資料輸出。

若要使用自然語言篩選輸出，請按下輸出 table 中的 [篩選] 圖示，然後輸入提示。 例如，如下列動畫範例所示，您可以提示「只顯示超過 70 歲的男性」。

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

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

AI 型自動完成也可以從註解中生成 generate 程式碼：

偵錯程式碼：Python 和 SQL 範例

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

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

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

Python

SQL

當您按下 [診斷錯誤] 時，助理會自動執行 /fix。

快速修正

當程式碼傳回錯誤時，快速修正會自動建議修正可在單行變更中修正的基本錯誤。

按下 [接受並執行] 以提出建議的修正，並繼續執行程式碼：

診斷工作中的錯誤 (公開預覽)

Databricks Assistant 可協助診斷工作中的錯誤。

若要使用助理診斷工作：

1. 從工作 UI 開啟失敗的工作。
2. Select 診斷錯誤。

Get Azure Databricks 檔中的解答

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

使用 Databricks Assistant 的秘訣

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

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

Databricks Assistant 可以存取 table 和 column 架構和元數據。 這可讓您使用自然語言以及generate更精確的查詢。 例如，如果 table 有一個名為 State的 column，您可以要求 Databricks Assistant generate 住在密歇根州的 list 使用者。

Databricks Assistant 使用下列內容：

• 目前筆記本儲存格或 Databricks SQL 編輯器索引標籤中的程式碼或查詢。
• Table 與 Column 的名稱與描述。
• 先前的提示問題。
• 我的最愛與使用中 tables。
• 針對診斷錯誤特徵，來自錯誤輸出的堆疊追蹤。

從 DataFrame 選取 columns 時，您可以藉由提供起始查詢來 get 更精確的結果。 例如，提供類似 SELECT * FROM <table_name>的陳述式。 這可讓 Databricks Assistant 進行 get 並處理 column 名稱，而不需要猜測。

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

要具體

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

• 「Explain 這段程式碼用幾句話來解釋」或「Explain 這段程式碼逐行分析」。
• 「使用 MatPlotLib 建立視覺效果」或「使用 Seaborn 建立視覺效果」。

提供行級別數據範例 values

由於 Databricks Assistant 不會使用數據列層級數據，因此您可能需要提供更詳細的資訊，以提示 get 最精確的答案。 使用 Catalog Explorer 中的 table 或 column 批注來新增一行範例數據。 例如，假設您的高度 column 格式為 feet-inches。 為了協助小幫手解譯數據，請新增批註，例如「高度 column 為字串格式，並以連字元分隔。 範例：‘6-2’.” 如需有關 table 和 column 批註的資訊，請參閱 為數據和 AI 資產新增批註。

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

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

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

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

在 [助理] 窗格中執行程式碼，以驗證它，或將其當成臨時編輯區使用。 若要執行程式碼，請按下 [助理] 窗格中程式碼方塊左上角的 。

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

Python

SQL

當您在 [助理] 窗格中執行程式碼時，會顯示輸出，而且變數在筆記本中也會變得可用。

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

其他資訊

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

• 什麼是 Databricks Assistant？
• DatabricksIQ 信任和安全
• 測量 Databricks 小幫手影響