Aptitud cognitiva para la vinculación de entidad (v3)

Note

Búsqueda de Azure AI está disponible a través del portal de Azure, las API REST y los SDK de Azure. También respalda Foundry IQ, la capa de conocimiento administrada que transforma el contenido empresarial en bases de conocimiento reutilizables y compatibles con permisos para agentes en el portal de Microsoft Foundry.

La aptitud Vinculación de entidad devuelve una lista de entidades reconocidas con vínculos a artículos de una base de conocimientos popular (Wikipedia).

Note

Esta aptitud está enlazada a los modelos de Aprendizaje automático de vinculación de entidades en Azure Vision en Foundry Tools. Requiere un recurso facturable para transacciones que superen los 20 documentos por indexador al día. La ejecución de aptitudes integradas se cobra por el precio estándar de Las herramientas de foundry existentes.

@odata.type

Microsoft.Skills.Text.V3.EntityLinkingSkill

Límites de datos

El tamaño máximo de un registro debe tener menos de 50 000 caracteres según la medición de String.Length. Si necesita desglosar los datos antes de enviarlos a la aptitud EntityLinking, puede usar la aptitud División de texto. Si usa una aptitud de división de texto, establezca la longitud de la página en 5000 para obtener el mejor rendimiento.

Parámetros de aptitud

Los nombres de los parámetros distinguen mayúsculas de minúsculas y son opcionales.

Nombre del parámetro Description
defaultLanguageCode Código de idioma del texto de entrada. Si no se especifica el código de idioma predeterminado, el inglés (en) se usa como código de idioma predeterminado.
Vea Full list of supported languages (Lista completa de idiomas admitidos).
minimumPrecision Un valor entre 0 y 1. Si la puntuación de confianza (en la entities salida) es inferior a este valor, no se devuelve la entidad. El valor predeterminado es 0.
modelVersion (Opcional) Especifica la versión del modelo que se va a usar al llamar a la vinculación de entidad. El valor predeterminado es el más reciente disponible cuando no se especifica. Se recomienda no especificar este valor a menos que sea necesario.

Entradas de habilidades

Nombre de entrada Description
languageCode Cadena que indica el idioma de los registros. Si no se especifica este parámetro, el código de idioma predeterminado se usa para analizar los registros.
Vea Full list of supported languages (Lista completa de idiomas admitidos).
text Texto que se analizará.

Resultados de habilidades

Nombre de salida Description
entities Una matriz de tipos complejos, que contiene los siguientes campos:
  • "name" (nombre de la entidad real tal como aparece en el texto)
  • "id"
  • "language" (idioma del texto según lo establecido por la aptitud)
  • "url" (la dirección URL vinculada a esta entidad)
  • "bingId" (bingId para esta entidad vinculada)
  • "dataSource" (el origen de datos asociado a la dirección URL)
  • "matches" (matriz de tipos complejos que contiene: text, offset, length y confidenceScore)

Definición de ejemplo

  {
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityLinkingSkill",
    "context": "/document",
    "defaultLanguageCode": "en", 
    "minimumPrecision": 0.5, 
    "inputs": [
        {
            "name": "text", 
            "source": "/document/content"
        },
        {
            "name": "languageCode", 
            "source": "/document/language"
        }
    ],
    "outputs": [
        {
            "name": "entities", 
            "targetName": "entities" 
        }
    ]
}

Entrada de ejemplo

{
    "values": [
      {
        "recordId": "1",
        "data":
           {
             "text": "Microsoft is liked by many.",
             "languageCode": "en"
           }
      }
    ]
}

Salida de ejemplo

{
  "values": [
    {
      "recordId": "1",
      "data" : 
      {
        "entities": [
          {
            "name": "Microsoft", 
            "id": "Microsoft",
            "language": "en", 
            "url": "https://en.wikipedia.org/wiki/Microsoft", 
            "bingId": "a093e9b9-90f5-a3d5-c4b8-5855e1b01f85", 
            "dataSource": "Wikipedia", 
            "matches": [
                {
                    "text": "Microsoft", 
                    "offset": 0, 
                    "length": 9, 
                    "confidenceScore": 0.13 
                }
            ]
          }
        ],
      }
    }
  ]
}

Los desplazamientos devueltos para las entidades de la salida de esta aptitud se devuelven directamente desde las API de Language Service, lo que significa que si los usa para indexar en la cadena original, debe usar la clase StringInfo en .NET para extraer el contenido correcto. Para obtener más información, vea Compatibilidad con varios idiomas y con emojis en características de Language Service.

Casos de advertencia

Si el código de idioma del documento no se admite, se devuelve una advertencia y no se extrae ninguna entidad.

Consulte también

  • Last updated on