Lijstentiteit

Belangrijk

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

Lijstentiteiten vertegenwoordigen een vaste, gesloten set gerelateerde woorden, samen met hun synoniemen. LUIS detecteert geen extra waarden voor lijstentiteiten. Gebruik de functie Aanbevelen om suggesties voor nieuwe woorden te bekijken 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 past goed wanneer de tekstgegevens:

• Zijn een bekende set.
• Verandert niet vaak. Als u de lijst vaak wilt wijzigen of als u de lijst zelf wilt uitbreiden, is een eenvoudige entiteit met een woordgroepenlijst een betere keuze.
• De set maximale begrenzingen van LUIS voor dit entiteitstype niet overschrijdt.
• De tekst in de uiting is een niet-hoofdlettergevoelige overeenkomst met een synoniem of de canonieke naam. LUIS gebruikt de lijst niet buiten de overeenkomst. Fuzzy overeenkomsten, stemmingen, meervouden en andere variaties worden niet opgelost met een lijstentiteit. Hiervoor kunt u overwegen een patroon met de optionele tekstsyntaxis te gebruiken.

Voorbeeld van .json om te importeren in 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 plaatsnamen mogelijk maakt, waaronder plaats van luchthaven (Sea-tac), luchthavencode (SEA), postcode (98101) en telefoonnummer (206).

Lijstitem	Item-synoniemen
Seattle	sea-tac, sea, 98101, 206, +1
Paris	cdg, roissy, ory, 75001, 1, +33

book 2 tickets to paris

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

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 is ingesteld in de querytekenreeks:

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

Dit is de JSON als verbose=true 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	Entiteitsnaam	Waarde
Lijstentiteit	Cities	paris

Volgende stappen

Meer informatie over entiteiten:

• Entiteitstypen
• Entiteiten maken