清單實體

重要

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	sea-tac、、 sea、 98101、 206、 +1
Paris	cdg、、roissyory、75001、、1、+33

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"
                ]
            }
        ]
    }
}

數據物件	實體名稱	值
清單實體	Cities	paris

下一步

深入了解實體：

• 實體類型
• 建立實體