本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 为用户设置 Amazon Q 开发者版
Amazon Q 开发者版是一款生成式人工智能对话助理。您可以在新域或现有域中设置 Amazon Q 开发者版。使用以下信息设置 Amazon Q 开发者版。
通过 Amazon Q 开发者版，您的用户可以
+ 获取有关独立使用 SageMaker 人工智能功能或与其他 AWS 服务结合使用人工智能功能的 step-by-step指导。
+ 获取示例代码以开始执行机器学习任务，例如数据准备、训练、推理和 MLOps。
+ 接受故障排除帮助，以调试和解决运行代码时遇到的错误。
**注意**
Studio 中的 Amazon Q 开发者版不会使用用户内容来改进服务，无论您使用的是免费订阅还是专业订阅。对于 IDE 级别的遥测共享，Amazon Q 可能会跟踪用户的使用情况，例如提问的数量以及推荐是否被接受或拒绝。这些遥测数据不包括个人身份信息，如用户的 IP 地址。有关数据保护的更多信息和选择退出的说明，请参阅[选择退出 IDE 中的数据共享](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/opt-out-IDE.html)。
您可以使用专业版或免费版订阅设置 Amazon Q 开发者版。专业级是付费订阅服务，具有更高的使用限制和其他功能。有关层级之间差异的详细信息，请参阅[了解 Amazon Q 开发者版的服务层级](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-tiers.html)。
有关订阅 Amazon Q 开发者版专业套餐的信息，请参阅[订阅 Amazon Q 开发者版专业套餐](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-admin-setup-subscribe-general.html)。
## 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": "*"
}
]
}
```
------
1. 导航至 Amazon SageMaker Studio。
1. 打开您的 JupyterLab 或代码编辑器空间。
1. 导航至**启动器**并选择**终端**。
1. 在中 JupyterLab，执行以下操作：
1. 指定 `restart-jupyter-server`。
1. 重启浏览器并返回亚马逊 SageMaker Studio。
## Amazon Q 开发者版专业套餐层级的设置说明：
**先决条件**
要设置 Amazon Q Pro，您必须具备以下条件：
为您的组织设置的 Amazon A SageMaker I 域，将 IAM 身份中心配置为访问方式。
Amazon Q 开发者版专业套餐订阅。
如果您要更新已为组织设置的域，则需要更新该域以使用 Amazon Q 开发者版。您可以使用 AWS 管理控制台 或 AWS Command Line Interface 来更新域。
您必须使用 Amazon Q 开发者版配置文件的 ARN。您可以在 [Q 开发者版设置](https://console.aws.amazon.com/amazonq/developer/settings)页面找到 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. 导航到[亚马逊 A SageMaker I](https://console.aws.amazon.com/sagemaker) 控制台。
1. 选择域。
1. 选择**应用程序配置**。
1. 对于适用于 **Amazon Q SageMaker AI 应用程序的开发者**，请选择**编辑**。
1. 选择**在此域启用 Amazon Q 开发者版**。
1. 提供 Q 配置文件 ARN。
1. 选择**提交**。
您必须使用 Amazon Q 开发者版配置文件的 ARN。您可以在 [Amazon Q 开发者版](https://console.aws.amazon.com/amazonq/developer)管理控制台的 **Amazon Q 账户详情**页面上找到 Q 配置文件的 ARN。
**组织设置**是 Amazon A SageMaker I 域的高级设置，允许您使用 IAM 身份中心。有关如何设置域以及设置 IAM Identity Center 的信息，请参阅 [使用 Amazon A SageMaker I 的自定义设置](onboard-custom.md)。
在新域中设置 Amazon Q Developer 时，您可以在本地计算机上使用 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 Developer：
```
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](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。
如果您需要在 Amazon Q 开发者版和您的 VPC 之间建立连接，请参阅[为 Amazon Q 创建接口 VPC 端点](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/vpc-interface-endpoints.html#vpc-endpoint-create)。
**注意**
Amazon Q 开发者版有以下限制：
它不支持共享空间。
Amazon Q 开发者版可检测代码建议是否与公开代码过于相似。参考跟踪器可以用存储库 URLs 和许可证标记建议，也可以将其过滤掉。这样，您就可以在采用参考代码之前审查其用法。所有引用都会被记录下来，供您稍后查看，以确保您的代码流程不受干扰，您可以不受干扰地继续编码。
有关代码参考的更多信息，请参阅[使用代码引用-Amazon Q 开发人员](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/code-reference.html)和 A [I 编码助手-Amazon Q 开发人员 FAQs](https://aws.amazon.com/q/developer/faqs/?refid=255ccf7b-4a76-4dcb-9b07-68709e2b636b#:~:text=Can%20I%20prevent%20Amazon%20Q%20Developer%20from%20recommending%20code%20with%20code%20references%3F)。
Amazon Q 处理美国东部（弗吉尼亚州北部） AWS 区域内的所有用户交互数据。有关 Amazon Q 如何处理数据及其支持的 AWS 区域 的详细信息，请参阅[支持 Amazon Q 开发者版的区域](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/regions.html)。
亚马逊 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 模型。
## Amazon Q 中的自定义设置 Amazon SageMaker AI
如果您使用 Amazon Q 开发者版专业套餐，则可以选择创建*自定义项*。通过自定义项，Amazon Q 开发者版能够基于贵公司的代码库提供建议。如果您在 Amazon Q Developer 中创建自定义项，则这些自定义项将可供您在 Amazon SageMaker Studio 的代码编辑 JupyterLab 器和代码编辑器中使用。有关设置自定义项的更多信息，请参阅《Amazon Q 开发者版用户指南》**中的[自定义建议](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/customizations.html)。