Adicionar entidades para extrair dados

Crie entidades para extrair dados-chave de enunciados do usuário em aplicativos do LUIS (Reconhecimento vocal). Os dados de entidade extraídos são usados pelo aplicativo cliente para atender às solicitações de clientes.

A entidade representa uma palavra ou frase dentro da declaração que você deseja que seja extraída. As entidades descrevem informações relevantes para a intenção e, às vezes, elas são essenciais para seu aplicativo realizar sua tarefa. Você pode criar entidades ao adicionar um exemplo de enunciado a uma intenção ou além de adicionar (antes ou depois) um exemplo de enunciado a uma intenção.

Planejar, criar e rotular entidades

As entidades de machine learning podem ser criadas com base nos exemplos de enunciados ou por meio da página Entidades.

Em geral, uma melhor prática é gastar tempo planejando as entidades antes de criar uma entidade de machine learning no portal. Em seguida, crie a entidade de machine learning com base no exemplo de enunciado com o máximo de detalhes nas subentidades e nos recursos que você conhece no momento. O tutorial sobre entidades divisíveis demonstra como usar esse método.

Como parte do planejamento das entidades, você pode saber se precisa de entidades de correspondência de texto (como entidades predefinidas, entidades de expressão regular ou entidades de lista). Você pode criá-las por meio da página Entidades antes que elas sejam rotuladas nos exemplos de enunciados.

Durante a rotulagem, você pode rotular entidades individuais e criar uma entidade pai de machine learning. Ou, então, você pode começar com uma entidade pai de machine learning e decompô-la em entidades filho.

Dica

Rotule todas as palavras que possam indicar uma entidade, mesmo se as palavras não forem usadas quando extraídas no aplicativo cliente.

Quando criar uma entidade

Depois de planejar as entidades, você deverá criar as entidades de machine learning e as subentidades. Isso pode exigir a adição de entidades predefinidas ou entidades de correspondência de texto para fornecer recursos para as entidades de machine learning. Tudo isso deve ser feito antes da rotulagem.

Depois de começar a rotular os exemplos de enunciados, você poderá criar entidades com machine learning ou estender as entidades de lista.

Use a tabela a seguir para entender em que local cada tipo de entidade deve ser criada ou adicionada ao aplicativo.

Tipo de entidade Em que local a entidade deve ser criada no portal do LUIS
Entidade de machine learning Detalhes de entidades ou intenções
Entidade de lista Detalhes de entidades ou intenções
Entidade de expressão regular Entidades
Entidade pattern.any Entidades
Entidade predefinida Entidades
Entidade de domínio predefinido Entidades

Crie todas as entidades na página Entidades ou duas entidades como parte da rotulagem da entidade no exemplo de enunciado na página Detalhes da intenção. Você só pode rotular uma entidade em um exemplo de enunciado na página Detalhes da intenção.

Como criar uma entidade personalizada

Esse processo funciona para entidades com machine learning, entidades de lista e entidades de expressão regular.

  1. Entre no portal do LUIS selecione sua Assinatura e Recurso de criação para ver os aplicativos atribuídos a esse recurso.
  2. Abra seu aplicativo selecionando seu nome na página Meus Aplicativos.
  3. Selecione a página Entidades.
  4. Escolha + Criar e selecione o tipo de entidade.
  5. Continue configurando a entidade e selecione Criar quando terminar.

Criar uma entidade com machine learning

  1. Entre no portal do LUIS selecione sua Assinatura e Recurso de criação para ver os aplicativos atribuídos a esse recurso.

  2. Abra seu aplicativo selecionando seu nome na página Meus Aplicativos.

  3. Na seção Criar, selecione Entidades no painel esquerdo e escolha + Criar.

  4. Na caixa de diálogo Criar um tipo de entidade, insira o nome da entidade e selecione Com machine learning. Para adicionar subentidades, selecione Adicionar estrutura. Selecione Criar.

    Captura de tela da criação de uma entidade com machine learning.

  5. Em Adicionar subentidades, adicione uma subentidade selecionando o + na linha da entidade pai.

    Captura de tela da adição de subentidades.

  6. Selecione Criar para concluir o processo de criação.

Adicionar um recurso a uma entidade com machine learning

  1. Entre no portal do LUIS selecione sua Assinatura e Recurso de criação para ver os aplicativos atribuídos a esse recurso.

  2. Abra seu aplicativo selecionando seu nome na página Meus Aplicativos.

  3. Na seção Criar, selecione Entidades no painel esquerdo e escolha a entidade com machine learning.

  4. Adicione um recurso selecionando + Adicionar recurso na linha da entidade ou da subentidade.

  5. Selecione uma nas listas de frases e entidades existentes.

  6. Se a entidade só precisar ser extraída se o recurso for encontrado, selecione o asterisco, *, nesse recurso.

    Captura de tela da adição de recurso a uma entidade.

Criar uma entidade de expressão regular

  1. Entre no portal do LUIS selecione sua Assinatura e Recurso de criação para ver os aplicativos atribuídos a esse recurso.

  2. Abra seu aplicativo selecionando seu nome na página Meus Aplicativos.

  3. Na seção Criar, selecione Entidades no painel esquerdo e escolha + Criar.

  4. Na caixa de diálogo Criar um tipo de entidade, insira o nome da entidade e selecione RegEx, insira a expressão regular no campo Regex e escolha Criar.

    Captura de tela da criação da entidade de expressão regular.

Criar uma entidade de listas

As entidades da lista representam um conjunto fixo e fechado de palavras relacionadas. Embora você, como autor, possa alterar a lista, o LUIS não aumentará nem reduzirá a lista. Você também pode importá-la para uma entidade de lista existente usando um formato .json da entidade de lista.

A lista a seguir demonstra o nome canônico e os sinônimos.

Cor: nome do item de lista Cor: sinônimos
Vermelho Carmim, sangue, maçã, caminhão de bombeiros
Azul céu, cobalto
Verde esmeralda, limão

Use o procedimento para criar uma entidade de lista. Depois que a entidade de lista for criada, você não precisará rotular exemplos de enunciados em uma intenção. É feita a correspondência de itens de lista e sinônimos por meio do texto exato.

  1. Entre no portal do LUIS selecione sua Assinatura e Recurso de criação para ver os aplicativos atribuídos a esse recurso.

  2. Abra seu aplicativo selecionando seu nome na página Meus Aplicativos.

  3. Na seção Criar, selecione Entidades no painel esquerdo e escolha + Criar.

  4. Na caixa de diálogo Criar um tipo de entidade, insira o nome da entidade, como Colors e selecione Lista.

  5. Na caixa de diálogo Criar uma entidade de lista, em Adicionar nova sublista… , insira o nome do item de lista, como Green e adicione sinônimos.

    Criar uma lista de cores como uma entidade de lista na página Detalhes da entidade.

  6. Quando terminar de adicionar itens de lista e sinônimos, selecione Criar.

    Quando concluir um grupo de alterações no aplicativo, lembre-se de Treinar o aplicativo. Não treine o aplicativo após uma alteração individual.

    Observação

    Este procedimento demonstra como criar e rotular uma entidade de lista com base em um exemplo de enunciado na página Detalhes da intenção. Você também pode criar a mesma entidade na página Entidades.

Adicionar uma função para uma entidade

Uma função é um subtipo nomeado de uma entidade com base no contexto.

Adicionar uma função para distinguir contextos

No seguinte enunciado, há duas localizações, e cada uma é especificada semanticamente pelas palavras próximas a ela, como to e from:

Pick up the package from Seattle and deliver to New York City.

Neste procedimento, adicione as funções origin e destination a uma entidade geographyV2 predefinida.

  1. Entre no portal do LUIS selecione sua Assinatura e Recurso de criação para ver os aplicativos atribuídos a esse recurso.

  2. Abra seu aplicativo selecionando seu nome na página Meus Aplicativos.

  3. Na seção Build, selecione Entities no painel esquerdo.

  4. Selecione + Adicionar entidade predefinida. Escolha geographyV2 e selecione Concluído. Isso adicionará uma entidade predefinida ao aplicativo.

    Se você achar que seu padrão, quando ele incluir um Pattern.any, extrai as entidades incorretamente, use uma lista explícita para corrigir esse problema.

  5. Selecione a entidade geographyV2 predefinida recém-adicionada na lista de entidades da página Entidades.

  6. Para adicionar uma nova função, selecione + ao lado de Nenhuma função adicionada.

  7. Na caixa de texto Digite a função… , insira o nome da função Origin e pressione ENTER. Adicione o segundo nome de função Destination e pressione ENTER.

    Captura de tela da adição da função Origem à entidade Local

    A função será adicionada à entidade predefinida, mas não será adicionada a nenhum enunciado que use essa entidade.

Texto do rótulo com uma função em um exemplo de enunciado

Dica

As funções podem ser substituídas por rótulos com subentidades das entidades de machine learning.

  1. Entre no portal do LUIS selecione sua Assinatura e Recurso de criação para ver os aplicativos atribuídos a esse recurso.

  2. Abra seu aplicativo selecionando seu nome na página Meus Aplicativos.

  3. Acesse a página Detalhes da intenção, que traz exemplos de enunciados que usam a função.

  4. Para rotulagem com a função, selecione o rótulo da entidade (linha sólida abaixo do texto) no exemplo de enunciado e selecione Exibir no painel da entidade na lista suspensa.

    Captura de tela que mostra o item de menu Exibir no painel da entidade selecionado.

    A paleta de entidades será aberta à direita.

  5. Selecione a entidade e vá para a parte inferior da paleta e escolha a função.

    Captura de tela que mostra o local de seleção da função.

Criar uma entidade pattern.any

A entidade Pattern.any só está disponível com padrões.

Não altere o tipo de entidade

O LUIS não permite alterar o tipo da entidade porque não sabe o que adicionar ou remover para construir essa entidade. Para alterar o tipo, é melhor criar uma nova entidade do tipo correto com um nome ligeiramente diferente. Depois que a entidade é criada, em cada enunciado, remova o antigo nome da entidade rotulada e adicione o novo nome da entidade. Depois que todos os enunciados tiverem sido remarcados, exclua a entidade antiga.

Próximas etapas

Saiba mais sobre: