Habilidade cognitiva de vinculação de entidade (v3)

A habilidade de vinculação de entidades (v3) retorna uma lista de entidades reconhecidas com links para artigos em uma base de conhecimento bem conhecida (Wikipedia).

Note

Esta competência está ligada aos modelos de aprendizagem automática Entity Linking no Azure Vision na Foundry Tools. Requer um recurso faturável para transações que excedam 20 documentos por indexador por dia. A execução das competências integradas é cobrada ao preço padrão existente da Foundry Tools.

@odata.type

Microsoft.Skills.Text.V3.EntityLinkingSkill

Data limits

O tamanho máximo de um registo deve ser de 50 000 carateres, medido por String.Length. Se você precisar dividir seus dados antes de enviá-los para a habilidade EntityLinking, considere usar a habilidade Divisão de texto. Se você usar uma habilidade de divisão de texto, defina o comprimento da página como 5000 para obter o melhor desempenho.

Skill parameters

Os nomes dos parâmetros diferenciam maiúsculas de minúsculas e são todos opcionais.

Parameter name Description
defaultLanguageCode Código linguístico do texto de entrada. Se o código da língua padrão não for especificado, o inglês (en) é usado como código da língua padrão.
Veja a lista completa de linguagens suportadas.
minimumPrecision Um valor entre 0 e 1. Se a pontuação de confiança (na entities saída) for inferior a esse valor, a entidade não é devolvida. A predefinição é 0.
modelVersion (Opcional) Especifica a versão do modelo a ser usada ao chamar a vinculação de entidade. Por defeito, a versão mais recente disponível quando não está especificada. Recomendamos que não especifique este valor a menos que seja necessário.

Skill inputs

Input name Description
languageCode Uma cadeia de caracteres que indica o idioma dos registros. Se este parâmetro não for especificado, o código padrão da linguagem é usado para analisar os registos.
Veja a lista completa de linguagens suportadas.
text O texto a analisar.

Skill outputs

Output name Description
entities Uma matriz de tipos complexos que contém os seguintes campos:
  • "name" (O nome real da entidade tal como aparece no texto)
  • "id"
  • "language" (A língua do texto determinada pela habilidade)
  • "url" (O url vinculado a esta entidade)
  • "bingId" (O bingId para esta entidade vinculada)
  • "dataSource" (A fonte de dados associada ao url)
  • "matches"(Uma matriz de tipos complexos que contém: text, offsetlength , e confidenceScore)

Sample definition

  {
    "@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" 
        }
    ]
}

Sample input

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

Sample output

{
  "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 
                }
            ]
          }
        ],
      }
    }
  ]
}

Os deslocamentos devolvidos para entidades na saída desta competência são diretamente devolvidos pelas APIs do Serviço de Linguagem, o que significa que, se os estiver a usar para indexar na cadeia original, deve usar a classe StringInfo em .NET para extrair o conteúdo correto. Para obter mais informações, consulte Suporte multilíngue e a emojis em Recursos do serviço de idiomas.

Warning cases

Se o código de idioma do documento não for suportado, um aviso será retornado e nenhuma entidade será extraída.

See also

  • Last updated on