Amazon CodeWhisperer 的使用指南

### 一、Amazon CodeWhisperer文档 [Amazon CodeWhisperer](https://aws.amazon.com/cn/codewhisperer/?trk=cndc-detail) 是一项基于[机器学习](https://aws.amazon.com/cn/machine-learning/?trk=cndc-detail)的服务，其根据自然语言注释和集成开发环境（IDE）中的代码，生成代码建议，帮助提高开发者生产力。 为启动、开发以及通过 Visual Studio Code、JetBrains、Amazon Cloud9、以及 Amazon Lambda 而使用 [Amazon CodeWhisperer](https://aws.amazon.com/cn/codewhisperer/?trk=cndc-detail) 提供详细的信息和说明。 ### 二、为管理员设置 Amazon CodeWhisperer 本节内容描述了开发者在使用 CodeWhisperer 专业版之前必须完成的设置步骤。 这种情况下，专业开发者指的是在拥有亚马逊云科技账户的公司（企业）就职的开发者。 以下汇总了本页所描述的步骤。如果您是普通的亚马逊云科技用户，您可能已经完成了一个或多个与另一项亚马逊云科技服务相关的此类步骤。 - 根用户由您的亚马逊云科技账户内置。 - 根用户为IAM Identity Center 管理员创建权限集。 - 根用户为账户管理员添加该权限集。 - 账户管理员添加用户。 - 账户管理员授权 CodeWhisperer 管理员对 CodeWhisperer 进行管理。 - CodeWhisperer 管理员授权企业开发者使用 CodeWhisperer。 关于可能使用 [CodeWhisperer 的不同角色](https://docs.aws.amazon.com/codewhisperer/latest/userguide/user-types.html?trk=cndc-detail)的更多信息，请参见 [Types of users for CodeWhisperer](https://docs.aws.amazon.com/codewhisperer/latest/userguide/user-types.html?trk=cndc-detail)。 ### 三、使用 VS Code 和 JetBrains - 为专业开发者设置 CodeWhisperer - 为个人开发者设置 CodeWhisperer - 使用 CodeWhisperer 和 Amazon Toolkit 进行认证 ### 利用 Amazon Cloud9 设置 CodeWhisperer 面向 Amazon Cloud9 的 Amazon Identity and Access Management 权限 为了让 CodeWhisperer 在 Amazon Cloud9 控制台中提供建议，您必须为您的 IAM 用户或角色启用正确的 IAM 权限。如以下 IAM 策略示例所述，您必须添加 codewhisperer:GenerateRecommendations 权限： ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "CodeWhispererPermissions", "Effect": "Allow", "Action": ["codewhisperer:GenerateRecommendations"], "Resource": "*" } ] } ``` 最好是使用 IAM 策略向 IAM 主体授予限制性权限。关于面向 Amazon Cloud9 使用 IAM 的详细信息，请参见 Amazon Cloud9 用户指南中的 [Identity and access management in AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/security-iam.html?trk=cndc-detail) 部分内容。 ##### 使用 Amazon Cloud9 激活 Amazon CodeWhisperer 要在 Amazon Cloud9 控制台代码编辑器中激活 CodeWhisperer，请完成以下步骤。 1、在您现有的 Amazon Cloud9 环境中，选择窗口左侧边缘的亚马逊云科技标志。将向右展开一个面板。 2、在该面板的下半部，Developer tools 的下方，打开 CodeWhisperer 下拉菜单。 3、选择 Enable CodeWhisperer。 首次激活 CodeWhisperer 时，会出现一个弹出窗口，其中包含关于使用 CodeWhisperer 的条款和条件。请阅读这些条款和条件，并选择 Accept 继续操作。 ##### 在 Amazon Cloud9 中激活 CodeWhisperer 在您访问 Amazon Cloud9 后，需要激活 CodeWhisperer。 1、在 Amazon Cloud9 中，从 Amazon Cloud9 侧边栏选择 aws-explorer。 2、从 Developer Tools 导航窗格中，选择 CodeWhisperer（预览版）。 3、选择 Enable CodeWhisperer，接受服务条款并在 Amazon Cloud9 中激活 CodeWhisperer。 ### 五、使用 Lambda 设置 Amazon CodeWhisperer 本文档描述了如何为 Lambda 控制台设置和激活 [Amazon CodeWhisperer](https://aws.amazon.com/cn/codewhisperer/?trk=cndc-detail)。激活后，CodeWhisperer 可以在您开发相关功能时在 Lambda 代码编辑器中按需生成代码建议。 在 Lambda 控制台中，CodeWhisperer 仅支持使用 Python 和 Node.js 运行时的函数。 ##### 面向 Lambda 的 Amazon Identity and Access Management 权限 为了让 CodeWhisperer 在 Lambda 控制台中提供建议，您必须为您的 IAM 用户或角色启用正确的 IAM 权限。如以下 IAM 策略示例所述，您必须添加 codewhisperer:GenerateRecommendations 权限： ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "CodeWhispererPermissions", "Effect": "Allow", "Action": ["codewhisperer:GenerateRecommendations"], "Resource": "*" } ] } ``` 最好是使用 IAM 策略向IAM主体授予限制性权限。关于面向 Amazon Cloud9 使用 IAM 的详细信息，请参见 Amazon Cloud9 用户指南中的 Identity and access management in [AWS Cloud9](https://aws.amazon.com/cn/cloud9/?trk=cndc-detail) 部分内容。 ##### 使用 Lambda 激活 Amazon CodeWhisperer 要在 Lambda 控制台代码编辑器中激活 CodeWhisperer，请完成以下步骤。 1、打开 Lambda 的Functions page，选择您想要编辑的函数。\ 2、在 Code source 下方的代码编辑器中，选择顶部菜单栏中的 Tools。\ 3、选择 CodeWhisperer code suggestions。这将立即激活 CodeWhisperer 服务，且在该选项旁会出现一个勾选标记。如要停用服务，请再次勾选该选项。 首次激活 CodeWhisperer 时，会出现一个弹出窗口，其中包含关于使用 CodeWhisperer 的条款和条件。请阅读这些条款和条件，并选择 Accept 继续操作。