Marcas e tipos de entidade

Use este artigo para obter uma visão geral das novas alterações de API a partir da versão 2024-11-01. Essa alteração de API introduz principalmente dois novos conceitos (entity types e entity tags) que substituem os campos category e subcategory na API atual em Disponibilidade Geral. Uma visão geral detalhada de cada parâmetro de API e as versões de API com suporte correspondentes são encontradas em [Parâmetros de Habilidade][.. Página /how-to/skill-parameters.md].

Como uma entidade como "Seattle" pode ser classificada como uma Cidade, GPE (Entidade Política Geográfica) e um Local, o type atributo é usado para definir a classificação mais granular, nesse caso, City. O atributo tags na saída do serviço é uma lista de todas as classificações possíveis (Cidade, GPE e Localização) e as respectivas pontuações de confiança. Um mapeamento completo de possíveis tags para cada categoria está listado. Os metadata atributos na saída do serviço contêm informações adicionais sobre a entidade, como o valor inteiro associado à entidade.

Tipos de entidade

Os tipos de entidade representam a granularidade mais baixa (ou melhor) na qual a entidade é detectada. Os tipos são considerados a classe base detectada.

Marcas da entidade

Marcas de entidade são usadas para identificar ainda mais uma entidade em que uma entidade detectada é marcada para indicar o tipo de entidade. A lista de marcas da entidade pode incluir categorias, subcategorias e sub-subcategorias.

Alterações das versões 2022-05-01 e 2023-04-01 para a API 2024-11-01 de versão

As alterações apresentam melhor flexibilidade para o serviço de reconhecimento de entidade nomeada, incluindo:

Atualizações para a estrutura de formatos de entrada:

• Lista de Inclusão
• ExclusionList
• Política de sobreposição

Atualizações para o tratamento de formatos de saída:

• Saídas de reconhecimento de entidade mais granulares por meio da introdução da lista de rótulos em que uma entidade é marcada com mais de uma marca de entidade.
• Entidades sobrepostas em que as entidades podem ser reconhecidas como mais de um tipo de entidade e, se for o caso, essa entidade será retornada duas vezes. Se uma entidade foi reconhecida como pertencente a duas marcas de entidade do mesmo tipo de entidade, ambas as marcas de entidade serão retornadas na lista de rótulos.
• Filtrando entidades usando marcas de entidade: para saber mais, consulteSelecionar entidades retornadas.
• Objetos de metadados que contêm informações adicionais sobre a entidade, mas atualmente atuam apenas como um wrapper para o recurso de resolução de entidade existente. Você pode saber mais sobre este novo recurso aqui.

Versões 2022-05-01 e 2023-04-01 para mapeamentos de entidade de API de versão atual

Você pode ver uma comparação entre a estrutura das categorias/tipos de entidade no artigo de categorias de entidade e tipos de entidade com suporte no Reconhecimento de Entidade Nomeada (NER). A tabela a seguir apresenta os mapeamentos entre os resultados que você esperaria ver das versões 2022-05-01 e 2023-04-01 e a versão atual da API.