实体

实体类型用于控制最终用户输入数据的提取方式。

Conversational Agents (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.EntityEntityType_Entity)。

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