教學課程：使用 CodeCatalyst 生成式 AI 功能加速開發工作

請在以下位置開啟 CodeCatalyst 主控台。 https://codecatalyst.aws/

在主 CodeCatalyst 控台中，導覽至要建立藍圖的空間。

在空間儀表板上，選擇使用 Amazon Q 建立。

在 Amazon Q 提示文字輸入欄位中，透過撰寫您要建置之專案的簡短說明來提供指示。例如：“I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”

(選擇性) 在「試用範例」下，您可以選擇藍圖來使用預先寫入的提示。例如，如果您選擇 React 應用程式，則會提供下列提示：“I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”

選擇傳送以將指示提交給 Amazon 問。生成 AI 助理會提供建議，並概述藍圖無法滿足的需求。例如，Amazon Q 可能會根據您的條件建議以下內容：

I recommend using the Modern three-tier web application blueprint based on 
                    your requirements. Blueprints are dynamic and can always be updated and edited later.

Modern three-tier web application
By Amazon Web Services

This blueprint creates a Mythical Mysfits 3-tier web application with a modular presentation, application, and data layers. 
The application leverages containers, infrastructure as code (IaC), continuous integration and continuous delivery (CI/CD), 
and serverless code functions.

Version: 0.1.163

View details

The following requirements could not be met so I will create issues for you.
• Add authentication and authorization mechanisms for security and allowable actions.

(選擇性) 若要檢視建議藍圖的深入詳細資料，請選擇檢視詳細資料。

執行以下任意一項：

1. 如果您對建議感到滿意，請選擇「是，請使用此藍圖」。

2. 如果您要修改提示，請選擇 [編輯提示]。

3. 如果您要完全清除提示，請選擇「重新開始」。

執行以下任意一項：

1. 如果您要設定建議的藍圖，請選擇設定。您也可以稍後設定藍圖。

2. 如果您目前不想修改藍圖組態，請選擇略過。

如果您選擇設定藍圖，請在修改專案資源後選擇繼續。

出現提示時，輸入您要指定給專案的名稱及其相關聯的資源名稱。名稱在您的空間中必須是唯一的。

選擇 [建立專案] 以使用藍圖建立專案。Amazon Q 使用藍圖建立資源。例如，如果您使用單頁應用程式藍圖建立專案，則會為 CI/CD 建立相關程式碼和工作流程的來源存放庫。

(選擇性) 依預設，Amazon Q 也會針對藍圖不滿足的需求建立問題。您可以選擇不想建立問題的項目。選擇讓 Amazon Q 建立問題之後，您也可以將問題指派給 Amazon Q。它將在給定源存儲庫的上下文中分析問題，提供相關源文件和代碼的摘要。如需詳細資訊，請參閱尋找和檢視問題、建立問題並將其指派給 Amazon Q及建立和處理指派給 Amazon Q 的問題時的最佳實務。

請在以下位置開啟 CodeCatalyst 主控台。 https://codecatalyst.aws/

在主 CodeCatalyst 控台中，導覽至要新增藍圖的專案。

選擇添加與 Amazon Q.

在 Amazon Q 提示文字輸入欄位中，透過撰寫您要建置之專案的簡短說明來提供指示。例如：“I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”

(選擇性) 在「試用範例」下，您可以選擇藍圖來使用預先寫入的提示。例如，如果您選擇 React 應用程式，則會提供下列提示：“I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”

選擇傳送以將指示提交給 Amazon 問。生成 AI 助理會提供建議，並概述藍圖無法滿足的需求。例如，Amazon Q 可能會根據您的條件建議以下內容：

I recommend using the Single-page application blueprint based on your requirements. Blueprints are dynamic and can always be updated and edited later.

Single-page application
By Amazon Web Services

This blueprint creates a SPA (single-page application) using React, Vue, or Angular frameworks and deploys to AWS Amplify Hosting.

Version: 0.2.15
View details

The following requirements could not be met so I will create issues for you.
• The application should have reusable UI components
• The application should support for client-side routing
• The application may require server-side rendering for improved performance and SEO

(選擇性) 若要檢視建議藍圖的深入詳細資料，請選擇檢視詳細資料。

執行以下任意一項：

1. 如果您對建議感到滿意，請選擇「是，請使用此藍圖」。

2. 如果您要修改提示，請選擇 [編輯提示]。

3. 如果您要完全清除提示，請選擇「重新開始」。

執行以下任意一項：

1. 如果您要設定建議的藍圖，請選擇設定。您也可以稍後設定藍圖。

2. 如果您目前不想修改藍圖組態，請選擇略過。

如果您選擇設定藍圖，請在修改專案資源後選擇繼續。

選擇 [新增至專案] 以將資源新增至具有藍圖的專案。Amazon Q 使用藍圖建立資源。例如，如果您使用單頁應用程式藍圖新增至專案，則會建立 CI/CD 相關程式碼和工作流程的來源存放庫。

(選擇性) 依預設，Amazon Q 也會針對藍圖不滿足的需求建立問題。您可以選擇不想建立問題的項目。選擇讓 Amazon Q 建立問題之後，您也可以將問題指派給 Amazon Q。它將在給定源存儲庫的上下文中分析問題，提供相關源文件和代碼的摘要。如需詳細資訊，請參閱 建立問題並將其指派給 Amazon Q 及 建立和處理指派給 Amazon Q 的問題時的最佳實務。

在主 CodeCatalyst 控台中，導覽至來源儲存庫所在的專案。

從專案的來源儲存庫清單中選擇儲存庫的名稱。或者，在導覽窗格中，選擇 [程式碼]，然後選擇 [原始碼儲存庫]。

選擇要在其中創建分支的存儲庫。

在儲存庫的概觀頁面上，選擇 [其他]，然後選擇 [建立分支]。

輸入分支的名稱。

選擇要從中建立分支的分支，然後選擇 [建立]。

在mysfits來源存放庫的概觀頁面上，選擇分支下拉式清單，然後選擇您在上一個程序中建立的分支。

在「檔案」中，導覽至您要編輯的檔案。例如，若要編輯test_endpoint.py檔案，請展開測試、展開 integ，然後選擇test_endpoint.py。

選擇編輯。

在第 7 行中，更改所有測試將從以下位置重試的次數：

def test_list_all(retry=3):

至:

def test_list_all(retry=5):

選擇「提交」並將您的更改提交到分支。

在儲存區域的總覽頁面上，選擇 [其他]，然後選擇 [建立提取要求]。

在「目的地」分支中，選擇要在檢閱程式碼之後將其合併到的分支。

在 S ource 分支中，選擇包含您剛剛提交到test_endpoint.py文件的更改的分支。

在提取請求標題中，輸入一個標題，以幫助其他用戶了解需要審查的內容以及原因。

在提取請求說明中，選擇為我寫入說明，讓 Amazon Q 為提取請求中包含的變更建立說明。

這時系統顯示「變更」的摘要。檢閱建議的文字，然後選擇「接受」並新增至說明。

或者，您也可以修改摘要，以更好地反映您對程式碼所做的變更。您也可以選擇將審核者或連結問題新增至此提取請求。當您完成所需的其他變更之後，請選擇 [建立]。

導覽至您在上一個程序中建立的提取請求。

如果提取請求尚未有註解，請在「變更」中新增一些註解至提取要求。

在概觀中，選擇建立注釋摘要。完成後，「註解摘要」區段會展開。

檢閱提取請求修訂版本中程式碼變更所留下的註解摘要，並將其與提取請求中的註解進行比較。

在導覽窗格中，選擇 [問題]，並確定您在 [看板] 檢視中。

選擇 [建立問題]。

為問題提供一個標題，以簡單的語言解釋您想要執行的操作。例如，針對此問題，請輸入的標題Create another mysfit named Quokkapus。在說明中，提供下列詳細資訊：

Expand the table of mysfits to 13, and give the new mysfit the following characteristics:

Name: Quokkapus

Species: Quokka-Octopus hybrid

Good/Evil: Good

Lawful/Chaotic: Chaotic

Age: 216

Description: Australia is full of amazing marsupials, but there's nothing there quite like the Quokkapus. 
She's always got a friendly smile on her face, especially when she's using her eight limbs to wrap you up 
in a great big hug. She exists on a diet of code bugs and caffeine. If you've got some gnarly code that needsa
assistance, adopt Quokkapus and put her to work - she'll love it! Just make sure you leave enough room for 
her to grow, and keep that coffee coming.

(選擇性) 附加影像以用作問題 mysfit 的縮圖和個人檔案圖片。如果您這麼做，請更新說明以包含您要使用的影像和原因的詳細資料。例如，您可以在說明中添加以下內容：「mysfit 需要將圖像文件部署到網站上。將這些附加到此問題的圖像添加到源存儲庫作為工作的一部分，並將圖像部署到網站。」

請檢閱說明，並確定其中包含所有可能需要的詳細資料，然後再繼續進行下一個步驟。

在受指派人中，選擇指派給 Amazon Q。

在來源儲存庫中，選擇包含專案程式碼的來源儲存庫。

在每個步驟之後滑動「需要 Amazon Q 停止」，並在必要時等待其工作選擇器的審核到使用中狀態。

將允許 Amazon Q 修改工作流程檔案選擇器保留為非使用中狀態。

將允許 Amazon Q 建議建議建立任務選擇器滑動到使用中狀態。

選擇 [建立問題]。您的檢視會變更為「問題」看板。

選擇創建問題以創建另一個問題，這次是標題Change the get_all_mysfits() API to return mysfits sorted by the Age attribute。將此問題指派給 Amazon Q 並建立問題。

選擇創建問題以創建另一個問題，這次是標題Update the OnPullRequest workflow to include a branch named test in its triggers。選擇性地連結至描述中的工作流程。將此問題指派給 Amazon Q，但這次請確保將允許 Amazon Q 修改工作流程檔案選取器設定為使用中狀態。建立問題以返回「問題」看板。

在「問題」中，選擇指派給正在進行中的 Amazon Q 的問題。檢閱註解以監控 Amazon Q 的進度 (如果存在)，請檢閱背景並在問題說明中記錄。如果您選擇允許 Amazon Q 提出任務建議，請檢閱任何提議的任務並採取任何必要的動作。例如，如果 Amazon Q 建議了任務，而您想要變更順序或將任務指派給特定使用者，請選擇變更、新增或重新排序任務，然後執行任何必要的更新。檢視完問題後，請選擇 [X] 關閉問題窗格。

現在選擇一個指派給 Amazon Q 的問題正在審查中。審查背景和接近它記錄在問題的描述。檢閱註解以瞭解其執行的動作。檢閱針對此問題相關之工作建立的任何工作，包括其進度、您可能需要採取的任何動作，以及任何註解。在 [提取要求] 中，選擇 [開啟] 標籤旁的提取要求連結，以檢閱程式碼。

在提取請求中，檢閱程式碼變更。如需詳細資訊，請參閱 檢閱提取請求。如果您希望 Amazon Q 變更任何建議的程式碼，請在提取請求上留下註解。為 Amazon Q 留下評論以獲得最佳效果時，請特別注意。

例如，當您檢閱針對建立的提取要求時Create another mysfit named Quokkapus，您可能會注意到說明中有錯字。您可以為 Amazon Q 發表評論，該評論指出「通過在「需求」和「a」之間添加空格來更改描述以修復錯字「needsa」。 或者，您可以發表評論，告訴 Amazon Q 更新說明，並提供整個修改後的說明供其合併。

如果您將新 mysfit 的圖像上傳到網站上，則可以為 Amazon Q 發表評論，以使用指向圖像和縮略圖的指針更新 mysfit 以用於新的 mysfit。

(選擇性) 在您和其他專案使用者保留所有您想要變更程式碼的註解之後，請選擇 [建立修訂]，讓 Amazon Q 建立提取請求的修訂版，以納入您在註解中請求的變更。Amazon Q 將在概觀中報告修訂建立進度的進度，而不是在變更中報告。請務必重新整理瀏覽器，以檢視 Amazon Q 有關建立修訂的最新更新。

此範例專案中的每個提取要求都會執行工作流程。在合併提取請求之前，請確定工作流程已成功執行。您也可以選擇建立其他工作流程和環境，以便在合併程式碼之前測試程式碼。如需詳細資訊，請參閱 工作流程入門。

當您滿意提取請求的最新版次時，請選擇「合併」。

在導覽窗格中，選擇 [問題]，並確定您在 [看板] 檢視中。

選擇 [建立問題]。

為問題提供一個標題，以簡單的語言解釋您想要執行的操作。例如，針對此問題，請輸入的標題Change the get_all_mysfits() API to return mysfits sorted by the Good/Evil attribute。在說明中，提供下列詳細資訊：

Update the API to allow sorting of mysfits by whether they are Good, Neutral, or Evil. Add a button on the website that allows users to quickly choose this sort and to exclude alignments that they don't want to see.

請檢閱說明，並確定其中包含所有可能需要的詳細資料，然後再繼續進行下一個步驟。

在「受指派人」中，選擇將問題指派給您自己。

選擇 [建立問題]。您的檢視會變更為「問題」看板。

選擇您剛剛創建的問題以打開它。選擇 [建議工作]。

選擇包含 issuse 程式碼的來源儲存庫。選擇 [開始建議工作]。