Compartir a través de

迁移到最新版本的 Azure 语言

小窍门

刚开始使用 Azure 语言？ 有关服务、可用功能和快速入门链接的详细信息，请参阅概述文章，了解有关 API 当前版本的信息。

如果应用程序仍在使用文本分析 API 或客户端库（在稳定 v5.1.0 之前），本文将帮助你升级应用程序以使用最新版本的 Azure 语言 功能。

统一语言终结点 (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

在版本 2.1 中，情感分析为发送到 API 的每个文档返回介于 0 到 1 之间的情感分数，分数越接近 1 表示情感越积极。 此功能的当前版本可返回句子和整个文档的情绪标签（例如“积极”或“消极”）及其相关的置信度分数。

NER、PII 和实体链接 v2.1

在版本 2.1 中，文本分析 API 为命名实体识别 (NER) 和实体链接使用一个终结点。 此功能的当前版本提供扩展的命名实体检测，并对 NER 和实体链接请求使用单独的终结点。 此外，可以使用 Azure 语言中提供的另一项功能来检测个人（PII）和健康（PHI）信息。

还需要更新应用程序以使用 API 响应中返回的实体类别。

版本 2.1 实体类别

下表列出了为 NER v2.1 返回的实体类别。

类别 Description
人员 人员姓名。
位置 自然地标和人造地标、结构、地理特征和地缘政治实体
组织 公司、政治团体、乐队、体育俱乐部、政府机构和公共组织。 民族和宗教不包括在此实体类型中。
电话号码 电话号码（仅限美国和欧洲电话号码）。
Email 电子邮件地址。
URL 网站的 URL。
IP 网络 IP 地址。
DateTime 某天的日期和时间。
日期 日历日期。
Time 一天中的时间
日期范围 日期范围。
TimeRange 时间范围。
持续时间 持续时间。
设置 集，重复的时间。
数量 数字和数量。
编号 数字。
百分比 百分比。
序数 序号。
年龄 年龄。
货币 货币。
尺寸 维度和度量。
温度 温度。

语言检测 v2.1

语言 检测 功能输出在当前版本中已更改。 JSON 响应包含 ConfidenceScore 而不是 score. 当前版本也只为每个文档返回一种语言。

关键短语提取 v2.1

关键短语提取功能目前仅限于终结点和请求格式，没有其他改动。

另请参阅

  • Last updated on