本文分享自華為雲社群《【雲駐共創】手把手的使用Toolkit外掛在詩情畫意中完成AI詩朗誦》，作者： 紅目香薰。
雲原生時代，開發者們的程式設計方式、程式設計習慣都發生了天翻地覆的變化，大家逐漸地習慣在雲端構建自己的應用。作為新一代的開發者們，如何更快速瞭解雲，學習雲，使用雲，更便捷、更智慧的開發程式碼，從而提升我們的開發效率，是當前最熱門的話題之一，而Huawei Cloud Toolkit,作為連線華為雲的百寶箱，是整合在各大IDE平臺上的外掛集合，會在方方面面提升著開發者的效率。
外掛介紹
1、和雲端建立連結——華為雲API開發套件2、開發更"智慧"——華為雲CodeArts Snap3、守護程式碼質量與安全——華為雲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就能看到華為的豬都外掛都可以下載使用。
2、華為程式碼大模型的應用:華為雲CodeArts Snap智慧程式設計助手
沉澱華為自主研發程式碼大模型和軟體分析技術，以IDE外掛形式賦能開發者高效、可信開發，支援主流程式語言和IDE生態，大體分為JetBrains的IDE生態與Visual Studio的IDE生態，下圖為兩種生態工具的截圖：
華為雲CodeArts Snap智慧程式設計助手外掛的核心價值特性有：
1、全場景函式級、行級程式碼生成。
2、支援中英文描述，透過自然語言一鍵生成完整函式級程式碼
3、同規模同算力一次透過率業界第一
4、專業開發者程式設計量減少20%
協同華為雲CodeArts軟體開發平臺服務政府、國央企、傳統大企和網際網路企業。
3、華為雲CodeArts Check IDE外掛:實時精準守護軟體質量與安全
-
整合華為雲Check雲服務輕量級檢查規則，精準覆蓋質量類、風格類與安全類關鍵檢查能力，與雲服務共築三層程式碼防護體系，兼顧效率與質量。
-
提供豐富的過濾選項，支援使用者分級分類檢視規則，加速使用者學習瞭解規則的使用。
-
支援檔案/資料夾/專案級掃描，同時提供一鍵格式化能力及自動修復功能。
-
提供詳細的缺陷修復指導，包括缺陷描述資訊，遵從規範，正確示例，錯誤示例，修改建議。
-
相容多平臺: VSCodelDE、 Intellij IDEA、 CodeArts IDE; 並提供Java, C, C++ 3種語言的檢測能力。
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,配置好maven、JDK等環境
外掛安裝:檔案-> 設定->外掛，下載安裝Huawei Cloud API外掛
二、主要流程:
1.選:開啟Huawei Cloud API外掛,選擇"人工智慧"->"自然語言處理" ->"語言生成服務"-> "RunPoem (詩歌生成)"
2.學:仔細檢視介面詳情，包括輸入引數和輸出模型定義，以及SDK示例程式碼
3.寫:在業務程式碼需要呼叫AP|的地方，直接輸入RunPoem, IDE會自動補全呼叫程式碼，也將依賴SDK包匯入至工程
4.Debug:除錯寫好的程式碼，檢視API返回結果是否符合預期
實戰一操作過程
安裝完畢後可以看到華為的標識：
需要登入賬號：
登入成果效果：
為了演示方便，我們下載一箇中文外掛：
這回看著中文演示方便多了。
我們使用詩歌生成的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：
一、準備工作
環境搭建:下載安裝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:除錯寫好的程式碼，完成語音合成應用
實戰二操作過程
先安裝外掛啊，安裝完成可以看到右側選單欄中就有了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)
實戰三CodeArts Check：
主題說明:開發者在IntelliJ IDEA上，基於華為雲CodeArts Check進行程式碼檢查
環境搭建:下載安裝IntelliJ IDEA,配置好maven、JDK等環境
外掛安裝:檔案-> 設定->外掛，下載安裝Huawei Cloud CodeArts Check外掛
1.用:開啟目標檢查程式碼檔案，滑鼠右鍵撥出選單，點選"CodeArts Check檔案檢查"。
3.寫:點選問題檢視規則詳情，按照說明修改程式碼，寫出安全、簡潔、規範的程式碼。
實戰三操作過程
先安裝CodeArts Check外掛
安裝完畢還是需要重啟的。
使用檢查實戰一二的程式碼。
點選就可以操作，或者滑鼠右鍵選擇檔案檢查，我們更換一個程式碼測試一下，發現已經找到其中的最佳化方案了。
這裡報的是程式碼規範：
至此，我們第三個實戰又結束了。
總結
我們在整篇文章中瞭解了華為雲的諸多外掛以及API介面的使用，並且結合實戰一與實戰二將AI生成的詩詞進行了朗讀的操作，在文章中也穿插了音訊，可以試聽一下。
點選關注，第一時間瞭解華為雲新鮮技術~