Entité de liste

Important

LUIS sera mis hors service le 1er octobre 2025 et à partir du 1er avril 2023, vous ne pourrez plus créer de nouvelles ressources LUIS. Nous vous recommandons de migrer vos applications LUIS vers la compréhension du langage courant pour tirer parti de la prise en charge continue des produits et des fonctionnalités multilingues.

Les entités de liste représentent un ensemble fixe, fermé de mots associés, ainsi que leurs synonymes. LUIS ne détecte pas les valeurs supplémentaires pour les entités de liste. Utilisez la fonctionnalité Recommander pour trouver des suggestions de nouveaux mots à partir de la liste actuelle. S’il existe plusieurs entités de liste avec la même valeur, chaque entité est retournée dans la requête du point de terminaison.

Une entité de liste n’est pas issue de l’apprentissage automatique. Il s’agit d’une correspondance de texte à l’exact. LUIS marque comme entité chaque correspondance avec un élément d’une liste dans la réponse.

L’entité convient bien lorsque les données de texte :

• Sont un ensemble connu.
• Ne changent pas souvent. Si vous avez besoin de modifier la liste souvent ou si vous souhaitez que la liste se développe automatiquement, une entité simple améliorée avec une liste d’expressions est un meilleur choix.
• L’ensemble ne dépasse pas les limites maximum de LUIS pour ce type d’entité.
• Le texte de l’énoncé est une correspondance insensible à la casse avec un synonyme ou le nom canonique. LUIS n’utilise pas la liste au-delà de la correspondance. Une simple entité de liste ne suffit pas pour résoudre la correspondance approximative, la recherche de radical, les pluriels et d’autres variantes. Pour gérer les variantes, envisagez d’utiliser un modèle avec la syntaxe de texte facultative.

Exemple de réponse .json à importer dans une entité de liste

Vous pouvez importer des valeurs dans une entité de liste existante en utilisant le format .json suivant :

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

Exemple de réponse JSON

Supposons que l’application comporte une liste nommée Cities, permettant des variations de noms de ville : ville aéroportuaire (Sea-tac), indicatif d’aéroport (SEA), code postal (98101) et indicatif téléphonique régional (206).

Élément de liste	Synonymes de l’élément
Seattle	sea-tac, sea, 98101, 206, +1
Paris	cdg, roissy, ory, 75001, 1, +33

book 2 tickets to paris

Dans l’énoncé précédent, le mot paris est mappé à l’élément paris au sein de l’entité de liste Cities. Celle-ci est mise en correspondance avec le nom normalisé de l’élément ainsi que ses synonymes.

Réponse de point de terminaison de prédiction V2

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

Réponse de point de terminaison de prédiction V3

Il s’agit du JSON si verbose=false est défini dans la chaîne de requête :

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

Il s’agit du JSON si verbose=true est défini dans la chaîne de requête :

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

Objet de données	Nom de l’entité	Valeur
Entité de liste	Cities	paris

Étapes suivantes

En savoir plus sur les entités :

• Types d’entités
• Créer des entités