为用户设置 Amazon Q 开发者版 - Amazon SageMaker AI
Amazon SageMaker AI 中的 Amazon Q 自定义项

为用户设置 Amazon Q 开发者版

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

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

  • 获得关于独立使用或与其他 AWS 服务结合使用 SageMaker AI 功能的逐步指导。

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

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

注意

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

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

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

要设置 Amazon Q 开发者版免费套餐，请使用以下过程：

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

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

    JSON
    {
	"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. 重新启动浏览器并返回 Amazon SageMaker Studio。

先决条件

要设置 Amazon Q Pro，您必须具备以下条件：

  • 为贵组织设置的 Amazon SageMaker AI 域，并将 IAM Identity Center 配置为访问手段。

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

如果您要更新已为组织设置的域，则需要更新该域以使用 Amazon Q 开发者版。您可以使用 AWS 管理控制台 或 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 管理控制台 中的域。

  1. 导航到 Amazon SageMaker AI 控制台。

  2. 选择域。

  3. 选择应用程序配置。

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

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

  6. 提供 Q 配置文件 ARN。

  7. 选择提交。

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

组织设置是 Amazon SageMaker AI 域的高级设置，可让您使用 IAM Identity Center。有关如何设置域以及设置 IAM Identity Center 的信息，请参阅 为 Amazon SageMaker AI 使用自定义设置。

在新域中设置 Amazon Q 开发者版时，您可以在本地计算机上使用 AWS 管理控制台 或以下 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 开发者版：


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

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

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

注意

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

  • 它不支持共享空间。

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

    有关代码引用的更多信息，请参阅使用代码引用 - Amazon Q 开发者版和人工智能编程助手 - Amazon Q 开发者版常见问题解答。

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

  • Amazon Q 只能在 Amazon SageMaker Studio 中运行。Amazon SageMaker Studio Classic 不支持该功能。

  • 在 JupyterLab 中，Amazon Q 可在 SageMaker AI Distribution 映像版本 2.0 及更高版本中使用。在代码编辑器中，Amazon Q 可在 SageMaker AI Distribution 映像版本 2.2.1 及更高版本中使用。

  • JupyterLab 中的 Amazon Q 开发者版可在 Jupyter AI 扩展程序中运行。使用 Amazon Q 时，您不能在扩展程序内使用其他 3P 模型。

Amazon SageMaker AI 中的 Amazon Q 自定义项

如果您使用 Amazon Q 开发者版专业套餐，则可以选择创建自定义项。通过自定义项，Amazon Q 开发者版能够基于贵公司的代码库提供建议。如果您在 Amazon Q 开发者版中创建自定义项，则可在 Amazon SageMaker Studio 的 JupyterLab 和代码编辑器中使用这些自定义项。有关设置自定义项的更多信息，请参阅《Amazon Q 开发者版用户指南》中的自定义建议。