Habilidade cognitiva de Reconhecimento de Entidade Nomeada (v2)

A habilidade de Reconhecimento de Entidade Nomeada (v2) extrai entidades nomeadas de texto. Entidades disponíveis incluem os tipos person, location, e organization.

Important

Habilidade de reconhecimento de entidade nomeada (v2) (Microsoft.Skills.Text.NamedEntityRecognitionSkill) foi descontinuada e substituída por Microsoft.Skills.Text.V3.EntityRecognitionSkill. Siga as recomendações nas habilidades preteridas do Pesquisa de IA do Azure  para migrar para uma habilidade com suporte.

Note

À medida que você expande o escopo aumentando a frequência de processamento, adicionando mais documentos ou adicionando mais algoritmos de IA, será necessário anexar um recurso faturável do Microsoft Foundry. Os encargos são acumulados ao chamar APIs nas Ferramentas de Pesquisa e para extração de imagens como parte do estágio de quebra de documento no Pesquisa de IA do Azure . Não há encargos para extração de texto em documentos. A execução de habilidades internas é cobrada pelo preço padrão das Ferramentas de Fundiária existentes.

A extração de imagem é uma cobrança extra limitada pelo Pesquisa de IA do Azure , conforme descrito na página de preços. A extração de texto é gratuita.

@odata.type

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Data limits

O tamanho máximo de um registro deve ser de 50.000 caracteres conforme medido por String.Length. Se você precisar interromper o backup de seus dados antes de enviá-la para o extrator de frases-chave, considere o uso de habilidade de Texto Dividido. 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 parâmetros diferenciam maiúsculas de minúsculas.

Parameter name Description
categories Matriz de categorias que devem ser extraídas. Tipos possíveis de categoria: "Person", "Location", "Organization". Se nenhuma categoria for fornecida, todos os tipos são retornados.
defaultLanguageCode Código de idioma do texto de entrada. Há suporte para vários idiomas: de, en, es, fr, it
minimumPrecision Um número entre 0 e 1. Se a precisão for menor do que esse valor, a entidade não é retornada. O padrão é 0.

Skill inputs

Input name Description
languageCode Optional. O padrão é "en".
enviar SMS O texto para analisar.

Skill outputs

Output name Description
persons Uma matriz de cadeias de caracteres onde cada cadeia de caracteres representa o nome de uma pessoa.
locations Uma matriz de cadeias de caracteres onde cada cadeia de caracteres representa um local.
organizations Uma matriz de cadeias de caracteres onde cada cadeia de caracteres representa uma organização.
entities Uma matriz de tipos complexos. Cada tipo complexo inclui os seguintes campos:
  • categoria ("person", "organization", ou "location")
  • valor (nome de entidade real)
  • deslocamento (o local onde ele foi encontrado no texto)
  • confiança (um valor entre 0 e 1 que representa essa confiança de que o valor é uma entidade real)

Sample definition

  {
    "@odata.type": "#Microsoft.Skills.Text.NamedEntityRecognitionSkill",
    "categories": [ "Person", "Location", "Organization"],
    "defaultLanguageCode": "en",
    "inputs": [
      {
        "name": "text",
        "source": "/document/content"
      }
    ],
    "outputs": [
      {
        "name": "persons",
        "targetName": "people"
      }
    ]
  }

Sample input

{
    "values": [
      {
        "recordId": "1",
        "data":
           {
             "text": "This is the loan application for Joe Romero, a Microsoft employee who was born in Chile and who then moved to Australia… Ana Smith is provided as a reference.",
             "languageCode": "en"
           }
      }
    ]
}

Sample output

{
  "values": [
    {
      "recordId": "1",
      "data" : 
      {
        "persons": [ "Joe Romero", "Ana Smith"],
        "locations": ["Chile", "Australia"],
        "organizations":["Microsoft"],
        "entities":  
        [
          {
            "category":"person",
            "value": "Joe Romero",
            "offset": 33,
            "confidence": 0.87
          },
          {
            "category":"person",
            "value": "Ana Smith",
            "offset": 124,
            "confidence": 0.87
          },
          {
            "category":"location",
            "value": "Chile",
            "offset": 88,
            "confidence": 0.99
          },
          {
            "category":"location",
            "value": "Australia",
            "offset": 112,
            "confidence": 0.99
          },
          {
            "category":"organization",
            "value": "Microsoft",
            "offset": 54,
            "confidence": 0.99
          }
        ]
      }
    }
  ]
}

Warning cases

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

See also

  • Last updated on