實體評估概觀

助理會使用下列其中一個評估方法來偵測使用者輸入中的實體：

• 以字典為基礎的方法
• 以註釋為基礎的方法

建立實體

1. 按一下 實體。

2. 按一下建立實體。

   您也可以按一下系統實體，從 IBM 所提供且可套用至任何使用案例的共用實體清單中進行選取。 如需詳細資料，請參閱啟用系統實體。

3. 在實體名稱欄位中，鍵入實體的敘述性名稱。

   實體名稱可以包含字母（Unicode 編碼）、數字、底線及連字號。 例如：

   • @location
   • @menu_item
   • @product

   名稱中不可包括空格。 名稱的長度不能超過 64 個字元。 名稱的開頭不能是 sys- 字串，因為此字串保留供系統實體使用。

   at 符號前綴 @ 會自動添加到實體名稱中，以識別該術語為實體。 您不需要新增它。

4. 按一下建立實體。

   

5. 針對此實體，選擇您要讓助理使用以字典為基礎的方法還是以註釋為基礎的方法來尋找其提及項目，然後遵循適當的程序。

   針對您建立的每個實體，僅選擇一個要使用的實體類型。 一旦新增實體的註釋，即會起始設定環境定義模型，並使其成為分析使用者輸入，以尋找該實體之提及項目的主要方法。 在使用者輸入中使用提及項目的環境定義，其優先順序高於可能存在的任何完全相符項。 如需相關資訊，請參閱 實體評估概觀。

新增以字典為基礎的實體

字典型實體用來定義特定術語、同義字或型樣。 在執行時期，只有在使用者輸入中的詞彙完全符合（或在已啟用模糊比對時，為幾乎符合）值或其中一個同義字時，助理才會找到實體提及項目。

1. 在值名稱欄位中，輸入值。 例如，對於 @city 實體，您可以輸入 New York City。

   實體值可以是任何字串，長度最多為 64 個字元。

   **重要事項：**請不要在實體名稱或值中包含機密或個人資訊。 名稱和值可以包含在應用程式的 URL 中。

2. 為該值新增同義字。 例如，您可以將 NYC 和 The Big Apple 新增為 New York City 的同義字。

   同義字可以是任何字串，長度最多為 64 個字元。

   如果您要定義助理在使用者輸入中尋找的型樣（例如產品訂單號碼或電子郵件位址），則請改為定義型樣值。 如需詳細資料，請參閱新增可辨識型樣的實體。

   **附註：**您可以為單一實體值新增同義字或 型樣，但不能同時新增這兩者。

3. 如果您要助理使用與您指定實體值及同義字類似的語法來辨識術語，但不需要完全相符，請將模糊比對切換設為開啟。

   例如，如果您新增 apple 作為 @fruit 實體的值，而使用者輸入 apples 或 appel，如果啟用模糊比對，您的助理會將該字詞識別為 @fruit 的提述。 如需相關資訊，請參閱模糊比對運作方式。

4. 按一下新增值，然後重複新增其他實體值的處理程序。

   如果您要新增多個值，則請按 Shift+Enter 鍵以完成現行值的新增，並將焦點保留在值欄位中，以新增下一個值。

5. 新增實體值後，按一下 以完成建立實體。

您所建立的實體已加入，系統會根據新資料進行自我訓練。

新增環境定義實體

使用以註解為基礎的實體，註解實體在範例句子中出現的次數，讓您的助手了解實體通常使用的上下文。

若要訓練上下文實體模型，您可以利用您的意向範例，這些範例會提供可註解的句子。

此特性已在英文對話技能中正式發行，並可作為法文對話技能中的測試版特性。 如需相關資訊，請參閱支援的語言。

使用目的的使用者範例來定義環境定義實體，並不會影響該目的的分類。 不過，您標示的實體提及項目也會新增至該實體作為同義字。 此外，目的分類會使用目的使用者範例中的同義字提及項目，來建立目的與實體之間的弱參照。

1. 按一下 目的。

2. 按一下目的，以將其開啟。

3. 按一下註釋實體，然後檢閱目的範例，以尋找潛在的實體提及項目。

4. 按一下目的範例中作為單一實體提及項目一部分的任一字組、多個字組或標點符號。

   在此範例中，mobile phones 是實體提及項目。

   

   即會開啟「搜尋」方框，您可以使用它來搜尋實體，其中強調顯示的字組或詞組為該實體的提及項目。

   

5. 輸入要搜尋的實體名稱。 您不需要包含開頭的 @ 符號。

   執行下列其中一項作業：

   • 如果實體具有任何現有的實體值，則顯示的這些值僅供參考。 您會將註釋新增至實體，而非任何特定的實體值。

   • 如果您要教導模型，讓它知道提及項目與現有的實體值同義，請在實體名稱後面新增冒號 (:) 以顯示實體值的清單。 從顯示的清單中選擇實體值。 例如，@product:device。

     

6. 選取您要新增註釋的實體或實體和值。

   在此範例中，將新增 mobile phones 作為 @product 實體值的註釋，並作為 @product:device 實體值的同義字。

   為每一個環境定義實體建立 至少 10 個註釋。 建議將更多註釋用於正式作業。

7. 如果沒有任何實體適合，您可以新增新實體的名稱來建立新實體。 然後從清單中選擇 {entity_name} （建立新實體） 選項。

   

   新增 @location 實體

8. 針對您要註釋的每個實體提及項目，重複此處理程序。

   針對您所編輯之任何使用者範例中出現的實體類型，請務必為其每個提及項目進行註釋。 如需詳細資料，請參閱不註釋的內容很重要。

9. 按一下您建立的其中一個註釋。 即會顯示一個方框，指出：Go to: {entity-name}。 按一下該鏈結，可直接將您帶到實體。

   

   註解會新增到與您關聯的實體，系統會根據新資料進行自我訓練。

   您註解的術語會作為新的字典值加入實體。 如果您將註釋的詞彙與現有實體值相關聯，則該詞彙會新增為該實體值的同義字，而非新增為獨立的實體值。

   

10. 若要查看您針對特定實體所註釋的所有提及項目，請從實體的配置頁面，按一下註釋標籤。

    

    環境定義實體會瞭解您未明確定義的值。 系統會根據您使用者範例的注釋方式，預測更多的實體值，並使用這些值來訓練其他實體。 任何類似的使用者範例都會新增至註釋 視圖，因此您可以看到此選項如何影響訓練。

    如果您不想要環境定義實體使用這種擴展的實體值理解，請針對該實體選取註釋 視圖中的所有使用者範例，然後按一下刪除。

啟用系統實體

Watson Assistant 提供若干系統實體，這些系統實體是可用於任何應用程式的一般實體。 啟用系統實體可將許多使用案例共同的訓練資料快速移入您的技能。

系統實體可用來辨識其代表物件類型的廣泛範圍值。 例如，@sys-number 系統實體符合任何數值，包括整數、小數位數，甚至是以字組形式寫出的數字。

系統實體會集中進行維護，因此可自動提供任何更新。 您無法修改系統實體。

1. 在「實體」頁面上，按一下系統實體。

2. 瀏覽系統實體清單，以選擇對您應用程式有用的系統實體。

   • 若要查看系統實體的相關資訊（包括比對輸入的範例），請按一下清單中的實體。
   • 如需可用系統實體的詳細資料，請參閱系統實體。

3. 將您要使用之每一個系統實體的切換設為開啟。

啟用系統實體之後，Watson Assistant 會重新訓練。 訓練完成之後，您就可以使用這些實體。

實體限制

您可以建立的實體、實體值及同義字數目，取決於您的 Watson Assistant 服務方案：

您啟用以供使用的系統實體會計入方案用量總計。

編輯實體

您可以按一下清單中的任何實體，以開啟它來進行編輯。 您可以重新命名或刪除實體，也可以新增、編輯或刪除值、同義字或型樣。

如果您將實體類型從 synonym 變更為 pattern（或者相反），則會轉換現有值，但可能不像原來那麼實用。

搜尋實體

請使用「搜尋」特性來尋找實體名稱、值及同義字。 系統實體是無法搜尋的。

1. 從 Entities 頁面，按一下 Search。

2. 輸入搜尋詞彙或詞組。 您也可以選取 包含部分相符項。

   第一次搜尋時，您可能會收到內容正在被索引的訊息。 如果是這樣，請等待一分鐘，然後重新提交搜尋詞彙。

3. 即會顯示包含搜尋詞彙的實體及對應範例。

   

下載實體

您可以將許多實體下載到 CSV 檔案中，這樣您就可以上傳並在另一個助手中重複使用它們。

• 樣式資訊包含在下載的 CSV 檔案中。 任何使用 / 包裝的字串都會被視為型樣 (相對於同義字)。
• 不會下載與環境定義實體相關聯的註釋。 您必須下載整個對話框，才能擷取實體值和任何相關註解。

1. 移至實體頁面

   • 若要下載所有實體，請不要選取任何個別實體。 請改為按一下 下載所有實體 圖示 。

   • 若要只下載目前頁面上列出的實體，請選取標題中的核取方塊。 此動作將選取現行頁面上的所有實體。 然後按一下「下載」按鈕。

   • 若要下載一個或多個特定實體，請選取要下載的實體，然後按一下「下載」按鈕。

2. 指定儲存所產生 CSV 檔案的名稱和位置，然後按一下儲存。

上傳實體

如果您有許多實體，您可能會發現從逗號分隔值 (CSV) 檔案上傳比逐一定義更容易。

實體 CSV 檔案上傳時不包含實體註解。 您必須上傳整個對話框，以保留環境定義實體的相關聯註釋。 如果您只下載和上傳實體，那麼您下載的任何上下文實體在上傳後，都會被視為基於字典的實體。

1. 將實體收集到 CSV 檔案，或將它們從試算表匯出至 CSV 檔案。 檔案中每一行的必要格式如下：

   <entity>,<value>,<synonyms>
   

   其中 是實體的名稱， 是該實體的值，而 則是以逗號分隔的該值的同義字清單。

   weekday,Monday,Mon
   weekday,Tuesday,Tue,Tues
   weekday,Wednesday,Wed
   weekday,Thursday,Thur,Thu,Thurs
   weekday,Friday,Fri
   weekday,Saturday,Sat
   weekday,Sunday,Sun
   month,January,Jan
   month,February,Feb
   month,March,Mar
   month,April,Apr
   month,May
   

   上傳 CSV 檔案也支援模式。 任何使用 / 包裝的字串都會被視為型樣 (相對於同義字)。

   ContactInfo,localPhone,/(\d{3})-(\d{4})/
   ContactInfo,fullUSphone,/(\d{3})-(\d{3})-(\d{4})/
   ContactInfo,internationalPhone,/^(\(?\+?[0-9]*\)?)?[0-9_\- \(\)]*$/
   ContactInfo,email,/\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/
   ContactInfo,website,/(https?:\/\/)?([\da-z\.-]+)\.([a-z\.]{2,6})([\/\w \.-]*)*\/?$/
   

   儲存使用 UTF-8 編碼且沒有位元組順序標記 (BOM) 的 CSV 檔案。 CSV 檔案大小上限為 10 MB。 如果您的 CSV 檔案較大，請考慮將其分割為多個檔案，並分別上傳。 開啟您的對話技能，然後按一下實體標籤。

2. 按一下 上傳 圖示 。

3. 拖曳檔案，或瀏覽以從電腦中選取檔案，然後按一下 上傳實體。

   檔案經過驗證和上傳後，系統會根據新資料進行自我訓練。 您可以在「實體」頁面檢視上傳的實體。

刪除實體

您可以選取一些要刪除的實體。

刪除實體時，將移除與該實體關聯的任何值、同義字、型樣或註釋。 日後無法擷取這些資料。 所有參照這些實體或值的對話節點，都必須手動更新成不再參照已刪除的內容。

1. 移至實體頁面。

   • 若要刪除所有實體，請不要選取任何個別實體。 請改為按一下 刪除所有實體 圖示 。

   • 若要僅刪除現行頁面上列出的實體，請選取標頭中的勾選框。 此動作將選取現行頁面上列出的所有實體。 然後按一下刪除按鈕。

   • 若要刪除一個或多個特定實體，請選取要刪除的實體，然後按一下刪除按鈕。