Cambios en la API en versión preliminar

Use este artículo para obtener información general sobre los nuevos cambios en la API a partir de la versión 2023-04-15-preview. Este cambio en la API introduce principalmente dos nuevos conceptos (entity types y entity tags) que reemplazan los campos category y subcategory en la API disponible con carácter general actual. Puede encontrar información general detallada de cada parámetro de API y las versiones de API admitidas a las que corresponden en la página [Parámetros de aptitud][../how-to/skill-parameters.md]

Tipos de entidad

Los tipos de entidad representan la granularidad más baja (o más fina) en la que se ha detectado la entidad y se puede considerar como la clase base que se ha detectado.

Etiquetas de entidad

Las etiquetas de entidad se usan para identificar aún más una entidad en la que el tipo de entidad etiqueta una entidad detectada y etiquetas adicionales para diferenciar la entidad identificada. La lista de etiquetas de entidad puede considerarse para incluir categorías, subcategorías, etc.

Cambios en la API disponible con carácter general a la API en versión preliminar

Los cambios presentan una mayor flexibilidad para el servicio de reconocimiento de las entidades con nombre, entre los que se incluyen:

Actualizaciones de la estructura de los formatos de entrada: • InclusionList • ExclusionList • Directiva de superposición

Actualizaciones del control de los formatos de salida:

  • Salidas de reconocimiento de entidades más pormenorizadas mediante la introducción de la lista de etiquetas donde una entidad se podría etiquetar con más de una etiqueta de entidad.
  • Entidades superpuestas en las que las entidades podrían reconocerse como más de un tipo de entidad y, si es así, esta entidad se devolvería dos veces. Si se reconoce que una entidad pertenece a dos etiquetas de entidad en el mismo tipo de entidad, ambas etiquetas de entidad se devuelven en la lista de etiquetas.
  • Para filtrar entidades mediante etiquetas de entidad, puede obtener más información sobre esto; para ello, vaya a este artículo.
  • Objetos de metadatos que contienen información adicional sobre la entidad, pero que actualmente solo actúan como contenedor para la característica de resolución de entidades existente. Puede obtener más información sobre esta nueva característica aquí.

Asignaciones de entidades de la API disponible con carácter general a la API en versión preliminar

Puede ver una comparación entre la estructura de las categorías o tipos de entidad en el artículo Categorías de entidad y tipos de entidad del Reconocimiento de entidades con nombre (NER) admitidos. A continuación se muestra una tabla que describe las asignaciones entre los resultados que cabría esperar ver desde la API disponible con carácter general y la API en versión preliminar.

Tipo Etiquetas
Fecha Temporal, Date
DateRange Temporal, DateRange
DateTime Temporal, DateTime
DateTimeRange Temporal, DateTimeRange
Duration Temporal, Duration
SetTemporal Temporal, SetTemporal
Time Temporal, Time
TimeRange Temporal, TimeRange
City GPE, Location, City
State GPE, Location, State
CountryRegion GPE, Location, CountryRegion
Continent GPE, Location, Continent
GPE Location, GPE
Location Location
Airport Structural, Location
Estructural Location, Structural
Geological Location, Geological
Age Numeric, Age
Moneda Numeric, Currency
Number Numeric, Number
PhoneNumber PhoneNumber
NumberRange Numeric, NumberRange
Porcentaje Numeric, Percentage
Ordinal Numeric, Ordinal
Temperatura Numeric, Dimension, Temperature
Velocidad Numeric, Dimension, Speed
Peso Numeric, Dimension, Weight
Alto Numeric, Dimension, Height
Length Numeric, Dimension, Length
Volumen Numeric, Dimension, Volume
Área Numeric, Dimension, Area
Información Numeric, Dimension, Information
Dirección Dirección
Person Person
PersonType PersonType
Organización Organización
Producto Producto
ComputingProduct Product, ComputingProduct
IP IP
Email Correo electrónico
URL Resolución
Habilidad Habilidad
Evento Evento
CulturalEvent Event, CulturalEvent
SportsEvent Event, SportsEvent
NaturalEvent Event, NaturalEvent