您可以建立自訂實體，以便比對特定服務專員的資料。舉例來說，您可以定義 vegetable 實體類型，以便比對可在日用品商店代理程式中購買的蔬菜種類。
建立自訂實體
如要建立自訂實體，請按照下列步驟操作：
主控台
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「實體類型」。
- 按一下 [建立]。
- 輸入實體資料。
- 按一下 [儲存]。
API
請使用 EntityType 的 create 方法。
選取 EntityType 參照的通訊協定和版本：
| 通訊協定 | V3 | V3beta1 |
|---|---|---|
| REST | EntityType 資源 | EntityType 資源 |
| RPC | EntityType 介面 | EntityType 介面 |
| C++ | EntityTypesClient | 不適用 |
| C# | EntityTypesClient | 不適用 |
| Go | EntityTypesClient | 不適用 |
| Java | EntityTypesClient | EntityTypesClient |
| Node.js | EntityTypesClient | EntityTypesClient |
| PHP | 不適用 | 不適用 |
| Python | EntityTypesClient | EntityTypesClient |
| Ruby | 不適用 | 不適用 |
限制
限制如下：
- 每個代理程式都會使用不重複的自訂實體類型顯示名稱。實體類型顯示名稱的開頭應為英文字母，且可包含以下項目：
A-Z、a-z、0-9、_(底線)、-(連字號)。實體參照和同義詞值則不受此限制。
匯出及匯入自訂實體
您可以匯出及匯入實體，以便在各個服務專員之間共用。
其中一個匯出格式選項是 JSON 套件，這是一個包含目錄和 JSON 檔案階層的 ZIP 檔案。以下說明目錄結構：
entityTypes：這個目錄包含實體類型。<entity type name>：存在一個或多個目錄，且目錄名稱對應至實體類型的顯示名稱。entities：這個目錄包含實體項目檔案。<language tag>.json：存在一或多個此類檔案，且檔案名稱對應至語言代碼。每個檔案都包含特定語言的實體項目。
<excludedPhrases>：這個目錄包含排除的詞組檔案。<language tag>.json：存在一或多個此類檔案，且檔案名稱對應至語言代碼。每個檔案都包含特定語言的排除字詞。
<entity type name>.json：這個檔案名稱對應至實體類型的顯示名稱。檔案包含其他檔案中找不到的實體類型專屬資料。
例如：
entityTypes ⤷ Entity Type A ⤷ entities ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ excludedPhrases ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ Entity Type A.json ⤷ Entity Type B ⤷ entities ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ excludedPhrases ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ Entity Type B.json
匯入實體類型時，如果現有代理程式中的實體類型顯示名稱與匯入的實體類型顯示名稱相符，就可能發生合併衝突。您可以選取下列任一選項，控制實體類型顯示名稱相符時的合併行為：
- 取代現有實體類型：匯入的實體類型會覆寫現有代理程式中名稱相同的實體類型。
- 與現有實體類型合併：匯入的實體類型實體項目會新增至現有實體類型。如果有相同的實體項目，系統不會重複這些項目，而是會合併其中的同義字。
- 重新命名並匯入為新的實體類型：匯入的實體類型會在顯示名稱後方加上「_1」重新命名。
- 略過實體類型：現有實體類型保持不變，系統會忽略匯入的實體類型。
如何匯出實體類型：
主控台
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「實體類型」。
- 選取要匯出的所有實體類型。
- 按一下「匯出所選實體」。
- 選取格式和目的地。
- 按一下「提交」。
如何匯入實體類型：
主控台
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「實體類型」。
- 按一下「匯入」。
- 選取來源和合併行為。
- 按一下「提交」。
匯入實體項目
您可以將實體項目匯入現有的實體類型。
匯入實體項目時使用的檔案格式，與匯入實體類型時使用的格式相同。不過，匯入檔案只能包含 1 個實體類型，且其中的所有項目都會匯入所選實體類型。如果有相同的實體項目，系統不會重複這些項目，而是會合併其中的同義字。
如要匯入實體類型的實體項目，請按照下列步驟操作：
主控台
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「實體類型」。
- 選取實體。
- 按一下「匯入至實體」。
- 選取檔案。
- 按一下「提交」。