迁移到最新版本的 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

关键短语提取功能目前在终结点和请求格式之外没有改变。

请参阅