在快节奏的技术世界中，不断更新和升级你的项目以适应最新的技术和功能是至关重要的。Azure AI语言服务也不例外。最新的版本通常提供更多功能、更好的性能和更多的优化选项。本教程将向你展示如何将你的Azure AI语言项目升级到最新版本，以充分利用其强大的功能。
教程大纲
-
介绍
- 为什么要升级你的Azure AI语言项目？
- 本教程的目标和范围。
-
升级统一语言终结点 (REST API)
- 了解旧的终结点格式。
- 更新终结点以使用最新的Azure AI语言服务。
- 更新JSON请求正文的格式。
-
升级客户端库
- 下载最新的Azure.AI.TextAnalytics客户端库。
- 更新应用程序以使用新的客户端库。
-
版本2.1功能更改
- 了解情感分析、命名实体识别、个人身份信息检测和实体链接的更改。
- 更新应用程序以适应新的实体类别。
-
总结
- 总结升级步骤和注意事项。
- 强调项目现在能够利用的新功能。
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命名空间中的最新软件包。下面是更新客户端库的步骤：
-
打开你的项目，确保你已经安装了旧版本的Azure.AI.TextAnalytics客户端库。
-
打开你的包管理器或控制台，并运行以下命令来安装最新版本的客户端库：
Install-Package Azure.AI.TextAnalytics -Version 5.1.0这将安装版本5.1.0的Azure.AI.TextAnalytics客户端库。
-
更新你的应用程序代码，以使用新的客户端库。确保更新任何旧版本的命名空间引用，并按照新版本的文档来配置和使用客户端库。
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语言项目到最新版本可以带来更多功能、更好的性能和更多的优化选项。在本教程中，我们介绍了以下升级步骤：
- 更新统一语言终结点 (REST API) 以适应最新的Azure AI语言服务。
- 下载并使用最新版本的Azure.AI.TextAnalytics客户端库。
- 了解版本2.1中的功能更改，并更新你的应用程序以适应新的实体类别。
现在，你可以开始升级你的项目，利用Azure AI语言服务的最新功能和性能优势，提升你的应用程序的质量和用户体验。
