策劃有效的 Genie 空間

策劃 Genie 空間是為了建立環境，讓商務使用者可根據資料提出自然語言問題，獲得準確的一致答案。 Genie 空間使用進階模型產生複雜的查詢，以及理解一般世界知識。

商務問題多半屬於特定領域，因此空間策劃者的角色，應弭平一般世界知識與特定領域或特定公司所使用的特殊語言之間的差距。 策劃者使用中繼資料和指令，協助 Genie 準確解譯和回覆商務使用者的問題。 本文概述最佳做法和原則，引導您順利開發空間。

定義新空間的最佳做法

下列各節建議用於建立有效空間的做法。

從小規模開始

策劃 Genie 空間是反覆的過程。 建立新的空間時，一開始規模請盡量小，搭配最少的指令和有限的待回答問題組。 接著，您可在根據意見反應和監視迭代時再增加。 這種方法有助於簡化建立及維護空間，並可讓您回應真正的使用者需求，有效策劃空間。

使用下列指導方針，協助建立小型 Genie 空間：

• 集中焦點：只包含回答您希望空間處理之問題所需的資料表。 以五個或更少的資料表為目標。 選擇的項目越集中越好。 不妨讓空間僅聚焦於少量資料，限制包含之資料表中的資料行數目。
• 規劃反覆運算：從您空間的最低設定開始，著重於基本數據表和基本指示。 新增更詳細的指引和範例，因為您可以隨著時間調整空間，而不是一開始針對完美。
• 以妥善標註的資料表為基礎：Genie 使用 Unity Catalog 資料行名稱和描述產生回覆。 清除資料行名稱和描述，有助於產生高品質的回覆。 資料行描述應提供內容相關的精確資訊。 避免模棱兩可或不必要的詳細資料。 檢查任何 AI 產生的描述是否正確清晰，僅限使用與您手動提供之描述一致的項目。

請領域專家定義空間

空間建立者必須了解可從中擷取的資料和深入解析，才能產生預期結果。 精通 SQL 的資料分析師通常具備策劃空間的知識和技能。

定義空間的用途

識別空間的特定對象和用途，有助於您決定要使用的資料、指令和測試問題。 空間應回答特定主題與對象的問題，而非跨各種領域的一般問題。

測試和調整

您應該是空間的第一個使用者。 建立新空間之後，請開始提出問題。 仔細檢查為回覆問題產生的 SQL。 如果 Genie 不正確解譯資料、問題或商務術語，編輯產生的 SQL 或提供其他特定指令即可干預。 持續測試和編輯，直到您獲得可靠的回覆為止。

檢閱問題之後，您可以將它新增為基準問題，讓您可用來進行系統性測試和評分空間，取得整體正確性。 您可以使用變化和不同的問題片語來測試 Genie 的回應。 請參閱在 Genie 空間中使用基準檢驗。

如需修正錯誤回覆的構想，請參閱疑難排解。

執行使用者測試

透過測試驗證回覆品質之後，請招募商務使用者來試用 Genie 空間。 使用下列指導方針，提供順暢的使用者旅程圖，並收集意見反應持續改善：

• 讓對方明確瞭解，他們的工作是改善房間。
• 要求他們專注於特定主題的測試，以及空間設計應回答的特定主題和問題。
• 如果他們收到的回覆不正確，鼓勵使用者在聊天時新增其他指令並釐清問題，讓答案精益求精。 提供的回覆正確無誤時，他們應附議最終查詢，以在未來互動時儘量減少類似錯誤。
• 請使用者使用內建的意見反應機制，附議或反對回覆。
• 邀請使用者直接與空間作者分享其他意見反應和未解決的問題。 作者和編輯可以使用意見反應精簡指令、範例和信任的資產。

請考慮提供訓練教材，或是隨附測試房間和提供意見反應指導方針的書面文件。 商務使用者測試空間時，您會看到他們在 [歷程記錄]索引標籤詢問的問題。請繼續新增指令，協助 Genie 正確解譯問題和資料，提供準確的答案。 若要深入了解如何監視 Genie 空間，請參閱檢閱歷程記錄和意見反應。

疑難排解

下列各節概述如何解決常見問題。

誤解的商業術語

大部分的公司或領域都有用來傳達特定商務事件的特定速記法。 例如，提及一年時，可能一律指會計年度，而且這個會計年度可能從 2 月或 3 月開始，而不是 1 月。 若要讓 Genie 自然準確回答這些問題，請包含將商務術語明確對應至 Genie 可理解之字詞和概念的指令。 請參閱提供指令。

不正確的資料表或資料行使用方式

如果 Genie 嘗試從不正確的資料表接收資料，或對不正確的資料行執行分析，您可以用下列其中一種方式調整資料：

• 提供清楚精確的描述：查看資料表和相關聯的中繼資料，檢查它們使用的術語是否符合提交問題中的使用者術語。 如果不符合，請精簡描述或新增指令，將資料表使用的術語對應至問題使用的術語。
• 新增範例查詢：提供 Genie 可用來了解如何回覆特定問題的範例 SQL 查詢。 請參閱提供指令。
• 從空間移除資料表或資料行：部分資料表可能包含重疊的資料行或概念，導致 Genie 難以得知要在回覆中使用哪些資料。 盡可能移除不必要或重疊的資料表或資料行。 您不妨建立只包含必要資料行的檢視表。

篩選錯誤

產生的查詢通常包含 WHERE 子句，會根據特定值篩選結果。 由於 Genie 無法查看實際資料，所以可能將 WHERE 子句設定為篩選不正確的值。 例如，資料表使用「CA」等縮寫時，它可能嘗試比對名稱「California」。

針對這類情況，請嘗試下列其中一個策略：

• 如果資料行值的集合相當小，請列舉每個資料行描述的有效字串。 將引號放在字串值周圍，尤其是如果值有空格或數字時。 有時候，針對常見的列舉，光是寫「使用三個字母的國家/地區 ISO 代碼」就足夠了，而不是列出每個州值。

不正確的聯結

如果 Unity Catalog 未定義外部索引鍵，空間可能不知道該如何聯結不同的資料表。

請嘗試實作下列一或多個解決方案：

• 盡可能在 Unity Catalog 定義外部索引鍵參考。 請參閱限制式子句。
• 提供以標準方式將資料表聯結在一起的查詢範例。
• 如果資料表的外部索引鍵關聯性未在 Unity Catalog 指定，請在指令記錄這些關聯性。

如果這些方法都無法解決問題，請將資料表預先聯結至檢視圖，並改用它做為空間的輸入。 此策略有助於較複雜的聯結案例，例如自我聯結。

計量計算問題

計量的計算和積存方式可能錯縱複雜，並包含空間無法理解的許多商務詳細資料。 這可能導致報告不正確。

請嘗試實作下列一或多個解決方案：

• 如果計量是從基底資料表彙總，請提供計算每個積存值的 SQL 查詢範例。
• 如果計量已預先計算且位於彙總資料表，請在資料表註解說明這一點。 如果可以進一步積存該資料表中的計量，請指定每個計量的有效彙總。
• 如果您嘗試產生的 SQL 非常複雜，請嘗試建立已彙總空間計量的檢視圖。

忽略指令

即使您已在註解說明資料表和資料行，並提供一般指令，空間的用法可能依舊不正確。

請嘗試下列一或多個策略：

• 提供正確使用資料表的查詢範例。 查詢範例對於指導空間如何使用資料特別有效。
• 從資料表建立檢視圖，提供更簡化的資料檢視圖。
• 請檢閱指令，並嘗試移除不相關的資料表或指令讓空間集中。
• 請嘗試開始新的聊天。 先前的互動可能影響 Genie 在任何給定聊天中的回覆，但開始新的聊天可讓您有空白的起點可測試新指令。

效能問題

Genie 需要產生異常長的查詢或文字回覆時，可能需要很長的時間才能在思考階段回覆，或者甚至逾時。

請嘗試用下列一或多個動作改善效能：

• 使用信任的資產或檢視圖，封裝複雜的查詢。 請參閱在 AI/BI Genie 空間中使用受信任的資產。
• 盡可能減少 SQL 查詢範例的長度。
• 如果 Genie 開始產生緩慢或失敗的回覆，請開始新的聊天。

對任務關鍵性問題的回覆不可靠

使用信任的資產，提供您預期使用者會詢問之特定問題的已驗證解答。 請參閱在 AI/BI Genie 空間中使用受信任的資產。

令牌限制警告

權杖是 Genie 用於處理和理解語言的基本文字單位。 Genie 空間中以指示或元數據的形式包含的文字會轉換成令牌。 如果空間中的令牌數目接近限制，則產品會通知您警告。 Genie 會套用智慧型手機內容篩選，以選取代表元數據的令牌，以及 Genie 空間中包含的某些指示類型。 即使您超過限制，空間仍應繼續產生問題的回應。

如果您的 Genie 空間接近令牌限制，Genie 可能會只排定優先順序，包括數據表架構的部分，以及與問題最相關的指示。 如果篩選掉重要內容，這可能會降低響應品質。請考慮下列做法來減少令牌計數：

• 移除不必要的資料行：資料表中不必要的資料行，可能大幅增加權杖使用量。 建立檢視圖，從原始資料表排除冗餘或非必要欄位。
• 簡化資料行描述：資料行描述雖然重要，但請避免複製資料行名稱已傳達的資訊。 例如，如果資料行命名為 account_name，則「帳戶名稱」這類描述可能是多餘的，可以省略。
• 簡化指令：確認指令清晰簡潔。 避免不必要的字。
• 修剪範例 SQL 語句：包含各種範例 SQL 語句，以涵蓋各種類型的問題，但移除重疊或多餘的範例。

您的帳戶未啟用跨地理位置處理

Genie 是由 Azure Databricks 管理的指定服務 。 指定的服務會使用 Databricks 地理位置來管理數據落地。 對於某些區域，無法在與工作區相同的地理位置中處理數據。 如果您的工作區位於其中一個區域， 您的帳戶管理員必須啟用跨地理位置處理 。