实体

实体类型用于控制如何从最终用户输入中提取数据。

Dialogflow CX 提供预定义的系统实体,可以匹配许多常见类型的数据。例如,有用于匹配日期、时间、颜色、电子邮件地址等类型的系统实体。您还可以创建自己的自定义实体,用于匹配自定义数据。例如,您可以定义一个 vegetable 实体,来匹配杂货店代理出售的蔬菜类型。

实体术语

本文档和 Dialogflow CX 控制台中使用术语实体来描述实体的一般概念。在讨论实体详情时,了解更具体的术语非常重要:

  • 实体类型:定义要从用户输入中提取的信息类型。 例如,vegetable 可以是实体类型的显示名称。在 Dialogflow CX 控制台的实体类型部分中点击创建,即可创建实体类型。使用 API 时,术语“实体类型”指的是 EntityType 类型。

    为 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 不可用 不可用

  • (可选)说明:描述实体类型的用途,例如“当用户提及蔬菜时,会触发此实体”。如果您打算使用 AI 生成功能自动生成参考值同义词,模型将使用此字段来生成更高质量的结果。

  • 实体条目:每种实体类型都可以有多个实体条目。每个实体条目都提供一组被视为等效的字词或短语,第一列中有一个参考值,第二列中有一个或多个该参考值的同义词。例如,如果 vegetable 是实体类型,您可以定义以下实体条目:

    引用值 同义词
    scallion scallion、green onion
    灯笼椒 bell pepper、sweet pepper
    carrot carrot
    土豆 土豆、马铃薯、块茎

    您可以在创建新的实体条目时选中为每个实体自动生成 __ 个同义词复选框,而不是手动输入实体条目和同义词。默认值为 3 个同义词。AI 将根据参考值和实体类型说明生成同义词,并将其输入到表格中。请注意,同义词列表还必须包含原始参考值,以便与该值匹配。

    从 Dialogflow CX 控制台修改实体类型时,显示的每一行都是一个实体条目。使用 API 时,术语实体条目指的是 Entity 类型(某些客户端库语言中为 EntityType.Entity 或 EntityType_Entity)。

  • 实体参考值和同义词:某些实体条目具有多个被视为等同的字词或短语,例如上一个示例中的葱。针对这些实体条目,您需要提供一个引用值以及一个或多个同义词。