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.

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.

Resposta de ponto de extremidade de previsão V2

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

Resposta de ponto de extremidade de previsão V3

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

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

Esse é o JSON se verbose=true estiver definido na cadeia de caracteres 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

Próximas etapas

Saiba mais sobre entidades:

• Tipos de entidade
• Criar entidades