您可以创建自定义实体来匹配特定于代理的数据。例如，您可以定义一个 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 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击实体类型。
- 选择一个实体。
- 点击导入到实体。
- 选择文件。
- 点击提交。