Alterações da API em versão prévia
Use este artigo para obter uma visão geral das novas alterações da API a partir da versão 2024-11-01. Essa alteração da API apresenta principalmente dois novos conceitos (entity types e entity tags) substituindo os campos category e subcategory na API em disponibilidade geral. Uma visão geral detalhada de cada parâmetro de API e as versões de API com suporte às quais ele corresponde podem ser encontradas em [Parâmetros de Habilidade][Página ../how-to/skill-parameters.md]
Tipos de entidade
Os tipos de entidade representam a granularidade mais baixa (ou melhor) na qual a entidade foi detectada e podem ser considerada como a classe base que foi detectada.
Marcas da entidade
As marcas da entidade são usadas para identificar ainda mais uma entidade em que uma entidade detectada é marcada pelo tipo de entidade e marcas adicionais para diferenciar a entidade identificada. A lista de marcas da entidade pode ser considerada para incluir categorias, subcategorias, subsubcategorias e assim por diante.
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: • InclusionList • 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 marcas em que uma entidade pode ser marcada por mais de uma marca de entidade.
- Entidades sobrepostas em que as entidades poderiam ser reconhecidas como mais de um tipo de entidade e, nesse caso, essa entidade seria retornada duas vezes. Se uma entidade tiver sido reconhecida como pertencente a duas marcas da entidade no mesmo tipo de entidade, ambas as marcas da entidade serão retornadas na lista de marcas.
- Filtrar entidades usando as guias de entidade, saiba mais sobre isso navegando para este artigo.
- 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 da entidade existente. Saiba mais sobre esse 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 Categorias e tipos de entidade de Reconhecimento de Entidade Nomeada (NER) com suporte. Veja abaixo uma tabela que descreve os mapeamentos entre os resultados que você esperaria ver nas versões 2022-05-01 e 2023-04-01 e na API de versão atual.
| Tipo | Marcações |
|---|---|
| Data | Temporal, Date |
| DateRange | Temporal, DateRange |
| Datetime | Temporal, DateTime |
| DateTimeRange | Temporal, DateTimeRange |
| Duration | Temporal, Duration |
| SetTemporal | Temporal, SetTemporal |
| Hora | Temporal, Time |
| TimeRange | Temporal, TimeRange |
| City | GPE, Localização, Cidade |
| Estado | GPE, Location, State |
| CountryRegion | GPE, Location, CountryRegion |
| Continente | GPE, Location, Continent |
| GPE | Location, GPE |
| Localização | Localização |
| Airport | Structural, Location |
| Estrutural | Location, Structural |
| Geological | Location, Geological |
| Idade | Numeric, Age |
| Moeda | Numeric, Currency |
| Número | Numeric, Number |
| PhoneNumber | PhoneNumber |
| NumberRange | Numeric, NumberRange |
| Percentual | Numeric, Percentage |
| Ordinal | Numeric, Ordinal |
| Temperatura | Numeric, Dimension, Temperature |
| Velocidade | Numeric, Dimension, Speed |
| Peso | Numeric, Dimension, Weight |
| Altura | Numeric, Dimension, Height |
| Comprimento | Numeric, Dimension, Length |
| Volume | Numeric, Dimension, Volume |
| Área | Numeric, Dimension, Area |
| Informações | Numeric, Dimension, Information |
| Endereço | Endereço |
| Pessoa | Pessoa |
| PersonType | PersonType |
| Organização | Organização |
| Produto | Produto |
| ComputingProduct | Product, ComputingProduct |
| IP | IP |
| URL | URL |
| Habilidade | Habilidade |
| Evento | Evento |
| CulturalEvent | Event, CulturalEvent |
| SportsEvent | Event, SportsEvent |
| NaturalEvent | Event, NaturalEvent |