Lista entitet

Viktigt

LUIS dras tillbaka den 1 oktober 2025 och från och med 1 april 2023 kommer du inte att kunna skapa nya LUIS-resurser. Vi rekommenderar att du migrerar dina LUIS-program till förståelse för konversationsspråk för att dra nytta av fortsatt produktsupport och flerspråkiga funktioner.

Entiteter i listan representerar en fast, stängd uppsättning relaterade ord tillsammans med deras synonymer. LUIS identifierar inte ytterligare värden för listentiteter. Använd funktionen Rekommendera om du vill se förslag på nya ord baserat på den aktuella listan. Om det finns fler än en listentitet med samma värde returneras varje entitet i slutpunktsfrågan.

En listentitet är inte maskininlärd. Det är en exakt textmatchning. LUIS markerar alla matchningar till ett objekt i en lista som en entitet i svaret.

Entiteten passar bra när textdata:

• Är en känd uppsättning.
• Ändras inte ofta. Om du behöver ändra listan ofta eller vill att listan ska expanderas själv är en enkel entitet som utökas med en fraslista ett bättre alternativ.
• Uppsättningen inte överskrider de högsta gränserna för LUIS för den här entitetstypen.
• Texten i yttrandet är en skiftlägesokänslig matchning med en synonym eller det kanoniska namnet. LUIS använder inte listan efter matchningen. Fuzzy-matchning, ordstamsigenkänning, plural och andra varianter matchas inte med en listentitet. Om du vill hantera variationer bör du överväga att använda ett mönster med valfri textsyntax.

Exempel på .json för import till listentitet

Du kan importera värden till en befintlig listentitet med hjälp av följande .json-format:

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

Exempel på JSON-svar

Anta att appen har en lista med namnet Cities, som tillåter variationer av stadsnamn, inklusive flygplats (Sea-tac), flygplatskod (SEA), postnummer (98101) och telefonområdeskod (206).

Listobjekt	Objektsynonymer
Seattle	sea-tac, sea, 98101, 206, +1
Paris	cdg, roissy, ory, 75001, 1, +33

book 2 tickets to paris

I föregående yttrande mappas ordet paris till objektet paris som en del av listentiteten Cities . Listentiteten matchar både objektets normaliserade namn och objektsynonymerna.

Svar på V2-förutsägelseslutpunkt

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

Svar på V3-förutsägelseslutpunkt

Detta är JSON om verbose=false anges i frågesträngen:

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

Detta är JSON om verbose=true anges i frågesträngen:

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

Dataobjekt	Entitetsnamn	Värde
Lista entitet	Cities	paris

Nästa steg

Läs mer om entiteter:

• Entitetstyper
• Skapa entiteter