Entidade de lista

Importante

O LUIS será descontinuado a 1 de outubro de 2025 e a partir de 1 de abril de 2023 não poderá criar novos recursos do LUIS. Recomendamos que migre as suas aplicações LUIS para a compreensão de linguagem de conversação para beneficiar do suporte contínuo do produto e das capacidades multilingues.

As entidades de lista representam um conjunto fixo e fechado de palavras relacionadas, juntamente com os seus sinónimos. O LUIS não detetou valores adicionais para entidades de lista. Utilize a funcionalidade Recomendar para ver sugestões de novas palavras com base na lista atual. Se existir mais do que uma entidade de lista com o mesmo valor, cada entidade é devolvida na consulta de ponto final.

Uma entidade de lista não é aprendida por computador. É uma correspondência de texto exata. O LUIS marca qualquer correspondência com um item em qualquer lista como uma entidade na resposta.

A entidade é adequada quando os dados de texto:

• São um conjunto conhecido.
• Não muda frequentemente. Se precisar de alterar a lista com frequência ou pretender que a lista se expanda, uma entidade simples impulsionada com uma lista de expressões é uma escolha melhor.
• O conjunto não excede os limites máximos do LUIS para este tipo de entidade.
• O texto na expressão é uma correspondência não sensível a maiúsculas e minúsculas com um sinónimo ou o nome canónico. O LUIS não utiliza a lista para além da correspondência. As correspondências difusas, as descrições, os plural e outras variações não são resolvidos com uma entidade de lista. Para gerir variações, considere utilizar um padrão com a sintaxe de texto opcional.

Exemplo de .json para importar para a entidade de lista

Pode importar valores para uma entidade de lista existente com o seguinte formato .json:

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

Resposta JSON de exemplo

Suponha que a aplicação tem uma lista, denominada Cities, que permite variações de nomes de cidades, incluindo cidade do aeroporto (Sea-tac), código do aeroporto (SEA), código postal (98101) e código da área do telefone (206).

Item de lista	Sinónimos de itens
Seattle	sea-tac, sea, 98101, 206, +1
Paris	cdg, roissy, ory, 75001, 1, +33

book 2 tickets to paris

Na expressão anterior, a palavra paris é mapeada para o item de paris como parte da Cities entidade de lista. A entidade de lista corresponde ao nome normalizado do item, bem como aos sinónimos do item.

Resposta do ponto final de predição V2

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

Resposta do ponto final de predição V3

Este é o JSON se verbose=false estiver definido na cadeia de consulta:

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

Este é o JSON se verbose=true estiver definido na cadeia de consulta:

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

Objeto de dados	Nome da entidade	Valor
Entidade de Lista	Cities	paris

Passos seguintes

Saiba mais sobre as entidades:

• Tipos de entidade
• Criar entidades