您可以建立自訂實體，比對專屬代理商的資料。舉例來說，您可以定義 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 套件， 這是一個 ZIP 檔案，內含目錄和 JSON 檔案的階層。 目錄結構如下：
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 專案。
- 選取代理程式。
- 選取「管理」分頁標籤。
- 按一下「實體類型」。
- 選取實體。
- 按一下「匯入至實體」。
- 選取檔案。
- 按一下「提交」。