Tipos de entidad y etiquetas

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. Encontrará información general detallada de cada parámetro de API y las versiones de API admitidas correspondientes en [Parámetros de aptitud][.. Página /how-to/skill-parameters.md].

Dado que una entidad como "Seattle" podría clasificarse como ciudad, GPE (entidad política geográfica) y una ubicación, el type atributo se usa para definir la clasificación más granular, en este caso City. El atributo tags de la salida del servicio es una lista de todas las clasificaciones posibles (Ciudad, GPE y Ubicación) y su puntuación de confianza respectiva. Se muestra un mapeo completo de posibles etiquetas para cada uno. Los metadata atributos de la salida del servicio contienen información adicional sobre la entidad, como el valor entero asociado a la entidad.

Tipos de entidades

Los tipos de entidad representan la granularidad más baja (o más fina) en la que se detecta la entidad. Los tipos se consideran la clase base detectada.

Etiquetas de entidad

Las etiquetas de entidad se usan para identificar aún más una entidad donde se etiqueta una entidad detectada para indicar el tipo de entidad. La lista de etiquetas de entidad puede incluir categorías, subcategorías y sub subcategorías.

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 formatos de entrada:

• Lista de Inclusión
• ExclusionList
• Directiva de superposición

Actualizaciones del control de los formatos de salida:

• El reconocimiento de entidades más granular se genera mediante la implementación de una lista de etiquetas donde se etiqueta una entidad 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.
• Filtrado de entidades mediante etiquetas de entidad: para obtener más información, consulteSelección de entidades devueltas.
• Objetos de metadatos que contienen información adicional sobre la entidad, pero 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. En la tabla siguiente se presentan las asignaciones entre los resultados que se esperaría ver de las versiones 2022-05-01 y 2023-04-01 y la API de la versión actual.