Habilidade cognitiva de Vinculação de Entidade (v3)

Note

Pesquisa de IA do Azure  está disponível por meio do portal Azure, APIs REST e SDKs do Azure. Ele também sustenta o IQ do Foundry, a camada de conhecimento gerenciado que transforma o conteúdo da empresa em bases de conhecimento reutilizáveis e com reconhecimento de permissão para agentes no portal do Microsoft Foundry.

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

Note

Essa habilidade está associada aos modelos de machine learning do Entity Linking no Azure Vision nas Ferramentas de Pesquisa. Ele requer um recurso faturável para transações que excedam 20 documentos por indexador por dia. A execução de habilidades internas é cobrada pelo preço padrão das Ferramentas de Fundiária existentes.

@odata.type

Microsoft.Skills.Text.V3.EntityLinkingSkill

Limites de dados

O tamanho máximo de um registro deve ser de 50.000 caracteres conforme medido por String.Length. Caso precise dividir seus dados antes de enviá-los para a habilidade EntityLinking, considere o uso da habilidade de 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.

Parâmetros de habilidade

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

Nome do parâmetro Description
defaultLanguageCode Código de idioma do texto de entrada. Se o código de idioma padrão não for especificado, o inglês (en) será usado como o código de idioma padrão.
Consulte a Lista completa dos idiomas com suporte.
minimumPrecision Um valor entre 0 e 1. Se a pontuação de confiança (na entities saída) for menor que esse valor, a entidade não será retornada. O padrão é 0.
modelVersion (Opcional) Especifica a versão do modelo a ser usada ao chamar a vinculação de entidade. Ele usa como padrão o mais recente disponível quando não especificado. Recomendamos que você não especifique esse valor, a menos que seja necessário.

Entradas de competências

Nome do campo de entrada Description
languageCode Uma cadeia de caracteres que indica o idioma dos registros. Se esse parâmetro não for especificado, o código de idioma padrão será usado para analisar os registros.
Consulte a Lista completa dos idiomas com suporte.
text O texto para analisar.

Resultados de competências

Nome do resultado Description
entities Uma matriz de tipos complexos que contêm os seguintes campos:
  • "name" (O nome real da entidade como é exibido no texto)
  • "id"
  • "language" (O idioma do texto, conforme determinado pela habilidade)
  • "url" (A URL vinculada a essa entidade)
  • "bingId" (A bingId para essa entidade vinculada)
  • "dataSource" (A fonte de dados associada à URL)
  • "matches" (Uma matriz de tipos complexos que contém: text, offset, length e confidenceScore)

Definição de exemplo

  {
    "@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 exemplo

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

Saída de exemplo

{
  "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 retornados para entidades na saída dessa habilidade são retornados diretamente das APIs do Serviço de Idioma, o que significa que, se você estiver usando-as para indexar na cadeia de caracteres original, você deverá usar a classe StringInfo no .NET para extrair o conteúdo correto. Para saber mais, confira Suporte multilíngue e para emoji nos recursos do Serviço de Linguagem.

Casos de aviso

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

Consulte também

  • Última atualização em