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 2024-11-01. 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 de las versiones 2022-05-01 y 2023-04-01 a la versión 2024-11-01 de API
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í.
Asignación de entidades de API de las versiones 2022-05-01 y 2023-04-01 a la versión actual
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 en las versiones 2022-05-01 y 2023-04-01 y la API de la versión actual.
| 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 |
| Correo electrónico | |
| URL | Resolución |
| Habilidad | Habilidad |
| Evento | Evento |
| CulturalEvent | Event, CulturalEvent |
| SportsEvent | Event, SportsEvent |
| NaturalEvent | Event, NaturalEvent |