Extração de Frases-Chave Competência cognitiva

Note

O Pesquisa de IA do Azure está disponível através do portal Azure, APIs REST e SDKs do Azure. Também sustenta o Foundry IQ, a camada de conhecimento gerida que transforma conteúdos empresariais em bases de conhecimento reutilizáveis e conscientes de permissões para agentes no portal Microsoft Foundry.

A competência Extração de Frases-Chave avalia texto não estruturado e, para cada registo, devolve uma lista de frases-chave. Esta competência utiliza os modelos de aprendizagem automática Frase fornecidos pela Azure Language in Foundry Tools.

Esta capacidade é útil se precisar de identificar rapidamente os principais pontos de discussão no registo. Por exemplo, dado o texto de entrada "A comida estava deliciosa e havia funcionários maravilhosos", o serviço devolve "comida" e "equipa maravilhosa".

Note

Esta competência 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 das competências integradas é cobrada ao preço padrão existente da Foundry Tools.

@odata.type

Microsoft.Skills.Text.KeyPhraseExtractionSkill

Limites de dados

O tamanho máximo de um registo deve ser de 50.000 caracteres, medido por String.Length. Se precisar de fragmentar os seus dados antes de os enviar para o extrator de palavras-chave, considere usar a competência Text Split. Se usares uma competência de divisão de texto, define o comprimento da página para 5000 para o melhor desempenho.

Parâmetros de habilidade

Os parâmetros são distinguíveis de maiúsculas minúsculas.

Inputs Description
defaultLanguageCode (Opcional) O código da linguagem aplica-se a documentos que não especificam explicitamente a língua. 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.
Consulte a lista completa de línguas suportadas.
maxKeyPhraseCount (Opcional) O número máximo de palavras-chave a produzir.
modelVersion (Opcional) Especifica a versão do modelo a usar ao chamar a API da frase-chave. 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.

Entradas de habilidades

Entrada Description
text O texto a analisar.
languageCode Uma sequência que indica a língua dos registos. Se este parâmetro não for especificado, o código padrão da linguagem é usado para analisar os registos.
Consulte a lista completa de línguas suportadas.

Resultados em termos de competências

Output Description
keyPhrases Uma lista de frases-chave extraídas do texto de entrada. As frases-chave são devolvidas por ordem de importância.

Definição da amostra

Considere um registo SQL que tem 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 a tua definição de competência pode ser esta:

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

Saída da amostra

No exemplo anterior, a saída da tua competência é escrita num novo nó na árvore enriquecida chamada "document/myKeyPhrases", já que foi essa targetName que especificámos. Se não especificares um targetName, então seria "document/frases-chave".

documento/myKeyPhrases

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

Podes usar "document/myKeyPhrases" como entrada para outras competências, ou como fonte de mapeamento de campos de saída.

Warnings

Se fornecer um código linguístico não suportado, é gerado um aviso e as frases-chave não são extraídas. Se o seu texto estiver vazio, é emitido um aviso. Se o seu texto for superior a 50.000 caracteres, apenas os primeiros 50.000 caracteres são analisados e é emitido um aviso.

Consulte também