建立語意增強

建立增強前

請考慮您要提供的內容類型:

• 您是否定義業務詞彙或度量?
• 您要說明如何計算項目嗎?
• 您是否提供特定欄位的資料品質指引?
• 您描述物件之間的關係嗎?
• 您是否設定預設篩選條件?

這有助於判斷正確的範圍 (資料空間、物件或欄位),以及如何發詞增強陳述式。

建立增強

1. 瀏覽至「語意增強」清單檢視。
2. 按一下「新增語意增強」。
3. 輸入清楚識別增強目的的 名稱。範例：「已啟用客戶定義」或「收入欄位指引」。
4. 選取 範圍:
   • 物件：適用於特定資料湖物件 (DLO) 或資料模型物件 (DMO)。用於物件特定指引。
   • 欄位：適用於物件內的特定欄位。用於欄位級轉譯。
5. 如果您選取的是 物件或 欄位範圍,請從下拉式清單中選擇目標物件或欄位。
6. 在「語意陳述式」欄位中,以清晰明確的語言撰寫您的增強。具體說明規則的套用時間與方式。您可以撰寫複雜業務規則的多句話增強。範例：
   • 「已啟用客戶是狀態為「已啟用」且過去 90 天內至少有一個訂單的客戶。」
   • 「使用 amount_usd__c 計算收入。此欄位以美元表示交易大小。」
   • 「篩選 email_address 時,請一律使用小寫比較,因為某些舊版資料有混合的個案值。」
   • 「高價值機會定義為 amount_usd__c 大於 $100,000,且階段等於 'Proposal' 或 'Negotiation'」。針對區域分析,請使用 region__c 欄位,而非帳單地址州。在 2023 年之前的歷史性高價值機會使用了由於通貨膨脹調整而設的 $50,000 個差異值。」
7. (選用) 新增 標記以組織相關增強。使用一致的標記,例如「revenue」、「customer-segmentation」或「data-quality」,以便稍後更容易找到和管理增強。標記僅適用於組織,且不會影響工作人員取得的增強。
8. (選用) 如果工作人員一律必須考量此增強,請選取「重要」。用於基本業務規則或資料品質限制。將過多增強標記為「重要」會造成內容膨脹並使查詢速度變慢,因此請謹慎使用。
9. (選用,但建議使用) 新增「對應摘要」以改善語意增強所取得的結果。這些是您預期會顯示在使用者問題中的關鍵字或片語。例如,如果語意陳述式定義客戶終身價值,請新增對應摘要,例如「CLV」和「客戶終身價值」。
10. 按一下「儲存」。

撰寫有效的語意陳述式

語意陳述式會教工作人員如何將純文字問題轉為對資料的正確查詢。每個有效陳述式都會回答三個問題:

• 規則為何?工作人員應遵循的指示。
• 為什麼會存在?背後的推理。
• 如果忽略,會發生什麼事?您嘗試避免的錯誤回答。

「為什麼」最重要。沒有理由的規則會被文字所示地遵循,並會破壞您未預期的任何問題。含引數的規則可讓工作人員處理您從未寫下的個案。將僅提供規則的較弱陳述式與新增邏輯和結果的強式陳述式比較:

• 弱 (僅限規則):「一律篩選狀態 = 「已啟用」。」
• 強大 (規則、推理及結果):「一律在每個查詢上篩選「狀態 = 已啟用」。表格會儲存已啟用和已歸檔的客戶記錄。若沒有此篩選條件,結果會混入不再相關的已歸檔客戶。這也適用於使用者詢問一個具名客戶時。」

當您撰寫陳述式時,請遵循下列指導方針:

具體

請撰寫「使用 amount_usd__c 進行收入計算,因為它代表以美元表示的交易大小,且會一直填入」。

說明原因

不要只是說明規則,而是說明原因。「依狀態篩選 = 「已啟用」,因為未啟用的客戶不應顯示在報告中。」

使用範例

定義計算時,顯示公式或邏輯。「客戶終身價值 = total_revenue / months_active * average_customer_lifespan_months」。

清楚說明州/省條件

如果規則僅適用於特定個案,請假設時間。「針對機會查詢,除非有明確要求,否則請排除 stage = 'Closed Lost'。」

避免使用語法

以工作人員可剖析的純文字撰寫。如果您必須使用網域特定的字詞,請定義字詞。

語意陳述式的最佳作法

• 每個陳述式一個規則。請勿結合不相關的規則。當工作人員提取陳述式時,會提取整個內容,因此涵蓋五個主題的陳述式會在每次符合時新增四個不相關的規則。
• 使用規則領導,然後說明原因。先說明指示,接著說明推理,接著說明錯誤的後果。
• 說不要做什麼如果兩個欄位或值很容易混淆,請明確命名錯誤的欄位或值。「永不將貨運日期用於收入問題」與命名正確的欄位一樣重要。
• 拼出工作人員無法猜到的值。工作人員會看見欄位名稱,而不會看見其中的值。當有效集短且非明顯時列出。
• 澄清格式與單位。如果數字以乘數、百分比或以美分儲存,則為例。否則「小於 2 倍」或「大於 50%」會誤讀。
• 將每個陳述式附加至最窄的正確目標。一個欄位的相關規則屬於該欄位。跨越多個欄位的規則屬於物件。這可讓不相關的問題保持乾淨,並在正確的時間呈現正確的規則。
• 僅將「重要」用於適用於幾乎每個問題的規則。一律套用「重要」陳述式。只有在問題符合其對應摘要時,才會提取非重要陳述式。將「重要」保留給通用規則,並將計數保持小。
• 以使用者實際輸入的文字撰寫對應摘要。以下是呈現非重要陳述式的觸發片語。使用實際的片語、同義詞和縮寫,而非技術描述。

您可以新增的內容類型

語意陳述式可以取用許多種類型的業務內容。常見類型包括:

測試您的增強

建立增強之後,透過詢問工作人員應觸發的問題來進行測試。檢閱工作人員的回應,並檢查「檢視更多詳細資料」區段,以查看增強是否已正確套用。如果工作人員未如預期使用增強:

• 請確認增強已 啟用。
• 檢查範圍 (資料空間、物件或欄位) 是否符合您的問題。
• 將語意陳述式修訂為更具體,或新增相關標記。
• 如果增強為基礎,請將其標記為「重要」。

後續步驟

請參閱 管理語意增強以瞭解如何在資料模型發展時編輯、停用或刪除增強。