如何升级你的Azure AI语言项目到最新版本

在快节奏的技术世界中，不断更新和升级你的项目以适应最新的技术和功能是至关重要的。Azure AI语言服务也不例外。最新的版本通常提供更多功能、更好的性能和更多的优化选项。本教程将向你展示如何将你的Azure AI语言项目升级到最新版本，以充分利用其强大的功能。

教程大纲

1. 介绍

   • 为什么要升级你的Azure AI语言项目？
   • 本教程的目标和范围。

2. 升级统一语言终结点 (REST API)

   • 了解旧的终结点格式。
   • 更新终结点以使用最新的Azure AI语言服务。
   • 更新JSON请求正文的格式。

3. 升级客户端库

   • 下载最新的Azure.AI.TextAnalytics客户端库。
   • 更新应用程序以使用新的客户端库。

4. 版本2.1功能更改

   • 了解情感分析、命名实体识别、个人身份信息检测和实体链接的更改。
   • 更新应用程序以适应新的实体类别。

5. 总结

   • 总结升级步骤和注意事项。
   • 强调项目现在能够利用的新功能。

1. 介绍

为什么要升级你的Azure AI语言项目？

随着Azure AI语言服务不断发展，新的功能和性能优化正在不断推出。通过升级到最新版本，你可以获得以下好处：

• 更强大的功能：最新版本通常会引入新的功能和改进，可以提供更精确的结果和更广泛的用例支持。
• 更好的性能：性能优化可以加快你的应用程序的处理速度，提高用户体验。
• 更多的安全性：新版本通常会修复已知的安全漏洞，确保你的数据和应用程序的安全性。
• 更长期的支持：旧版本可能会停止维护和支持，升级到最新版本可以确保你的项目在未来保持可维护性。

本教程的目标和范围

本教程旨在帮助你将你的Azure AI语言项目升级到最新版本。我们将重点关注以下方面：

• 如何更新统一语言终结点 (REST API) 以适应最新的Azure AI语言服务。
• 如何下载并使用最新版本的Azure.AI.TextAnalytics客户端库。
• 版本2.1中的功能更改，包括情感分析、命名实体识别、个人身份信息检测和实体链接的变化。

现在，让我们开始升级你的项目吧！

2. 升级统一语言终结点 (REST API)

了解旧的终结点格式

在升级你的Azure AI语言项目之前，首先需要了解旧的REST API终结点格式。以前的终结点格式如下所示：

https://<your-custom-subdomain>.cognitiveservices.azure.com/text/analytics/<version>/<feature>

如果你的应用程序使用了这种终结点格式，那么需要注意以下语言服务功能的REST API终结点已经发生了变化：

• 实体链接
• 关键短语提取
• 语言检测
• 命名实体识别 (NER)
• 个人身份信息 (PII) 检测
• 情感分析和观点挖掘
• 运行状况文本分析

更新终结点以使用最新的Azure AI语言服务

最新的Azure AI语言服务现在提供了一个统一的终结点，用于向这些功能发送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输出。

3. 升级客户端库

要使用最新版本的客户端库，你需要下载Azure.AI.TextAnalytics命名空间中的最新软件包。下面是更新客户端库的步骤：

1. 打开你的项目，确保你已经安装了旧版本的Azure.AI.TextAnalytics客户端库。

2. 打开你的包管理器或控制台，并运行以下命令来安装最新版本的客户端库：

   Install-Package Azure.AI.TextAnalytics -Version 5.1.0

   这将安装版本5.1.0的Azure.AI.TextAnalytics客户端库。

3. 更新你的应用程序代码，以使用新的客户端库。确保更新任何旧版本的命名空间引用，并按照新版本的文档来配置和使用客户端库。

4. 版本2.1功能更改

如果你的应用程序是从API的v2.1版本迁移而来，你需要注意一些功能的更改。下面是主要的功能更改：

情感分析 v2.1

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

NER、PII和实体链接 v2.1

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

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

版本2.1实体类别

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

• 人员
• 位置
• 组织
• PhoneNumber（仅限美国和欧洲电话号码）
• 电子邮件
• URL
• IP
• DateTime
• Date
• 时间
• DateRange
• TimeRange
• 持续时间
• 设置
• 数量
• Number
• 百分比
• Ordinal
• Age
• 货币
• 维度
• 温度
• 语言检测 v2.1

语言检测 v2.1

语言检测功能的输出在当前版本中已经发生了变化。JSON响应将包含ConfidenceScore，而不再是score。当前版本也只会为每个文档返回一种语言。

关键短语提取 v2.1

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

5. 总结

升级你的Azure AI语言项目到最新版本可以带来更多功能、更好的性能和更多的优化选项。在本教程中，我们介绍了以下升级步骤：

1. 更新统一语言终结点 (REST API) 以适应最新的Azure AI语言服务。
2. 下载并使用最新版本的Azure.AI.TextAnalytics客户端库。
3. 了解版本2.1中的功能更改，并更新你的应用程序以适应新的实体类别。

现在，你可以开始升级你的项目，利用Azure AI语言服务的最新功能和性能优势，提升你的应用程序的质量和用户体验。