教學課程：在中建立 Alexa 技能專案 AWS CodeStar

AWS CodeStar是雲端式開發服務，提供AWS您快速開發、建置及部署應用程式所需的工具。AWS使用 AWS CodeStar，您可以在最短的時間內設定整個持續交付工具鏈，以便更快速地開始發佈程式碼。Alexa 技能項目模板使您能AWS CodeStar 夠創建一個簡單的你好世界 Alexa 的技能從您的AWS帳戶只需點擊幾下。本範本也會建立基本的部署管道，讓您開始使用技能開發的持續整合 (CI) 工作流程。

從中建立 Alexa 技能的主要好處AWS CodeStar是，您可以從中開始使用技能開發，AWS並將 Amazon 開發人員帳戶連接到專案，以便直接從中將技能部署到開發階段AWS。部署 (CI) 管道的使用也會準備就緒，其中的儲存庫具備專案所需的所有原始碼。您可透過偏好的 IDE 來設定此儲存庫，運用熟悉的工具來建立技能。

先決條件

• 前往 https://developer.amazon.com 建立 Amazon 開發人員帳戶，可免費註冊。此帳戶會擁有您的 Alexa 技能。

• 如果您還沒有 AWS 帳戶，請依照下列步驟建立新帳戶。

  註冊 AWS

  1. 開啟 https://aws.amazon.com/，然後選擇「建立AWS帳戶」。

     注意

     如果您先前已使用 AWS Management Console​ 登入資料登入 AWS 帳戶根使用者，請選擇 Sign in to a different account (登入不同的帳戶)。如果您先前使用 IAM 登入資料登入主控台，請選擇 [使用登入AWS 帳戶根使用者資料登入]。然後選擇創建一個新AWS帳戶。

  2. 請遵循線上指示進行。

重要

建立 Alexa 技能專案後，請將所有編輯功能限制在僅能於專案儲存庫內進行。建議您不要直接使用其他 Alexa Skills Kit 工具 (如 ASK CLI 或 ASK 開發人員主控台) 來編輯此技能，這些工具並未與專案儲存庫整合。使用這些工具會造成實際技能與儲存庫程式碼不同步。

步驟 1：建立專案並連結您的 Amazon 開發人員帳戶

此教學課程將使用 Node.js 在 AWS Lambda 上執行，藉此建立技能。其他語言大部分步驟都相同，只是技能名稱會有差異。有關您所選的特定專案範本詳細資訊，請參閱專案儲存庫內的 README.md 檔案。

1. 請登入AWS Management Console，然後開啟AWS CodeStar主控台，位於 https://console.aws.amazon.com/codestar/。

2. 選擇您想要建立專案及其資源的 AWS 區域。Alexa 技能執行階段適用於下列AWS區域：

   • 亞太區域 (東京)

   • 歐洲 (愛爾蘭)

   • 美國東部 (維吉尼亞北部)

   • 美國西部 (奧勒岡)

3. 選擇 Create project (建立專案)。

4. 在 Choose a project template (選擇專案範本) 頁面：

   1. 針對應用程式類型，選擇 Alexa 技能。

   2. 針對程式設計語言，請選擇 Node.js。

5. 選擇包含您的選取項目的方塊。

6. 在 Project name (專案名稱) 中，輸入專案的名稱 (如 My Alexa Skill)。如果您使用不同的名稱，請務必在本自學課程中使用它。 AWS CodeStar為專案 ID 選擇此專案的相關識別碼 (例如，my-alexa-skill)。如果您看到不同的專案 ID，請在此教學課程中都使用此名稱。

7. 在本教學中 CodeCommit為儲存庫選擇 AWS，並且不要變更存放庫名稱值。

8. 選擇 Connect Amazon developer account (連接 Amazon 開發人員帳戶) 來連結至您的 Amazon 開發人員帳戶以託管技能。如果您沒有 Amazon 開發人員帳戶，請先從 Amazon 開發人員建立帳戶並完成註冊。

9. 使用您的 Amazon 開發人員登入資料登入。選擇 [允許]，然後選擇 [確認] 以完成連線。

10. 若有許多廠商 ID 都與您的 Amazon 開發人員帳戶相關聯，請選擇欲用於此專案的 ID。請確認您使用的帳戶已指派管理員或開發人員角色。

11. 選擇下一步。

12. (選擇性) 如果這是您第一次AWS CodeStar在此AWS區域中使用，請輸入要AWS CodeStar用於 IAM 使用者的顯示名稱和電子郵件地址。選擇下一步。

13. 請等待 AWS CodeStar 建立專案。這可能需要幾分鐘的時間。在看到「專案佈建」橫幅之前，請勿繼續。

步驟 2：在 Alexa 模擬器內測試您的技能

第一個步驟中，AWS CodeStar 已為您建立技能，並將其部署到 Alexa 技能開發階段。接下來，您要在 Alexa 模擬器內測試該技能。

1. 在AWS CodeStar主控台的專案中，選擇 [檢視應用程式]。Alexa 模擬器將開啟新的分頁。

2. 使用您在步驟 1 連接至專案的 Amazon 開發人員帳戶登入資料來登入。

3. 在 Test (測試) 底下，選擇 Development (開發) 來啟動測試。

4. 輸入 ask hello node hello。技能預設的呼叫名稱為 hello node。

5. 您的技能應回應 Hello World!。

技能在 Alexa 模擬器啟用時，您亦可在支援 Alexa 的裝置 (須已向您的 Amazon 開發人員帳戶註冊) 上叫用此技能。欲在裝置上測試您的技能，請說 Alexa, ask hello node to say hello。

如需 Alexa 模擬器的詳細資訊，請參閱在開發人員主控台內測試您的技能相關文章。

步驟 3：探索您的專案資源

作為創建項目的一部分，AWS CodeStar也代表您創建了AWS資源。這些資源包括使用的專案儲存庫 CodeCommit、使用的部署管道 CodePipeline 和AWS Lambda函數。您可以從導覽列存取這些資源。例如，選擇存放庫會顯示有關存放 CodeCommit 庫的詳細資訊。您可以在「管線」頁面中檢視管線部署狀態。您可以在導覽列中選擇 [概觀]，檢視做為專案一部分所建立之AWS資源的完整清單。此清單包含每個資源的連結。

步驟 4：修改技能回應

您將在此步驟中小幅修改您的技能回應，以理解反覆運算的週期。

1. 在導覽列中，選擇「儲存庫」。選擇「存儲庫名稱」下的鏈接，您的項目存儲庫將在新標籤或窗口中打開。​此儲存庫包含建置規格 (buildspec.yml)、AWS CloudFormation 應用程式堆疊 (template.yml)、readme 檔案及技能套件格式 (專案結構) 內的技能原始碼。

2. 前往 lambda > custom (自訂) > index.js (若使用 Node.js) 的檔案。此檔案包含您使用 ASK SDK 的請求處理程式碼。

3. 選擇 編輯 。

4. 將第 24 列的字串 Hello World! 取代為字串 Hello. How are you?。

5. 向下捲動到檔案結尾。輸入作者名稱、電子郵件地址，以及選用的遞交訊息。

6. 選擇 Commit changes (遞交變更) 來確認儲存庫的變更。

7. 返回中的專案AWS CodeStar並檢查「管線」頁面。您現在應看到管道正在部署。

8. 管道部署完成後，請於 Alexa 模擬器內再次測試您的技能。您的技能現應回應 Hello. How are you?。

步驟 5：將您的本機工作站設定為連接至專案儲存庫

之前，您直接從 CodeCommit 控制台對源代碼進行了一些小的更改。在此步驟中，您將設定專案儲存庫以搭配本機工作站，如此即可從命令列或您偏好的 IDE 編輯並管理程式碼。下列步驟會說明如何設定命令列工具。

1. 前往 AWS CodeStar 內的專案儀表板 (如需要)。

2. 在導覽列中，選擇 IDE。

3. 在訪問您的項目代碼中，查看命令行界面下的說明。

4. 遵循指示完成以下任務：

   1. 從網站 (如 Git Downloads) 將 Git 安裝到您的本機工作站。

   2. 安裝 AWS CLI。如需資訊，請參閱安裝 AWS 命令列界面。

   3. 使用您的 IAM 使用者存取金鑰和秘密金鑰設定 AWS CLI。如需相關資訊，請參閱設定 AWS CLI。

   4. 將專案的 CodeCommit 儲存庫複製到本機工作站。如需詳細資訊，請參閱 Connect 至 CodeCommit 存放庫。

後續步驟

此教學課程讓您了解基本技能的入門。欲繼續您的技能開發之旅，請參閱下列資源。

• 觀看 Alexa 技能的運作方式以及 Alexa 開發人員頻 YouTube道上的其他影片，瞭解技能的基本原理。

• 檢閱技能套件格式、技能資訊清單結構描述及互動模型結構描述等文件，理解技能的各種元件。

• 檢閱 Alexa Skills Kit 及 ASK SDK 等文件，將您的想法轉化為技能。