手把手的使用 Toolkit 插件在诗情画意中完成 AI 诗朗诵

2024-03-14
广东
本文字数：5028 字
阅读完需：约 16 分钟

本文分享自华为云社区《【云驻共创】手把手的使用Toolkit插件在诗情画意中完成AI诗朗诵》，作者：红目香薰。

云原生时代，开发者们的编程方式、编程习惯都发生了天翻地覆的变化，大家逐渐地习惯在云端构建自己的应用。作为新一代的开发者们，如何更快速了解云，学习云，使用云，更便捷、更智能的开发代码，从而提升我们的开发效率，是当前最热门的话题之一，而 Huawei Cloud Toolkit,作为连接华为云的百宝箱，是集成在各大 IDE 平台上的插件集合，会在方方面面提升着开发者的效率。

插件介绍

本段落主要介绍华为云的以下三块内容：

1、和云端建立链接——华为云 API 开发套件
2、开发更"智能"——华为云 CodeArts Snap
3、守护代码质量与安全——华为云 CodeArts Check

华为云 API 开发套件助力开发者快速集成华为云，可做到便捷连接 200+的华为云服务，引用 7000+的华为云 API 服务，在 IDE 中集成华为云的功能，让开发者与云端华为云建立连接。

智能编码方面集成了华为云自主研发的代码大模型和软件分析技术，全场景函数级、行级代码生成，同规模算力一次通过业界第一，这会帮助开发者更为高效的使用自动语义生成，达到快速开发的目的，使整个过程更智能。

代码质量与安全上华为云 CodeArts Check 插件可以做到守护代码的质量与安全，帮助开发者精准的实施代码检查，以及提供了代码的一键格式化、一键自动修复的功能，可以确保编程规范的落地。IDE 插件与云端服务构筑了三层代码防护体系。

1、华为云 API:云原生开发者必备的 coding 利器

华为云通过 API 提供服务全面开放能力，为开发者构建华为云应用和变现基础，是开发者核心关注的"生产要素"之一，各云服务提供 SDK，帮助开发者快速集成 API，面对海量的各种各样的开发者，华为云提供多种语言 SDK 应用到各行各业，面对各行各业海量诉求，如何更快速、更便捷地找到契合的 API,并且快速集成到应用中，成为开发者提升开发效率的当务之急。

华为云的 OpenAPI 提供了各类的产品服务，如计算类、存储类、人工智能类、运营类、应用中间件、管理与监管等等诸多的功能品类的 API 服务可以让我们快速的找到我们需要的具体需求来解决我们的各类问题。并且有着大量的错误码提示，加快异常问题的解决高速、高效的完成我们的开发需求。

可以在人工智能的开放接口中看到，自然语言处理、人机对话、人脸识别、图像识别、推荐系统等等的功能可以更好的通过 AI 的形式帮助我们提高工作的效率。为开发者打造更好的应用云体验。

在 API 插件中，华为云提供了如下功能:

对接华为云 API 开放平台，全面覆盖华为云 200+云服务、7000+API, 支持用户检索 API、查看 API 文档、调试 API、以及提供 SDK 示例代码供用户学习如何使用 API。
提供华为云 SDK 代码片段补全功能，SDK 依赖包自动引入，加速用户集成华为云 API。
对接华为云开发体验馆 Codelabs, 提供 500+云服务代码示例，向导式教程帮助用户快速学习。

华为云提供的 API 插件支持多 IDE 的平台，可以让我们开发更加得心应手，以及对应的热门开发语言代码的补全支持，下图可以看到常见的语言 Java、Python、Go、JavaScript 等语言都是支持的。

例如我们拿 PyCharm Community Edition 举例，可以看到我们点开插件安装的时候搜索 Huawei 就能看到华为的猪都插件都可以下载使用。

这里我们看到第一个就是 CodeArts Snap 智能编程助手，接下来我们就来介绍一下它吧。

2、华为代码大模型的应用:华为云 CodeArts Snap 智能编程助手

沉淀华为自主研发代码大模型和软件分析技术，以 IDE 插件形式赋能开发者高效、可信开发，支持主流编程语言和 IDE 生态，大体分为 JetBrains 的 IDE 生态与 Visual Studio 的 IDE 生态，下图为两种生态工具的截图：

华为云 CodeArts Snap 智能编程助手插件的核心价值特性有：

1、全场景函数级、行级代码生成。

2、支持中英文描述，通过自然语言一键生成完整函数级代码

3、同规模同算力一次通过率业界第一

4、专业开发者编程量减少 20%

协同华为云 CodeArts 软件开发平台服务政府、国央企、传统大企和互联网企业。

Snap 在软件研发生产线起到非常重要的作用。

3、华为云 CodeArts Check IDE 插件:实时精准守护软件质量与安全

华为云 Check 插件，助力开发者实时精准检查，在 Check 插件中，华为云提供了如下功能：

集成华为云 Check 云服务轻量级检查规则，精准覆盖质量类、风格类与安全类关键检查能力，与云服务共筑三层代码防护体系，兼顾效率与质量。
提供丰富的过滤选项，支持用户分级分类查看规则，加速用户学习了解规则的使用。
支持文件/文件夹/项目级扫描，同时提供一键格式化能力及自动修复功能。
提供详细的缺陷修复指导，包括缺陷描述信息，遵从规范，正确示例，错误示例，修改建议。
兼容多平台: VSCodelDE、 Intellij IDEA、 CodeArts IDE; 并提供 Java, C, C++ 3 种语言的检测能力。

支持华为云 CodeArts Check 云服务构筑三级防护体系，高效开展代码检查活动。

Huawei Cloud Toolkit 初体验

体验地址：https://developer.huaweicloud.com/develop/toolkit.html?utm_source=hw_zz&ticket=ST-8951111-XM1Xi9kdd7fzZxXe4NwquHSE-sso&locale=zh-cn

迈向云原生之路:华为云 Toolkit 实战

实战一 Huawei Cloud API：

开发者在 IntelliJ IDEA 上，基于华为云 NLP 自然语言处理服务 API 实现一个 AI 作诗的应用。

一、准备工作

环境搭建:下载安装 IntelliJ IDEA,配置好 maven、JDK 等环境

插件安装:文件-> 设置->插件，下载安装 Huawei Cloud API 插件

二、主要流程:

1.选:打开 Huawei Cloud API 插件,选择"人工智能"->"自然语言处理" ->"语言生成服务"-> "RunPoem (诗歌生成)"

2.学:仔细查看接口详情，包括输入参数和输出模型定义，以及 SDK 示例代码

3.写:在业务代码需要调用 AP|的地方，直接输入 RunPoem, IDE 会自动补全调用代码，也将依赖 SDK 包导入至工程

4.Debug:调试写好的代码，查看 API 返回结果是否符合预期

扩展内容:大家可以选择插件中展示的其他有意思的 API 进行调试开发，比如人脸识别、文字识别、图像识别服务的 API 等等, 包括且不限于:可以使用自然语言处理服务的 AP|来判断一段文本的情感表达; 使用人脸识别服务的 API 进行人脸比对，人脸检测;使用文字识别，服务的 API 进行证件图片文字扫描提取;使用图像识别服务的 API 分析并识别图片中包含的政治人物、明星及网红人物。

实战一操作过程

首先需要先在插件商店安装华为云的 Cloud API 插件，点击【Install】安装即可，安装完毕需要重新启动计算机。

安装完毕后可以看到华为的标识：

需要登录账号：

登录成果效果：

为了演示方便，我们下载一个中文插件：

这回看着中文演示方便多了。

我们使用诗歌生成的 API：

为了操作方便，我们选择 Python 语言来测试。

复制代码后直接引入到编辑文件中，这里能看到有没有的库需要我们单独引入。

调用前需要开通服务：https://console.huaweicloud.com/nlp/#/nlp/overview

开通成功提示：

调试效果：

再来一次：

"红目香薰",
"红心不作小桃粧，",
"笑倚东风百媚香。",
"若使落花深见妒，",
"一朝应怨夕阳长。"

代码测试，这里少什么包直接 pip 安装什么包就 OK 了，国内的华为镜像，超级块。

不报错后需要单独的签名一下：

签名地址：https://support.huaweicloud.com/devg-apisign/api-sign-provide.html

我的凭证

添加秘钥

可以看到已开通

有了对应的 AK/SK 就能访问了，运行成功效果：

到这里呢，第一个实战就结束了，后面的实战对应的开通以及 AK/SK 获取与这个操作步骤相同。

实战二 CodeArts Snap：

主题说明:开发者在 IntellijJ IDEA 上，基于华为云 CodeArts Snap 智能编程助手实现一个语音合成的应用

一、准备工作

环境搭建:下载安装 IntelliJ IDEA,配置好 maven、JDK 等环境

插件安装:文件-> 设置->插件，下载安装 Huawei Cloud CodeArts Snap 插件

二、主要流程:

1.搜:打开 Huawei Cloud API 插件，搜素关键字"语音合成"

2.选:找到由 SIS 云服务提供一个语音合成接口 RunTts, 查看接口功能描述，确认是想要的

3.学:仔细查看接口详情，包括输入参数和输出模型定义

4.用:输入参数，使用 API 插件的在线调试能力，查看接口返回值

5.写:使用 Huawei Cloud CodeArts Snap 插件，输入想要实现的逻辑作为注释，快捷键 Alt +C,选择想要生成的代码

6.Debug:调试写好的代码，完成语音合成应用

扩展内容:大家可以选择插件中展示的其他有意思的 API 进行调试开发，同时也可以在自己的代码工程中使用 CodeArts Snap 插件,包括且不限于直接 ALT+C/Enter 根据上下文智能生成代码;输入注释，按 ALT+C/Enter 生成根据注释内容和上下文智能生成代码。

实战二操作过程

先安装插件啊，安装完成可以看到右侧菜单栏中就有了 CodeArts Snap 插件了。

找到对应的语音合成接口。

API 操作：

这里要写上 text，也就是需要合成的文本内容，下面的选项是生成文件的格式，采样率以及使用的语音音色。

调试测试成功。

运行后可以正常播放：

源码留在这里，我写了将 base64 字符串解码为字节流的函数。

# coding: utf-8 import base64 from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdksis.v1.region.sis_region import SisRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdksis.v1 import * def base64_to_file(base64_string, file_path): # 将base64字符串解码为字节流 decoded_bytes = base64.b64decode(base64_string) # 将字节流写入文件 with open(file_path, 'wb') as file: file.write(decoded_bytes) if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = "OPZYI*******4" sk = "t7XDJTV8MeOf***************34yh4OVdI" projectId = "e10b8f0d1e59477cb65ab1c6ad1d6eac" credentials = BasicCredentials(ak, sk, projectId) client = SisClient.new_builder() \ .with_credentials(credentials) \ .with_region(SisRegion.value_of("cn-east-3")) \ .build() try: request = RunTtsRequest() configbody = TtsConfig( audio_format="mp3", sample_rate="16000", _property="chinese_xiaoyan_common" ) request.body = PostCustomTTSReq( config=configbody, text="期待新的一年您更继续创造更多的价值——红目香薰·留" ) response = client.run_tts(request) # 将base64转换成文件 print(response.result.data) base64_to_file(response.result.data, "a.mp3") except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg)

复制代码

字打错了，但是直接生成了。能证明一点，肯定是刚刚生成的。我们最后来根据实战一生成的诗句来朗读一下，到这里实验二又结束了。