为您的用户设置 Amazon Q 开发者 - Amazon SageMaker

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

为您的用户设置 Amazon Q 开发者

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

借助 Amazon Q Developer，您的用户可以：

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

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

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

注意

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

您可以通过专业版或免费版订阅来设置 Amazon Q Developer。专业版是一项付费订阅服务，具有更高的使用限制和其他功能。有关不同等级之间差异的更多信息，请参阅了解 Amazon Q Developer 的服务等级。

有关订阅 Amazon Q Developer Pro 的信息，请参阅订阅 Amazon Q Developer Pro。

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

设置 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. 指定 restart-jupyter-server。

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

先决条件

要在其中设置 Amazon Q Pro JupyterLab，您必须具备：

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

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

如果您要更新已为组织设置的域名，则需要将其更新为使用 Amazon Q Developer。您可以使用 AWS Management Console 或 AWS Command Line Interface 来更新域。

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

您可以使用以下 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. 导航至 Amazon SageMaker 控制台。

  2. 选择域名。

  3. 选择 “应用程序配置”。

  4. 对于 Amazon Q SageMaker 应用程序开发人员，请选择编辑。

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

  6. 提供 Q 配置文件ARN。

  7. 选择提交。

您必须使用您的 ARN Amazon Q 开发者个人资料。您可以在 Amazon Q 开发者控制台的 Amazon Q 账户详情页面上找到 Q 个人资料。ARN

“为组织设置” 是 Amazon SageMaker 域的高级设置，允许您使用 Ident IAM ity Center。有关如何设置域的信息以及有关设置 Ident IAM ity Center 的信息，请参阅使用适用于 Amazon 的自定义设置 SageMaker。

在新域中设置 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 Developer。使用以下信息设置 Amazon Q 开发者。

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

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

注意

Amazon Q 开发者有以下限制：

  • 它不支持共享空间。

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

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

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

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

  • Amazon Q 适用于 SageMaker 分发映像版本 2.0 及更高版本。

  • Amazon Q 在 Jupyter 人工智能扩展中运行。在使用 Amazon Q 时，您不能在扩展程序中使用其他 3P 机型。