清單實體

重要

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, roissy, ory, 75001, 1, +33

book 2 tickets to paris

在上述語句中，paris 一字會對應至 Cities 清單實體中的 paris 項目。 此清單實體會同時比對項目的正規化名稱及項目同義字。

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

下一步

深入了解實體：

• 實體類型
• 管理實體