为用户设置 Amazon Q 开发者版

Amazon Q 开发者版是一款生成式人工智能对话助理。您可以在新域或现有域中设置 Amazon Q 开发者版。使用以下信息设置 Amazon Q 开发者版。

通过 Amazon Q 开发者版，您的用户可以

• 获取有关独立使用 SageMaker 人工智能功能或与其他 AWS 服务结合使用人工智能功能的 step-by-step指导。

• 获取示例代码以开始执行机器学习任务，例如数据准备、训练、推理和 MLOps。

• 获得故障排除帮助，以调试和解决运行代码时遇到的错误。

注意

Studio 中的 Amazon Q 开发者版不会使用用户内容来改进服务，无论您使用的是免费订阅还是专业订阅。对于 IDE 级别的遥测共享，Amazon Q 可能会跟踪用户的使用情况，例如提问的数量以及推荐是否被接受或拒绝。这些遥测数据不包括个人身份信息，如用户的 IP 地址。有关数据保护的更多信息和选择退出的说明，请参阅选择退出 IDE 中的数据共享。

您可以使用专业版或免费版订阅设置 Amazon Q 开发者版。专业级是付费订阅服务，具有更高的使用限制和其他功能。有关层级之间差异的详细信息，请参阅了解 Amazon Q 开发者版的服务层级。

重要

基于代码操作系统的代码编辑器，Visual Studio Code-Open Source 仅支持使用免费套餐订阅。

有关订阅 Amazon Q 开发者版专业套餐的信息，请参阅订阅 Amazon Q 开发者版专业套餐。

Amazon Q 开发者版免费套餐的设置说明：

要设置 Amazon Q 开发者免费套餐，请按以下步骤操作：

设置 Amazon Q 开发者版免费套餐

1. 将以下策略添加到您用于创建 JupyterLab 或代码编辑器空间的 IAM 角色中：

   {
   	"Version": "2012-10-17",
   	"Statement": [
   		{
   			"Effect": "Allow",
   			"Action": [
   				"q:SendMessage"
   			],
   			"Resource": [
   				"*"
   			]
   		},
   		{
   			"Sid": "AmazonQDeveloperPermissions",
   			"Effect": "Allow",
   			"Action": [
   				"codewhisperer:GenerateRecommendations"
   			],
   			"Resource": "*"
   		}
   	]
   }
                              

2. 导航至 Amazon SageMaker Studio。

3. 打开您的 JupyterLab 或代码编辑器空间。

4. 导航至启动器并选择终端。

5. 在中 JupyterLab，执行以下操作：

   1. 指定 restart-jupyter-server。

   2. 重启浏览器并返回亚马逊 SageMaker Studio。

Amazon Q 开发者版免费套餐的设置说明：

要设置 Amazon Q 开发者免费套餐，请按以下步骤操作：

设置 Amazon Q 开发者版免费套餐

1. 将以下策略添加到您用于创建 JupyterLab 或代码编辑器空间的 IAM 角色中：

   {
   	"Version": "2012-10-17",
   	"Statement": [
   		{
   			"Effect": "Allow",
   			"Action": [
   				"q:SendMessage"
   			],
   			"Resource": [
   				"*"
   			]
   		},
   		{
   			"Sid": "AmazonQDeveloperPermissions",
   			"Effect": "Allow",
   			"Action": [
   				"codewhisperer:GenerateRecommendations"
   			],
   			"Resource": "*"
   		}
   	]
   }
                              

2. 导航至 Amazon SageMaker Studio。

3. 打开您的 JupyterLab 或代码编辑器空间。

4. 导航至启动器并选择终端。

5. 在中 JupyterLab，执行以下操作：

   1. 指定 restart-jupyter-server。

   2. 重启浏览器并返回亚马逊 SageMaker Studio。

Amazon Q 开发者版专业套餐层级的设置说明：

先决条件

要设置 Amazon Q Pro，您必须具备：

• 为您的组织设置的 Amazon A SageMaker I 域，将 IAM 身份中心配置为访问方式。

• Amazon Q 开发者版专业套餐订阅。

如果您要更新已为组织设置的域，则需要更新该域以使用 Amazon Q 开发者版。您可以使用 AWS Management Console 或 AWS Command Line Interface 来更新域。

您必须使用 Amazon Q 开发者版配置文件的 ARN。您可以在 Q 开发者版设置页面找到 Q 配置文件 ARN。

您可以使用以下 AWS Command Line Interface 命令来更新您的域名：

aws --region AWS 区域 sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=ENABLED,QProfileArn=Q-Profile-ARN}"           
        

您也可以使用以下步骤更新 AWS Management Console中的域。

1. 导航到亚马逊 A SageMaker I 控制台。

2. 选择域。

3. 选择应用程序配置。

4. 对于适用于 Amazon Q SageMaker AI 应用程序的开发者，请选择编辑。

5. 选择在此域启用 Amazon Q 开发者版。

6. 提供 Q 配置文件 ARN。

7. 选择提交。

您必须使用 Amazon Q 开发者版配置文件的 ARN。您可以在 Amazon Q 开发者版管理控制台的 Amazon Q 账户详情页面上找到 Q 配置文件的 ARN。

组织设置是 Amazon A SageMaker I 域的高级设置，允许您使用 IAM 身份中心。有关如何设置域以及设置 IAM Identity Center 的信息，请参阅 使用 Amazon A SageMaker I 的自定义设置。

在新域中设置 Amazon Q Developer 时，您可以在本地计算机上使用 AWS Management Console 或以下 AWS Command Line Interface 命令：

                    
aws --region AWS 区域 sagemaker create-domain --domain-id domain-id --domain-name "example-domain-name" --vpc-id example-vpc-id --subnet-ids example-subnet-ids --auth-mode SSO --default-user-settings "ExecutionRole=arn:aws:iam::111122223333:role/IAM-role",--domain-settings "AmazonQSettings={status=ENABLED,qProfileArn=Q-profile-ARN" --query example-domain-ARN--output text           
        
                

您可以使用以下 AWS CLI 命令禁用 Amazon Q Developer：

aws --region AWS 区域 sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=DISABLED,QProfileArn=Q-Profile-ARN}"           
        

Amazon Q 开发者版专业套餐层级的设置说明：

先决条件

要设置 Amazon Q Pro，您必须具备：

• 为您的组织设置的 Amazon A SageMaker I 域，将 IAM 身份中心配置为访问方式。

• Amazon Q 开发者版专业套餐订阅。

如果您要更新已为组织设置的域，则需要更新该域以使用 Amazon Q 开发者版。您可以使用 AWS Management Console 或 AWS Command Line Interface 来更新域。

您必须使用 Amazon Q 开发者版配置文件的 ARN。您可以在 Q 开发者版设置页面找到 Q 配置文件 ARN。

您可以使用以下 AWS Command Line Interface 命令来更新您的域名：

aws --region AWS 区域 sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=ENABLED,QProfileArn=Q-Profile-ARN}"           
        

您也可以使用以下步骤更新 AWS Management Console中的域。

1. 导航到亚马逊 A SageMaker I 控制台。

2. 选择域。

3. 选择应用程序配置。

4. 对于适用于 Amazon Q SageMaker AI 应用程序的开发者，请选择编辑。

5. 选择在此域启用 Amazon Q 开发者版。

6. 提供 Q 配置文件 ARN。

7. 选择提交。

您必须使用 Amazon Q 开发者版配置文件的 ARN。您可以在 Amazon Q 开发者版管理控制台的 Amazon Q 账户详情页面上找到 Q 配置文件的 ARN。

组织设置是 Amazon A SageMaker I 域的高级设置，允许您使用 IAM 身份中心。有关如何设置域以及设置 IAM Identity Center 的信息，请参阅 使用 Amazon A SageMaker I 的自定义设置。

在新域中设置 Amazon Q Developer 时，您可以在本地计算机上使用 AWS Management Console 或以下 AWS Command Line Interface 命令：

                    
aws --region AWS 区域 sagemaker create-domain --domain-id domain-id --domain-name "example-domain-name" --vpc-id example-vpc-id --subnet-ids example-subnet-ids --auth-mode SSO --default-user-settings "ExecutionRole=arn:aws:iam::111122223333:role/IAM-role",--domain-settings "AmazonQSettings={status=ENABLED,qProfileArn=Q-profile-ARN" --query example-domain-ARN--output text           
        
                

您可以使用以下 AWS CLI 命令禁用 Amazon Q Developer：

aws --region AWS 区域 sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=DISABLED,QProfileArn=Q-Profile-ARN}"           
        

您可以在新域或现有域中设置 Amazon Q 开发者版。使用以下信息设置 Amazon Q 开发者版。

我们建议使用最新版本的 AWS Command Line Interface。有关更新的信息 AWS CLI，请参阅安装或更新到最新版本的 AWS Command Line Interface。

如果您需要在 Amazon Q 开发者版和您的 VPC 之间建立连接，请参阅为 Amazon Q 创建接口 VPC 端点。

注意

Amazon Q 开发者版有以下限制：

• 它不支持共享空间。

• Amazon Q Developer 会检测代码建议是否与公开可用的代码过于相似。参考跟踪器可以用存储库 URLs 和许可证标记建议，也可以将其过滤掉。这样，您就可以在采用参考代码之前审查其用法。所有引用都会被记录下来，供您稍后查看，以确保您的代码流程不受干扰，您可以不受干扰地继续编码。

  有关代码参考的更多信息，请参阅使用代码引用-Amazon Q 开发人员和 A I 编码助手-Amazon Q 开发人员 FAQs。

• Amazon Q 处理美国东部（弗吉尼亚州北部） AWS 区域内的所有用户交互数据。有关 Amazon Q 如何处理数据及其支持的 AWS 区域 的详细信息，请参阅支持 Amazon Q 开发者版的区域。

• 亚马逊 Q 仅适用于亚马逊 SageMaker Studio。Amazon SageMaker Studio Classic 不支持该功能。

• 开启 JupyterLab后，Amazon Q 可在 SageMaker AI 分发映像版本 2.0 及更高版本中运行。在代码编辑器上，Amazon Q 在 SageMaker AI 分发映像版本 2.2.1 及更高版本中运行。

• 亚马逊 Q 开发者在 Jupyter 人工智能扩展中 JupyterLab 工作。使用 Amazon Q 时，您不能在扩展程序内使用其他 3P 模型。