Entità elenco

Importante

LUIS verrà ritirato il 1° ottobre 2025 e a partire dal 1° aprile 2023 non sarà possibile creare nuove risorse LUIS. È consigliabile eseguire la migrazione delle applicazioni LUIS alla comprensione del linguaggio conversazionale per trarre vantaggio dal supporto del prodotto continuo e dalle funzionalità multilingue.

Le entità elenco rappresentano un set chiuso e fisso di parole correlate insieme ai relativi sinonimi. LUIS non individua valori aggiuntivi per le entità elenco. Usare la funzione consigliata per visualizzare i suggerimenti per le nuove parole in base all'elenco corrente. Se sono presenti più entità elenco con lo stesso valore, ogni entità viene restituita nella query endpoint.

Un'entità list non è appresa in modo automatico. Si tratta di una corrispondenza di testo esatta. LUIS contrassegna eventuali corrispondenze a un elemento in qualsiasi elenco come un'entità nella risposta.

Questa entità è idonea quando i dati di testo:

• Sono un set noto.
• Non cambia spesso. Se è necessario modificare l'elenco spesso o si vuole che l'elenco si espande automaticamente, un'entità semplice incrementata con un elenco di frasi è una scelta migliore.
• Il set non supera i limiti massimi di LUIS per questo tipo di entità.
• Il testo nell'espressione è una corrispondenza senza distinzione tra maiuscole e minuscole con un sinonimo o il nome canonico. LUIS non usa l'elenco oltre la corrispondenza. Le corrispondenze fuzzy, stemming, plurali e altre varianti non vengono risolte con un'entità elenco. Per gestire le variazioni, è consigliabile usare un criterio con la sintassi del testo facoltativo.

Esempio di .json da importare nell'entità elenco

È possibile importare valori in un'entità elenco esistente usando il formato .json seguente:

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

Risposta JSON di esempio

Si supponga che l'app disponga di un elenco, di nome Cities, consentendo variazioni di nomi di città, tra cui città dell'aeroporto (Sea-tac), codice dell'aeroporto (SEA), codice postale (98101) e prefisso telefonico (206).

Elemento elenco	Sinonimi elenco
Seattle	sea-tac, sea, 98101, 206, +1
Paris	cdg, roissy, ory, 75001, 1, +33

book 2 tickets to paris

Nell'espressione precedente la parola paris viene mappata all'elemento parigi come parte dell'entità elenco Cities. L'entità elenco corrisponde al nome normalizzato dell'elemento e ai sinonimi dell'elemento.

Risposta dell'endpoint di previsione V2

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

Risposta dell'endpoint di previsione V3

Questo è il codice JSON se verbose=false è impostato nella stringa di query:

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

Questo è il codice JSON se verbose=true è impostato nella stringa di query:

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

Oggetto dati	Nome dell'entità	Valore
Entità elenco	Cities	paris

Passaggi successivi

Altre informazioni sulle entità:

• Tipi di entità
• Creare entità