Entidade de lista

Importante

O LUIS será desativado em 1º de outubro de 2025 e, a partir de 1º de abril de 2023, você não poderá criar novos recursos do LUIS. É recomendável migrar seus aplicativos LUIS para a compreensão da linguagem coloquial a fim de usufruir do suporte contínuo ao produto e dos recursos multilíngues.

As entidades de lista representam um conjunto fixo e fechado de palavras relacionadas, juntamente com seus sinônimos. O LUIS não descobre valores adicionais para entidades de lista. Use o recurso Recomendado para consultar sugestões de novas palavras com base na lista atual. Se houver mais de uma entidade de lista com o mesmo valor, cada entidade será retornada na consulta de ponto de extremidade.

Uma entidade lista não é de aprendizado de máquina. É uma correspondência exata do texto. O LUIS marca qualquer correspondência a um item em qualquer lista como uma entidade na resposta.

A entidade é uma boa opção quando os dados de texto:

  • São um conjunto conhecido.
  • Não é alterado com frequência. Se você precisar alterar a lista com frequência ou desejar que a lista se expanda automaticamente, a melhor opção será usar uma entidade simples aumentada com uma lista de frases.
  • O conjunto não excede os limites máximos do LUIS para esse tipo de entidade.
  • O texto no enunciado é uma correspondência que não diferencia maiúsculas de minúsculas com um sinônimo ou o nome canônico. O LUIS não usa a lista além da correspondência. Correspondência difusa, lematização, plurais e outras variações não são resolvidas com uma entidade de lista. Para gerenciar variações, considere usar um padrão com a sintaxe de texto opcional.

entidade de lista

Exemplo .json para importar para a entidade de lista

Você pode importar valores para uma entidade de lista usando o seguinte formato .json:

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

Resposta JSON de exemplo

Suponha que o aplicativo tem uma lista, chamada Cities, que permite variações de nomes de cidade que incluem a cidade do aeroporto (SEA), o código do aeroporto (SEA), o CEP (98101) e o código da área de telefone (206).

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

book 2 tickets to paris

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

  "entities": [
    {
      "entity": "paris",
      "type": "Cities",
      "startIndex": 18,
      "endIndex": 22,
      "resolution": {
        "values": [
          "Paris"
        ]
      }
    }
  ]
Objeto de dados Nome da entidade Valor
Entidade de lista Cities paris

Próximas etapas

Saiba mais sobre entidades: