你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

列表实体

重要

LUIS 将于 2025 年 10 月 1 日停用，从 2023 年 4 月 1 日开始，你将无法创建新的 LUIS 资源。 建议将 LUIS 应用程序迁移到对话语言理解，以便从持续的产品支持和多语言功能中受益。

列表实体表示一组固定、封闭的相关单词及其同义词。 LUIS 不会为列表实体发现更多值。 使用“建议”功能根据当前列表查看有关新词的建议。 如果存在多个具有相同值的列表实体，则终结点查询中会返回其中每个实体。

列表实体不进行机器学习。 它是确切的文本匹配。 LUIS 将任何列表中某个项的任何匹配项标记为响应中的实体。

如果文本数据具有以下特征，则非常适合使用此实体：

• 是已知的集。
• 不经常更改。 如果需要经常更改列表或希望列表自行扩展，则使用短语列表提升的简单实体是更好的选择。
• 此集不超出此实体类型的最大 LUIS 边界。
• 言语中的文本是同义项或规范名称的不区分大小写的匹配。 LUIS 不会在不匹配的情况下使用该列表。 使用列表实体无法解析模糊匹配、词干提取、复数形式和其他变体。 若要管理变体，请考虑使用带有可选文本语法的模式。

用于导入到列表实体的示例 .json

可使用以下 .json 格式将值导入现有列表实体：

[
    {
        "canonicalForm": "Blue",
        "list": [
            "navy",
            "royal",
            "baby"
        ]
    },
    {
        "canonicalForm": "Green",
        "list": [
            "kelly",
            "forest",
            "avacado"
        ]
    }
]

示例 JSON 响应

假设应用有一个名为 Cities 的列表，允许城市名称的变体，包括机场城市 (Sea-tac)、机场代码 (SEA)、邮政编码 (98101) 和电话区号 (206)。

列表项	项同义词
Seattle
Paris

book 2 tickets to paris

在之前的陈述中，单词 paris 映射至属于 Cities 列表实体一部分的“巴黎”项。 列表实体同时匹配项的规范化名称及其同义词。

V2 预测终结点响应

  "entities": [
    {
      "entity": "paris",
      "type": "Cities",
      "startIndex": 18,
      "endIndex": 22,
      "resolution": {
        "values": [
          "Paris"
        ]
      }
    }
  ]

V3 预测终结点响应

如果在查询字符串中设置了 verbose=false，则这是 JSON：

"entities": {
    "Cities": [
        [
            "Paris"
        ]
    ]
}

如果在查询字符串中设置了 verbose=true，则这是 JSON：

"entities": {
    "Cities": [
        [
            "Paris"
        ]
    ],
    "$instance": {
        "Cities": [
            {
                "type": "Cities",
                "text": "paris",
                "startIndex": 18,
                "length": 5,
                "modelTypeId": 5,
                "modelType": "List Entity Extractor",
                "recognitionSources": [
                    "model"
                ]
            }
        ]
    }
}

数据对象	实体名称	Value
列表实体	Cities	paris

后续步骤

详细了解实体：

• 实体类型
• 创建实体