教程：使用 CodeCatalyst 生成式人工智能功能来加快开发工作

通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

在 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 Q。生成式人工智能助手会提供建议，并概述蓝图无法满足的要求。例如，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和创建和处理分配给 Amazon Q 的事务时的最佳实践。

通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

在 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 Q。生成式人工智能助手会提供建议，并概述蓝图无法满足的要求。例如，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和创建和处理分配给 Amazon Q 的事务时的最佳实践。

在 CodeCatalyst 控制台中，导航到您的源存储库所在的项目。

从项目的源存储库列表中选择存储库的名称。或者，在导航窗格中，选择代码，然后选择源存储库。

选择要在其中创建分支的存储库。

在存储库的概述页面上，选择更多，然后选择创建分支。

输入分支的名称。

选择要从中创建分支的分支，然后选择创建。

在 mysfits 源存储库的概述页面上，选择分支下拉列表，并选择您在上一个过程中创建的分支。

在文件中，导航到要编辑的文件。例如，要编辑 test_endpoint.py 文件，请展开测试，展开 integ，然后选择 test_endpoint.py。

选择编辑。

在第 7 行，将重试所有测试的次数从：

def test_list_all(retry=3):

更改为：

def test_list_all(retry=5):

选择提交，然后将更改提交到您的分支。

在存储库的概述页面上，选择更多，然后选择创建拉取请求。

在目标分支中，在审查代码后，选择要将代码合并到的分支。

在源分支中，选择包含您刚刚提交给 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 上添加一条注释，注明“通过在‘needs’和‘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.

在继续执行下一步之前，请查看描述，并确保其中包含可能需要的所有详细信息。

在被分派人中，选择将事务分配给自己。

选择创建事务。您的视图将更改为“事务”面板。

选择您刚才创建的事务将其打开。选择建议任务。

选择包含此事务的代码的源存储库。选择开始建议任务。