你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

关键短语：提取认知技能

注释

Azure AI 搜索可通过Azure门户、REST API 和Azure SDK获取。 它还支持 Foundry IQ，该知识层将企业内容转换为 Microsoft Foundry 门户中代理的可重用权限感知知识库。

关键 词提取 技能评估非结构化文本，并为每个记录返回关键词列表。 该技能使用了由 Foundry Tools 中的 Azure语言提供的关键短语机器学习模型。

如果你需要快速识别记录中的主要论点，这项功能非常有用。 例如，输入文字“食物美味，工作人员非常出色”，服务返回“食物”和“优秀员工”。

注释

这项技能依赖于 Foundry Tools，并且需要 一个可计费的资源 来处理每个索引器每天超过 20 份文档的交易。 执行内置技能按现有的 Foundry 工具标准价格收费。

@odata.type

Microsoft.Skills.Text.KeyPhraseExtractionSkill

数据限制

记录的最大大小应为50,000字符，按 。String.Length 如果你需要在发送数据到关键词提取器前拆分数据，可以考虑使用 文本分割技能。 如果你用了文本分割技能，把页面长度设为5000，这样表现最好。

技能参数

参数区分大小写。

输入 Description
defaultLanguageCode （可选）语言代码适用于那些没有明确说明语言的文档。 如果未指定默认语言代码，则使用英语（en）作为默认语言代码。
请参阅 支持语言的完整列表。
maxKeyPhraseCount （可选）产生最多关键词数量。
modelVersion （可选）指定调用关键短语 API 时所使用的 模型版本 。 如果未指定，默认使用最新的可用数据。 我们建议除非必要，不要指定这个数值。

技能输入

输入 Description
text 要分析的文本。
languageCode 一串表示记录语言的字符串。 如果未指定该参数，则使用默认语言代码来分析记录。
请参阅 支持语言的完整列表。

技能输出

输出 Description
keyPhrases 从输入文本中提取的关键短语列表。 关键短语按重要性顺序返回。

示例定义

考虑一个包含以下字段的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/myKeyPhrases

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

你可以用“文档/myKeyPhrases”作为其他技能的输入，或者作为 输出字段映射的来源。

警告

如果你提供了不支持的语言代码，会生成警告，关键短语不会被提取。 如果你的文本是空的，会生成警告。 如果文本超过50,000字符，只分析前50,000字符并发出警告。

另见

  • Last updated on