設定和管理 AI/BI Genie 空間

本文說明如何設定和管理 Genie 互動空間，這是一個供商務使用者使用的聊天介面，可使用自然語言提出關於他們數據的問題。

技術需求和限制

使用 Genie 空間時適用下列需求和限制：

• Unity 目錄： Genie 空間的數據必須註冊到 Unity 目錄。 您可以將最多 25 個資料表或檢視新增至 Genie 空間。
• 計算： Genie 空間需要 Pro 或無伺服器的 SQL 倉庫。 您必須至少對所選的倉庫擁有 CAN USE 使用權限。 如果遺漏此許可權，建立空間就會失敗。
• 處理能力： 每個工作區可以在所有 Genie 空間中每分鐘處理最多 20 個問題。
• 能力： 每個 Genie 空間最多可支援 10,000 個交談，而且每個交談最多可包含 10,000 則訊息。

必要權限

若要建立或編輯 Genie 空間，您必須具有下列許可權和權利：

• 權利： 您必須擁有 Databricks SQL 工作區權利。 請參閱 權限管理。
• 計算： 可以在至少一個專業或無伺服器的 SQL 資料倉儲上使用存取。
• 數據存取：SELECT 空間中所用數據的許可權。
• Genie space ACL： 至少可以編輯 Genie 空間的許可權。 Genie 空間建立者會自動擁有其建立空間的 CAN MANAGE 許可權。 請參閱 Genie 空間 ACL。

注意

設定數據和計算存取需要提高的許可權，通常僅限於系統管理員。 請參閱在 Unity 目錄中建立 SQL 倉儲和管理許可權。

管理 Genie 權限

Genie 使用必須在帳戶層級上啟用的由 Azure AI 驅動的 AI 輔助功能。 若要瞭解如何管理帳戶的這些功能，請參閱 啟用並試用 Databricks Assistant。

注意

您必須是帳戶管理員，才能管理此功能的存取權。 如果您停用 Azure AI 支援的輔助 AI 功能，具有 Databricks SQL 權利的使用者仍然可以在側邊欄點擊 Genie 圖示，但他們無法存取任何 Genie 空間。

建立 Genie 空間

若要建立 Genie 空間：

1. 在側邊欄中點擊Genie。
2. 按兩下畫面右上角的 [ 新增 ]。
3. 選擇您想要包含在 Genie 空間中的數據來源。 然後按兩下 [ 建立]。

注意

Genie 空間可以包含多個計量檢視。 不過，如果它包含計量檢視，就無法同時包含其他類型的數據表或檢視表。 若要深入瞭解計量檢視，請參閱 Unity 目錄計量檢視。

檢閱查詢建議

若要瞭解空間的數據，Genie 會存取工作區中的資訊，以進一步了解數據表與商務語意之間的關聯性。 當您將數據資產新增至空間時，Genie 會自動搜尋與這些資產相關聯的相關熱門工作區查詢。 您的使用者認證可用來尋找您至少有 CAN VIEW 許可權的相關查詢。 如果搜尋傳回查詢，[內容] 面板的 [數據] 索引卷標中會出現通知。 按兩下 [檢閱 ] 以查看建議的查詢。

如需查詢訪問許可權的詳細資訊，請參閱 查詢 ACL。

使用 [ 檢閱建議的查詢 ] 對話框來檢閱、編輯、接受或拒絕建議的查詢。 在 Genie 空間上至少有 CAN EDIT 存取權的其他使用者可以檢閱查詢，前提是他們至少具有查詢本身的 CAN VIEW 存取權。

1. 標題文字已經被事先填入一個問題。 在 [ 標題 ] 欄位中輸入 ，以修改或編輯問題。
2. [ 程序代碼 ] 欄位包含建議 SQL 查詢的完整文字。 無法編輯此欄位。 若要檢視完整的查詢，請按兩下 ...。更多行。
3. 如果您在查詢上有足夠的許可權，您可以按兩下 [SQL 查詢 ]，在 [查詢歷程記錄 ] UI 中開啟查詢。 請參閱 檢視查詢歷程記錄。
4. 判斷查詢是否與您的空間有關之後，請按兩下 [ 接受 ] 或 [ 拒絕 ] 將它新增至您的空間，或據此關閉建議。
5. 點擊其他建議以展開並檢閱。

接受的查詢會出現在空間的 SQL 查詢 內容中。 新增至空間之後，建議的查詢和相關聯的問題會完全可編輯。 請參閱 新增範例 SQL 查詢和函式。

如果未傳回任何建議的查詢：

• 您可能沒有足夠的相關查詢存取權。
• 可能沒有任何相關數據。 如果查詢尚未在您的內含數據表上執行，搜尋可能不會傳回結果。
• 不考慮與 Genie 空間無關的查詢。 例如，只對包含資產執行基本寫入作業的查詢不會被視為 Genie 的相關範例。
• Genie 不會建議對未新增至空間的數據表進行查詢。 如果您已特別針對 Genie 空間建立聯結數據表或檢視表，但相關的 Databricks SQL 查詢通常會針對不同的源數據表執行，Genie 不會在結果中傳回這些查詢。

管理資料物件

若要管理 Genie 空間中包含哪些資料物件，請按兩下 [ 設定>內容>資料]。 按兩下 [ 新增] 按鈕以新增更多資料表。 按兩下 在數據表名稱右側，從空間中移除數據表。

建置知識存放區

知識存放區可讓您定義空間層級數據表和數據行詳細數據，以協助 Genie 瞭解基礎數據，以及數據表和數據行彼此的關聯方式。 知識儲存區詳細資料包括資料表和欄位元數據描述、欄位層級同義詞、取樣值和值字典。 在 Genie 空間中，任何新增至數據資產的資訊都限於該空間。 它會通知 Genie 在空間中回答問題的方式，但不會覆寫 Unity 目錄元數據或由其他 Azure Databricks 資產使用。

檢視數據行

如需詳細的數據行檢視，請按兩下資料表名稱。 下列範例顯示名為 accounts 之數據表的範例。

• 描述： Genie 會使用元數據來瞭解您的數據，並產生精確的回應。 此檢視中的預設數據表描述會顯示與您的數據資產相關聯的 Unity 目錄元數據。 您可以編輯此描述，以新增 Genie 空間的特定內容。 按兩下 [重設 ] 以還原 Unity 目錄描述。

• 列： 數據列名稱和描述會包含在數據行清單中。 每一個數據行都會加上標籤，以顯示它是否包含 範例值 或 值字典 （公開預覽）。 請參閱 使用值取樣來改善 Genie 的正確性 和 編輯數據行元數據。

啟用或停用值取樣

如果您的工作區中已啟用 Genie 數據取樣 （公開預覽），Genie 會自動從您在建立空間期間新增的數據表取樣值。 請參閱 使用值取樣來改善 Genie 的正確性。 如果在建立空間時未啟用值取樣，您可以為空間中的每個表格啟用值取樣。

若要開啟所有的資料列的值取樣：

1. 按一下 在 列標題中的 kebab選單。
2. 點擊啟用所有欄位的值取樣。

若要停用所有資料列的值取樣：

1. 按一下 在 列標題中的 kebab選單。
2. 按一下 停用所有資料行的值取樣。

顯示或隱藏欄位

不必要數據可能會讓 Genie 難以解譯。 若要從 Genie 的內容中移除這些專案，請將滑鼠停留在欄位上方，然後按一下欄位名稱右邊的 。 這會將該欄排除在 Genie 空間上下文之外。 再次按下圖示，將數據行新增回您的空間。

編輯欄位元數據

若要編輯數據行元數據、定義數據行同義字，以及存取進階設定，請將滑鼠停留在數據行上，然後按兩下 圖示。 在欄位對話框中，您可以編輯下列專案：

• 描述： 輸入 Genie 空間欄的描述。 您的描述範圍限定於此 Genie 空間。 它不會覆寫儲存在 Unity 目錄中的元數據。 按兩下 [重設 ] 以還原 Unity 目錄描述。

• 同義詞： 新增同義字和關鍵詞可以增強 Genie 將使用者提示中使用的語言與適當數據行相符的能力。 輸入商務使用者在想要參考此資料行時，可能會在提示中使用的以逗號分隔的字詞清單。

• 高深： 使用進階設定來控制範例值和建置值字典的存取。 Genie 數據取樣 （公開預覽）在工作區層級控制對這些功能的存取。 請參閱 需求。 如果停用所有數據行的值取樣，則無法修改 進階 設定。

  • 範例值：根據默認啟用，此設定可讓 Genie 從數據行取樣幾個值，以進一步瞭解如何使用它。 停用此設定以關閉範例值取樣。
  • 建置值字典：值字典可改善 Genie 對數據的瞭解。 請參閱 使用值取樣來改善 Genie 的正確性。 使用此設定來控制哪些欄位具有值字典。

新增範例和指示

您可以新增範例 SQL 查詢、Unity 目錄函式和純文本指示，以協助產生精確的回應。 按一下 [ 設定>內容]。 使用 [SQL 查詢] 索引標籤來管理查詢和 Unity 目錄函式。 使用 說明 標籤頁來新增純文字說明。

針對 Genie 空間，您總共可以新增 100 個指示。 指示類型會以下列方式參與計數：

• 每個範例 SQL 查詢都會計算為一個。
• 每個 SQL 函式都會計算為一個。
• 整個 一般指令 文本塊會計算為一個。

Genie 空間旨在根據清楚且精確的指引提供一致且可預測的回應。 由於 Genie 以不具決定性的方式運作，因此請務必讓指引免於衝突或模棱兩可的資訊，以將不想要的響應風險降到最低。 設定空間時，關鍵工作是檢閱並解決任何不一致的情況。 這有助於達成可靠的結果。

新增範例 SQL 查詢和函式

使用 [SQL 查詢] 索引標籤來新增下列內容：

• 範例查詢（建議）： SQL 查詢範例可協助 Genie 產生正確的 SQL 以回答用戶問題。 查詢可以是靜態或參數化。 針對每個範例 SQL 查詢，您會提供範例問題，以及傳回預期結果的相符 SQL。 Genie 可以直接使用範例來比對問題，或從中學習以回答相關問題。 當參數化查詢用來產生回應時，它會標示為 [信任]。 空間中具有 CAN EDIT 許可權的使用者可以檢視用來產生回應的查詢，這有助於進行疑難解答和精簡。

• SQL 函式： 針對無法使用靜態或參數化 SQL 查詢回答的問題，您可以將自定義函式註冊至 Unity 目錄。 功能可以在您的團隊間共享，並由 Genie 使用來回答特定問題。 使用 SQL 函式回答的回應會標示為 [信任]。 若要深入瞭解如何在 Genie 空間中使用 SQL 函式，請參閱 在 AI/BI Genie 空間中使用受信任的資產。

Genie 如何使用範例查詢

範例查詢顯示 Genie 如何使用可用的數據來回答問題。 在文字欄位中輸入範例問題，然後輸入可回答該問題的 SQL 查詢。 當 Genie 收到相符的問題時，它可以直接使用範例查詢來提供答案。 當 Genie 取得類似的問題時，它會使用範例查詢中的線索來學習和建構回應中提供的 SQL。 如下列範例所示，著重於提供突顯在您的組織和數據中獨特邏輯的範例：

  -- Return our current total open pipeline by region.
  -- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = 'Pipeline' AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

新增查詢參數

參數化範例查詢可讓使用者指定要在運行時間插入查詢中的特定值。 若要深入瞭解如何使用參數化查詢，請參閱 在 SQL 查詢中使用參數。

提供使用指引

您可以提供 Genie 其他內容，以說明範例查詢何時特別相關。

若要新增使用指引：

1. 按兩下 [ 設定>內容>SQL 查詢 ] 以存取範例查詢清單。
2. 點選範例查詢
3. 點擊畫面底部附近的 使用指引。
4. 輸入如何使用這個範例查詢的詳細數據和時機。

Genie 如何使用 SQL 函式？

當問題牽涉到無法使用靜態或參數化查詢擷取的複雜邏輯時，SQL 函式會很有用。 它們會儲存在 Unity 目錄中，而且可以使用使用者提供的參數由 Genie 呼叫。 Genie 無法檢視或修改函式中使用的 SQL，使這種方法非常適合不應展示或更改的程式邏輯。 如需在 Unity 目錄中註冊函式的指引，請參閱 在 Unity 目錄中建立 SQL 數據表函式 和 使用者定義函式 （UDF）。

提供指示

按一下 [指示] 標籤，撰寫純文字說明，以協助 Genie 瞭解如何回應有關您公司特定問題。 您可以將指示格式化為單一完整附注，或依主題分類，以取得更好的組織。

指示可協助引導 Genie 的回應，以便處理指定網域中唯一的行話、邏輯和概念。 一般文字指示適用於所有提示。 如果指令只與提示子集相關，則應該包含為範例查詢或函式，或記錄在相關數據表中做為批注或元數據。 文字指示僅針對應全域應用的情境，而不適用於其他格式。

下列範例包含您可以包含在一般指示中的資訊：

- **Company-specific business information**:
  - Fiscal year starts in February, for example fiscal year 26 or FY26 is February 1, 2026 through January 31, 2027
- **Formatting**:
  - Always respond in Spanish
  - If no other specification exists, round all decimals to two places
  - Omit commas in results for any column including "Id" or "id" or "\_id"

設定設定

藉由設定其他設定來自定義您的 Genie 空間。 點選 「 設定>設定 」 以存取下列設定：

• 標題：標題會出現在其他工作區物件的工作區瀏覽器中。 選擇可協助使用者探索 Genie 空間的標題。
• 默認倉儲：此計算資源可支援 Genie 空間中產生的 SQL 語句。 使用者需要存取此倉儲，才能與空間互動。 Genie 空間可以使用專業版或無伺服器化的 SQL 儲存區。 為了獲得最佳效能，Databricks 建議使用無伺服器 SQL 倉儲。
• 描述：用戶在開啟 Genie 空間時會看到描述。 使用此文字區域來描述空間的用途。 描述欄位支援 Markdown 格式設定，讓您可以設定文字樣式，並提供實用內容和參考的連結。 如需 Markdown 語法的詳細資訊，請參閱 Markdown 指南速查表。
• Genie 檔案上傳：如果您的 Genie 空間已啟用檔案上傳（公開預覽），您可以選取 [讓使用者將檔案上傳至交談]。 請參閱 上傳檔案。
• 範例問題：範例問題是選擇性的。 他們會出現在聊天中，以提供使用者可以詢問的問題類型範例。 它們可以在建立期間或從空間的設定中新增。

預期會根據測試和使用情況來反覆調整您的 Genie 空間。 如需有關建立和改進空間的最佳做法指引，請參閱 策劃高效的 Genie 空間。

測試您的精靈空間

大部分的用戶互動都會在聊天視窗中進行。 瞭解您的空間是否如您想要般運作，最好是用您預期商務使用者詢問的實際問題來測試它。

在空間設定中設定的範例問題會出現在聊天視窗中。 Genie 也可以根據空間的內容產生範例問題，以協助用戶開始探索數據。 使用者可以按下範例問題，或在畫面底部的文字欄位中輸入自己的問題。

回應會出現在文字欄位上方。 使用者輸入問題之後，它會儲存至聊天記錄。

若要開始新的交談：

1. 按兩下 [新增聊天 ] 以開始新的聊天。 按兩下 以開啟先前的對話。
2. 在 [ 詢問您的問題... 文字輸入] 字段中輸入您的問題。

審查回應

回應通常會以自然語言回答的形式傳遞至問題，以及顯示相關結果集的數據表。 當 Genie 偵測到視覺效果可以改善回應清晰度時，也會傳回視覺效果。 精確的響應結構會根據問題而有所不同。 如果已產生 SQL 查詢來回答問題，回應中就會包含該查詢。

注意

與其他大型語言模型（LLM）一樣，Genie 可以表現出不具決定性的行為。 這表示在提交相同的提示多次時，您偶爾可能會收到不同的輸出。 提供 Genie 可從中學習的範例 SQL 查詢，有助於讓 Genie 更一致。 請參閱 新增範例 SQL 查詢和函式。

回應意見反應

每個回應都會提示使用者回答這是正確的嗎？ 使用者可以以下其中一種方式回應：

• 是的： 確認回應顯示正確。
• 修正此問題： 將回應標示為不正確。 用戶可以從常見問題中選取，或輸入自己的說明。 然後，他們可以：
  • 按兩下 [提交]，然後再試一次 ，使用提供的意見反應重新產生回應。
  • 按兩下 [提交 ] 以傳送意見反應，而不重新產生回應。
• 要求檢閱： 將回應標記為需要手動檢閱。 使用者可以新增一個可選擇的評論，以提供額外的上下文。

身為編輯，您可以在 Genie 介面中檢視意見反應和被標記的回應。 您的 Genie 空間行為不會單獨根據使用者意見反應而變更。 您應該使用意見反應來識別改進機會或直接回應用戶問題。 Databricks 建議鼓勵使用者透過這個機制對於環境提供回饋。

商務使用者可以在 [ 監視 ] 頁面上檢視他們標示要檢閱的問題更新。 具有 Genie 空間至少 CAN MANAGE 許可權的使用者可以檢閱特定交換、對要求置評，以及確認或更正回應。 他們可以在監控頁面上存取回饋並檢視要求。 然後，您可以使用該回饋來微調回應，並反覆改進您的空間。 請參閱 監視空間。

其他回應動作

針對包含所產生 SQL 的回應，其他選項可讓您與傳回的數據互動。

• 下載所有數據列： 空間使用者可以下載最多 1 GB 的結果數據作為 CSV。 最終檔案下載大小可能略高於或小於 1GB，因為 1GB 限制會套用至比最終檔案下載還舊的步驟。 若要下載結果，請按兩下回應中的下載圖示。
• 新增為指示： 如需可能適用於教學 Genie 如何回答類似問題的互動，請按兩下 [新增為指示]。 這會開啟 UI 來儲存範例 SQL 查詢，並填入問題併產生 SQL。 您可以將範例保持原樣，或編輯並儲存以進行修改。 請參閱 新增範例 SQL 查詢和函式。
• 顯示程式代碼： 按兩下 [顯示程式代碼 ] 以檢視產生的查詢。 這對於針對不可靠的回應進行疑難解答很有用。 請參閱 編輯和儲存查詢。
• kebab 功能表：用戶可以執行先前產生的查詢，將回應 CSV 複製到其剪貼簿或重新整理數據。

編輯和儲存查詢

Genie 的 SQL 查詢可以檢閱精確度，並視需要加以編輯。 Genie 空間作者通常知道網域和數據，可讓他們在 Genie 產生不正確的答案時加以辨識。 通常，您可以使用少量手動微調所產生 SQL 查詢來修正錯誤。 按兩下 [顯示產生的程式代碼 ] 來檢查查詢，並檢視產生的 SQL 是否有任何回應。

如果您有 Genie 空間的 CAN EDIT 或更高的許可權，您可以編輯產生的 SQL 語句來更正它。 進行更正之後，請執行查詢。 然後，您可以將它儲存為指示，以教導 Genie 如何在未來回答。 若要儲存已編輯的查詢，請按兩下 [新增] 作為指示。

監視此空間

將 Genie 空間視為數據小組與商務使用者之間的長期共同作業工具。 它是隨著時間累積知識，而非作為一次性部署。 當使用者提出新問題時，您可以精簡空間以改善涵蓋範圍和精確度。

使用 [ 監視] 索引標籤來檢視個別問題和回應、檢視使用者意見反應，以及識別標示為檢視的回應。

[監控] 頁籤會顯示空間裡所有被提問的問題和答案。 您可以依時間、評等、用戶或狀態來篩選問題。 藉由監視空間，Genie 空間編輯器可以主動瞭解商務使用者所引發的查詢，以及 Genie 空間的回應方式。

找出 Genie 所苦苦掙扎的問題，可協助您使用特定指示來更新 Genie 空間，以改善其回應。 按兩下問題以開啟問題和回應文字，並檢視完整的聊天對話。

共享 Genie 空間

重要

Genie space 用戶必須使用自己的認證來存取數據。 任何他們無法存取的資料問題都會產生空回應。

當您共用 Genie 空間時，用戶必須具有下列許可權才能與空間互動：

• 許可權： 使用者存取權或 Databricks SQL 工作區許可權。 請參閱 權限管理。
• 計算： 必須擁有 Genie 空間指定之預設倉儲的 CAN USE 權限。
• 資料存取： 必須在空間中使用的所有 Unity Catalog 資料物件上，擁有至少SELECT的存取權。
• Genie 空間 ACL： 至少要有 CAN 檢視/CAN 執行的權限。 請參閱 Genie 空間 ACL。

新的Genie空間預設會儲存至您的使用者資料夾。 與其他工作區對象一樣，它們會從封入資料夾繼承許可權。 您可以使用工作區資料夾結構與其他用戶共用。 請參閱 將工作區對象組織成資料夾。

您也可以指定要在指定許可權層級共用的特定使用者或群組：CAN MANAGE、CAN EDIT、CAN RUN 和 CAN VIEW。

若要與特定使用者或群組共用：

1. 按一下 [分享]。
2. 輸入您想要與其共用空間的使用者或群組。 然後按下 [ 新增 ] 並設定適當的許可權等級。 個別使用者和小型群組的成員會收到電子郵件通知，確認已共享空間。
3. 使用 [共用] 對話框底部的 [ 複製連結 ] 按鈕，取得 Genie 空間的可共用連結。 特殊許可權使用者可以點擊連結，以在新索引標籤中開啟 Genie 空間，並提出問題。

複製 Genie 空間

複製 Genie 空間會建立一份包括所有設定內容和指示的副本。 當您想要在個別空間中測試變更，或在新的空間中重複使用原始內容時，複製會很有用。 複製空間之後，新空間與原始空間無關。 您可以進行編輯和調整，而不會影響原始專案。

將下列元素複製到 Genie 複製空間：

• 數據表和設定
• 一般指示
• SQL 查詢範例
• SQL 函式

現有的聊天線程和 監視 數據不會複製到新的空間。

若要複製 Genie 空間，請執行下列動作：

1. 請開啟您想要複製的 Genie 空間。
2. 單擊 空間右上角的kebab 功能表。
3. 按兩下 [ 複製]。
4. （選擇性）在 [ 複製] 對話框中，為複製的 Genie 空間指定新的名稱和工作區資料夾位置。
5. 點擊複製以建立新的空間。

其他資源

• 如需最佳做法和疑難解答問題的指引，請參閱 策劃有效的 Genie 空間。
• 若要瞭解如何使用稽核記錄來追蹤 Genie 空間中的活動和使用量，請參閱 AI/BI Genie 事件。
• 請參閱 使用 Genie 對話 API 將 Genie 整合到您的應用程式 中，以瞭解如何使用 Genie 交談 API。
• 若要瞭解如何使用馬賽克 AI 代理程式架構建立多代理程式系統，請參閱 在多代理程式系統中使用 Genie。