迁移到最新版本的 Azure AI 语言
提示
刚开始使用 Azure AI 语言? 有关服务、可用功能和快速入门链接的详细信息,请参阅概述文章,了解有关 API 当前版本的信息。
如果应用程序仍在使用文本分析 API 或客户端库(低于稳定版 v5.1.0),本文将帮助你升级应用程序以使用最新版本的 Azure AI 语言功能。
统一语言终结点 (REST API)
本部分适用于使用旧的 /text/analytics/...
终结点格式进行 REST API 调用的应用程序。 例如:
https://<your-custom-subdomain>.cognitiveservices.azure.cn/text/analytics/<version>/<feature>
如果应用程序使用上述终结点格式,则以下语言服务功能的 REST API 终结点已更改:
语言服务现提供一个统一终结点,用于向这些功能发送 REST API 请求。 如果应用程序使用 REST API,请更新其请求终结点以使用当前终结点:
https://<your-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01
此外,JSON 请求正文的格式已更改。 需要更新应用程序发送到 API 的请求结构,例如以下实体识别 JSON 正文:
{
"kind": "EntityRecognition",
"parameters": {
"modelVersion": "latest"
},
"analysisInput":{
"documents":[
{
"id":"1",
"language": "en",
"text": "I had a wonderful trip to Seattle last week."
}
]
}
}
使用上面链接的快速入门查看正在使用的功能的当前示例 REST API 调用,以及关联的 API 输出。
客户端库
要使用最新版本的客户端库,需要下载 Azure.AI.TextAnalytics
命名空间中的最新软件包。 有关以首选语言使用客户端库的示例代码和说明,请参阅上面链接的快速入门文章。
版本 2.1 功能更改
如果要从 API 的 v2.1 迁移应用程序,应注意对特性功能的一些更改。
情绪分析 v2.1
对于发送到 API 的每个文档,版本 2.1 中的情绪分析会返回 0 到 1 之间的一个情绪分数,分数越接近 1 表示情绪越积极。 此功能的当前版本可返回句子和整个文档的情绪标签(例如“积极”或“消极”)及其相关的置信度分数。
NER、PII 和实体链接 v2.1
在版本 2.1 中,文本分析 API 为命名实体识别 (NER) 和实体链接使用一个终结点。 此功能的当前版本提供扩展的命名实体检测,并对 NER 和实体链接请求使用单独的终结点。 此外,可以使用语言服务中提供的另一项功能来检测个人 (PII) 和运行状况 (PHI) 信息。
你还需要更新应用程序,以使用 API 的响应中返回的实体类别。
版本 2.1 实体类别
下表列出了为 NER v2.1 返回的实体类别。
类别 | 说明 |
---|---|
人员 | 人员姓名。 |
位置 | 自然地标和人造地标、结构、地理特征和地缘政治实体 |
组织 | 公司、政治团体、乐队、体育俱乐部、政府机构和公共组织。 民族和宗教不包括在此实体类型中。 |
PhoneNumber | 电话号码(仅限美国和欧洲电话号码)。 |
电子邮件 | 电子邮件地址。 |
URL | 指向网站的 URL。 |
IP | 网络 IP 地址。 |
DateTime | 某天的日期和时间。 |
Date | 日历日期。 |
时间 | 一天中的时间 |
DateRange | 日期范围。 |
TimeRange | 时间范围。 |
持续时间 | 持续时间。 |
设置 | 集,重复的时间。 |
数量 | 数字和数量。 |
Number | 数字。 |
百分比 | 百分比。 |
Ordinal | 序号。 |
Age | 年龄。 |
货币 | 货币。 |
维度 | 维度和度量。 |
温度 | 温度。 |
语言检测 v2.1
语言检测功能输出在当前版本中已更改。 JSON 响应将包含 ConfidenceScore
,而不是 score
。 当前版本也只为每个文档返回一种语言。
关键短语提取 v2.1
关键短语提取功能目前在终结点和请求格式之外没有改变。
请参阅
- 什么是 Azure AI 语言?
- 语言服务开发者指南
- 有关先前 API 版本的信息,请参阅以下参考文档。
- 使用以下快速入门指南查看这些功能的当前版本的示例。