Lijstentiteit

Belangrijk

LUIS wordt op 1 oktober 2025 buiten gebruik gesteld en vanaf 1 april 2023 kunt u geen nieuwe LUIS-resources maken. We raden u aan uw LUIS-toepassingen te migreren naar gesprekstaalbegrip om te profiteren van continue productondersteuning en meertalige mogelijkheden.

Lijstentiteiten vertegenwoordigen een vaste, gesloten set gerelateerde woorden, samen met hun synoniemen. LUIS detecteert geen aanvullende waarden voor lijstentiteiten. Gebruik de functie Aanbevelen om suggesties voor nieuwe woorden weer te geven op basis van de huidige lijst. Als er meer dan één lijstentiteit met dezelfde waarde is, wordt elke entiteit geretourneerd in de eindpuntquery.

Een lijstentiteit is niet machine learning. Het is een exacte tekstovereenkomst. LUIS markeert een overeenkomst met een item in een lijst als een entiteit in het antwoord.

De entiteit is geschikt wanneer de tekstgegevens:

• Een bekende set.
• Verandert niet vaak. Als u de lijst vaak wilt wijzigen of de lijst zelf wilt uitbreiden, is een eenvoudige entiteit die wordt verhoogd met een woordgroepenlijst een betere keuze.
• De set maximale begrenzingen van LUIS voor dit entiteitstype niet overschrijdt.
• De tekst in de utterance is een hoofdlettergevoelige overeenkomst met een synoniem of de canonieke naam. LUIS gebruikt de lijst niet buiten de overeenkomst. Fuzzy matching, stemming, plurals en andere variaties worden niet opgelost met een lijstentiteit. Hiervoor kunt u overwegen een patroon met de optionele tekstsyntaxis te gebruiken.

Voorbeeld .json om te importeren in de lijstentiteit

U kunt waarden importeren in een bestaande lijstentiteit met behulp van de volgende .json-indeling:

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

Voorbeeld van JSON-antwoord

Stel dat de app een lijst heeft met de naam Cities, die variaties van stadsnamen mogelijk maakt, waaronder de plaats van de luchthaven (Sea-tac), luchthavencode (SEA), postcode (98101) en het netnummer van de telefoon (206).

Lijstitem	Item synoniemen
Seattle	sea-tac98101, sea, 206+1
Paris	cdg, , roissyory, 75001, , , 1+33

book 2 tickets to paris

In de vorige uiting wordt het woord paris als onderdeel van de Cities lijstentiteit toegewezen aan het item parijs. De lijstentiteit komt overeen met zowel de genormaliseerde naam van het item als de synoniemen van het item.

Antwoord van V2-voorspellingseindpunt

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

Antwoord van V3-voorspellingseindpunt

Dit is de JSON als verbose=false deze is ingesteld in de querytekenreeks:

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

Dit is de JSON als verbose=true deze is ingesteld in de querytekenreeks:

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

Gegevensobject	Naam van entiteit	Weergegeven als
Lijstentiteit	Cities	paris

Volgende stappen

Meer informatie over entiteiten:

• Entiteitstypen
• Entiteiten maken