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