Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La característica NER puede evaluar texto no estructurado y extraer entidades con nombre del texto en varias categorías predefinidas, por ejemplo: persona, ubicación, evento, producto y organización.
Opciones de desarrollo
Para usar el reconocimiento de entidades nombradas, debe enviar texto no estructurado para su análisis y administrar la salida de la API en su aplicación. El análisis se realiza tal cual, sin personalización adicional al modelo usado en los datos. Hay dos maneras de usar el reconocimiento de entidades con nombre:
| Opción de desarrollo | Descripción |
|---|---|
| Microsoft Foundry | Foundry es una plataforma basada en la web que permite usar el reconocimiento de entidades nombradas con ejemplos de texto utilizando sus propios datos al registrarse. Para obtener más información, consulte la documentación del sitio web de Foundry o Foundry. |
| API REST o biblioteca cliente (SDK de Azure) | Integre el reconocimiento de entidades con nombre en las aplicaciones mediante la API REST o la biblioteca cliente disponible en una variedad de lenguajes. Para obtener más información, consulte la guía de inicio rápido de reconocimiento de entidades con nombre. |
Determinación de cómo procesar los datos (opcional)
Idiomas de entrada
Al enviar texto de entrada que se va a procesar, puede especificar en qué idioma están escritos de entre los idiomas compatibles. Si no especifica un idioma, la extracción de frases clave tiene como valor predeterminado inglés. La API puede devolver desplazamientos en la respuesta para admitir diferentes codificaciones multilingües y emojis.
Envío de datos
El análisis se realiza tras la recepción de la solicitud. El uso de la característica NER de forma sincrónica no tiene estado. No se almacenan datos en la cuenta y los resultados se devuelven inmediatamente en la respuesta.
Cuando se usa esta característica de forma asincrónica, los resultados de la API están disponibles durante 24 horas desde el momento en que se ingiere la solicitud y se indica en la respuesta. Después de este período de tiempo, los resultados se purgan y ya no están disponibles para la recuperación.
La API intenta detectar las categorías de entidad definidas para el idioma de una entrada de texto determinada.
Obtención de los resultados de NER
Cuando obtiene los resultados de NER, puede transmitirlos a una aplicación, o bien guardar la salida en un archivo en el sistema local. La respuesta de la API incluye entidades reconocidas, lo que incluye sus categorías y subcategorías, y las puntuaciones de confianza.
Selección de las entidades que se van a devolver
La API intenta detectar los tipos y las etiquetas de entidad definidos para el idioma de una entrada de texto determinada. Los tipos de entidad y las etiquetas reemplazan las categorías y subcategorías que usaban los modelos más antiguos, pues permiten definir entidades con más flexibilidad. También puede especificar qué entidades se detectan y devuelven. Use los parámetros opcionales inclusionList y exclusionList con los tipos de entidad adecuados. En el siguiente ejemplo, solo se detectaría Location. Puede especificar uno o varios tipos de entidad que se van a devolver. Dados los tipos y la jerarquía de etiquetas introducidas para esta versión, tiene la flexibilidad de filtrar por diferentes niveles de granularidad de la manera siguiente:
Entrada:
Nota:
En este ejemplo, devuelve solo el tipo de entidad "Location".
{
"kind": "EntityRecognition",
"parameters":
{
"inclusionList" :
[
"Location"
]
},
"analysisInput":
{
"documents":
[
{
"id":"1",
"language": "en",
"text": "We went to Contoso foodplace located at downtown Seattle last week for a dinner party, and we adore the spot! They provide marvelous food and they have a great menu. The chief cook happens to be the owner (I think his name is John Doe) and he is super nice, coming out of the kitchen and greeted us all. We enjoyed very much dining in the place! The pasta I ordered was tender and juicy, and the place was impeccably clean. You can even pre-order from their online menu at www.contosofoodplace.com, call 112-555-0176 or send email to order@contosofoodplace.com! The only complaint I have is the food didn't come fast enough. Overall I highly recommend it!"
}
]
}
}
En los ejemplos anteriores se devolverían entidades que se encuentran en el tipo de entidad Location, como las entidades etiquetadas GPE, Structural y Geological como se describe en tipos de entidad y etiquetas. También podríamos filtrar aún más las entidades devueltas mediante una de las etiquetas de entidad para el tipo de entidad Location, como filtrar aquellas que solo tienen la etiqueta GPE:
"parameters":
{
"inclusionList" :
[
"GPE"
]
}
Este método devuelve todas las entidades Location que solo se encuentran bajo la etiqueta GPE y omite cualquier otra entidad que se incluya en el tipo de etiquetado Location con cualquier otra etiqueta de entidad, como las entidades Structural etiquetadas con Geological y Location. También podemos analizar aún más nuestros resultados mediante el exclusionList parámetro . Las entidades etiquetadas GPE se pueden etiquetar con City, State, CountryRegion y Continent. Por ejemplo, podríamos excluir las etiquetas Continent y CountryRegion para nuestro ejemplo:
"parameters":
{
"inclusionList" :
[
"GPE"
],
"exclusionList": :
[
"Continent",
"CountryRegion"
]
}
Estos parámetros nos permiten filtrar solo aquellos tipos de entidad que sean Location, ya que la etiqueta de entidad GPE incluida en el parámetro inclusionList se encuentra bajo el tipo Location. A continuación, filtramos solo por entidades geopolíticas y excluimos las entidades etiquetadas con Continent y CountryRegion.
Atributos de salida admitidos
Para proporcionar a los usuarios una mayor comprensión de los tipos de una entidad y mejorar la usabilidad, NER admite estos atributos en la salida:
| Nombre del atributo | Tipo | Definición |
|---|---|---|
type |
Cadena | El tipo más específico de entidad detectada. Por ejemplo, "Seattle" es un City, un GPE (entidad política geográfica) y un Location. La clasificación más granular para "Seattle" es City. El tipo es City para el texto "Seattle". |
tags |
Lista (etiquetas) | Lista de objetos de etiqueta que expresa la afinidad de la entidad detectada con una jerarquía o cualquier otra agrupación. Una etiqueta contiene dos campos: - name: un nombre único para la etiqueta.- confidenceScore: la puntuación de confianza asociada para una etiqueta que va de 0 a 1.Este tagName único se usa para filtrar en los parámetros inclusionList y exclusionList. |
metadata |
Objeto | Los metadatos son un objeto que contiene más datos sobre el tipo de entidad detectado. Cambia en función del campo metadataKind. |
Salida de ejemplo
Esta salida de ejemplo incluye un ejemplo de atributos de salida.
{
"kind": "EntityRecognitionResults",
"results": {
"documents": [
{
"id": "1",
"entities": [
{
"text": "Microsoft",
"category": "Organization",
"type": "Organization",
"offset": 0,
"length": 9,
"confidenceScore": 0.97,
"tags": [
{
"name": "Organization",
"confidenceScore": 0.97
}
]
},
{
"text": "One",
"category": "Quantity",
"type": "Number",
"subcategory": "Number",
"offset": 21,
"length": 3,
"confidenceScore": 0.9,
"tags": [
{
"name": "Number",
"confidenceScore": 0.8
},
{
"name": "Quantity",
"confidenceScore": 0.8
},
{
"name": "Numeric",
"confidenceScore": 0.8
}
],
"metadata": {
"metadataKind": "NumberMetadata",
"numberKind": "Integer",
"value": 1.0
}
}
],
"warnings": []
}
],
"errors": [],
"modelVersion": "2023-09-01"
}
}
Especificación del modelo de NER
De manera predeterminada, esta característica usará el modelo de IA disponible más reciente en el texto. También puede configurar las solicitudes de API para usar una versión del modelo específica.
Límites de servicio y datos
Para obtener información sobre el tamaño y el número de solicitudes que puede enviar por minuto y segundo, consulte el artículo sobre límites del servicio.