Extração de Frases-Chave habilidade cognitiva

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 de Extração de Frases-Chave avalia texto não estruturado e, para cada registro, retorna uma lista de frases-chave. Essa habilidade utiliza os modelos de aprendizado de máquina Frase-Chave fornecidos pela Azure Linguagem no Foundry Tools.

Essa capacidade é útil se você precisar identificar rapidamente os principais pontos de discussão no registro. Por exemplo, com o texto de entrada "A comida estava deliciosa e havia uma equipe maravilhosa", o serviço retorna "comida" e "equipe maravilhosa".

Note

Essa habilidade está vinculada ao Foundry Tools e requer um recurso faturável para transações que ultrapassem 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.KeyPhraseExtractionSkill

Limites de dados

O tamanho máximo de um registro deve ser de 50.000 caracteres, conforme medido por String.Length. Se você precisar dividir seus dados antes de enviá-los para o extrator de palavras-chave, considere usar a habilidade Text Split. Se você usar uma habilidade de divisão de texto, defina o comprimento da página para 5000 para o melhor desempenho.

Parâmetros de habilidade

Os parâmetros diferenciam maiúsculas de minúsculas.

Inputs Description
defaultLanguageCode (Opcional) O código da linguagem para aplicar a documentos que não especificam explicitamente a linguagem. Se o código padrão do idioma não for especificado, o inglês (en) é usado como código padrão do idioma.
Veja a lista completa de idiomas suportados.
maxKeyPhraseCount (Opcional) O número máximo de frases-chave a ser produzido.
modelVersion (Opcional) Especifica a versão do modelo a ser usada ao chamar a API de palavras-chave. Ele usa por padrão a versão mais recente disponível quando não especificada. Recomendamos que você não especifique esse valor a menos que seja necessário.

Entradas de competências

Entrada Description
text O texto a ser analisado.
languageCode Uma sequência indicando o idioma dos registros. Se esse parâmetro não for especificado, o código padrão da linguagem é usado para analisar os registros.
Veja a lista completa de idiomas suportados.

Resultados de competências

Saída Description
keyPhrases Uma lista de frases-chave extraídas do texto de entrada. As frases-chave são retornadas em ordem de importância.

Definição de exemplo

Considere um registro SQL que possui os seguintes campos:

{
    "content": "Glaciers are huge rivers of ice that ooze their way over land, powered by gravity and their own sheer weight. They accumulate ice from snowfall and lose it through melting. As global temperatures have risen, many of the world’s glaciers have already started to shrink and retreat. Continued warming could see many iconic landscapes – from the Canadian Rockies to the Mount Everest region of the Himalayas – lose almost all their glaciers by the end of the century.",
    "language": "en"
}

Então sua definição de habilidade pode ser assim:

 {
    "@odata.type": "#Microsoft.Skills.Text.KeyPhraseExtractionSkill",
    "inputs": [
      {
        "name": "text",
        "source": "/document/content"
      },
      {
        "name": "languageCode",
        "source": "/document/language" 
      }
    ],
    "outputs": [
      {
        "name": "keyPhrases",
        "targetName": "myKeyPhrases"
      }
    ]
  }

Saída de exemplo

No exemplo anterior, a saída da sua habilidade é escrita em um novo nó na árvore enriquecida chamada "document/myKeyPhrases", já que foi essa targetName que especificamos. Se você não especificar um targetName, então seria "documento/frases-chave".

document/myKeyPhrases

[
  "world’s glaciers", 
  "huge rivers of ice", 
  "Canadian Rockies", 
  "iconic landscapes",
  "Mount Everest region",
  "Continued warming"
]

Você pode usar "document/myKeyPhrases" como entrada em outras habilidades, ou como fonte de mapeamento de campo de saída.

Warnings

Se você fornecer um código de idioma não suportado, um aviso é gerado e as frases-chave não são extraídas. Se seu texto estiver vazio, um aviso é emitido. Se seu texto for maior que 50.000 caracteres, apenas os primeiros 50.000 caracteres são analisados e um aviso é emitido.

Consulte também

  • Última atualização em