关键短语提取认知技能

关键短语提取技能可以计算非结构化的文本，并针对每个记录返回关键短语列表。 此技能使用 Azure AI 语言提供的关键短语机器学习模型。

如果你需要快速确定记录中的谈话要点，此功能十分有用。 例如，给定输入文本“The food was delicious and there were wonderful staff”，服务会返回“food”和“wonderful staff”。

@odata.type

Microsoft.Skills.Text.KeyPhraseExtractionSkill

数据限制

记录的最大大小应为 50,000 个字符，通过 String.Length 进行测量。 如果在将数据发送到关键短语提取器之前需要拆分数据，请使用文本拆分技能。 如果你使用文本拆分技能，请将页面长度设置为 5000 以获得最佳性能。

技能参数

参数区分大小写。

技能输入

技能输出

示例定义

考虑具有以下字段的 SQL 记录：

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

然后，技能定义可能会如下所示：

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

示例输出

对于前面的示例，技能输出将写入到扩充树中名为“document/myKeyPhrases”的新节点，因为这是我们指定的 targetName。 如果未指定 targetName，则为“document/keyPhrases”。

document/myKeyPhrases

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

可以使用“document/myKeyPhrases”作为其他技能的输入，或者将其作为输出字段映射的源。

警告

如果提供了不支持的语言代码，会生成警告且不提取关键短语。 如果文本为空，则生成警告。 如果文本大于 50,000 个字符，只会分析前 50,000 个字符，并会发出警告。

另请参阅

• 内置技能
• 如何定义技能集
• 如何定义输出字段映射