本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # Amazon Q 开发者版 Amazon Q 开发者版是一款生成式人工智能对话助手，可帮助您编写更优质的代码。亚马逊 Q 开发者在 Amazon SageMaker Studio 中提供以下 IDEs 版本： + JupyterLab + 基于 Code-OSS（Visual Studio Code 的开源版本）的代码编辑器 使用以下部分设置 Amazon Q 开发者版，并在您的环境中使用它。 **Topics** + [为用户设置 Amazon Q 开发者版](studio-updated-amazon-q-admin-guide-set-up.md) + [使用 Amazon Q 加快机器学习工作流程](studio-updated-user-guide-use-amazon-q.md) + [在亚马逊 SageMaker Studio 应用程序中自定义 Amazon Q 开发者](q-customizations.md) # 为用户设置 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)。 # 使用 Amazon Q 加快机器学习工作流程 Amazon Q 开发者版是您进行机器学习开发的人工智能驱动工具。使用 Amazon Q 开发者版，您可以： + 获取有关独立使用 SageMaker 人工智能功能或与其他 AWS 服务结合使用人工智能功能的 step-by-step指导。 + 获取示例代码以开始执行机器学习任务，例如数据准备、训练、推理和 MLOps。 要使用 Amazon Q Develop **er**，请从您的 JupyterLab 或代码编辑器环境的左侧导航栏中选择 Q。 如果您没有看到 **Q** 图标，则需要管理员为您设置。有关设置 Amazon Q 开发者版的更多信息，请参阅 [为用户设置 Amazon Q 开发者版](studio-updated-amazon-q-admin-guide-set-up.md)。 Amazon Q 会自动提供建议，帮助您编写代码。您还可以通过聊天界面征求建议。 # 在亚马逊 SageMaker Studio 应用程序中自定义 Amazon Q 开发者 您可以在亚马逊 SageMaker 工作室的代码编辑器应用程序中自定义 Amazon Q Developer。 JupyterLab 当您自定义 Q 开发者版时，它会根据代码库中的示例提供建议和解答。如果您使用 Amazon Q 开发者版专业套餐，则可以加载您使用该服务创建的任何自定义项。 ## 在中自定义 JupyterLab 在中 JupyterLab，您可以加载使用 Amazon Q Developer Pro 创建的任何自定义项。或者，在您的 JupyterLab 空间中，您可以使用上传到空间的文件在本地自定义 Q Developer。 ### 使用您在 Amazon Q 开发者版专业套餐中创建的自定义项 在加载自定义项时，Q 开发者版会根据您用于创建自定义项的代码库提供建议。此外，当您在 **Amazon Q** 面板中使用聊天功能时，将与自定义项进行交互。 有关设置自定义项的更多信息，请参阅《Amazon Q 开发者版用户指南》**中的[自定义建议](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/customizations.html)。 **加载您的自定义项** 打开您的 JupyterLab 空间并完成以下步骤。 1. 在底部的状态栏中 JupyterLab，选择 **Amazon Q**。 将打开一个菜单。 1. 在该菜单中，选择**其他功能**。这将在主工作区中打开**Amazon Q 功能**选项卡。 1. 在 **Amazon Q 功能**选项卡中，在**选择自定义项**下，选择 Q 开发者版自定义项。 1. 通过以下任一方式与自定义项进行交互： + 创建一个笔记本，并在其中编写代码。在您执行此操作时，Q 开发者版会根据您的自定义项，自动提供定制的内联建议。 + 按照以下步骤操作，在 **Amazon Q** 面板中与 Q 开发者版进行交互： 1. 在的左侧边栏中 JupyterLab，选择 **Jupyter 人工智能聊天图标**。这将打开 **Amazon Q** 面板。 1. 使用**询问 Amazon Q** 聊天框与自定义项进行交互。 ### 使用您 JupyterLab 空间中的文件自定义 Amazon Q Developer 在中 JupyterLab，您可以使用上传到空间的文件自定义 Q Developer。然后，在 **Amazon Q** 面板的聊天中，您可以使用一条命令向 Q 开发者版询问有关这些文件的问题。 当您使用空间中的文件自定义 Q 开发者版时，自定义项仅存在于您的空间中。您无法将自定义项加载到其他位置，例如在其他空间或 Amazon Q 开发者版控制台中。 JupyterLab 如果您使用免费套餐的 Amazon Q Developer Pro 或 Amazon Q Developer，则可以使用中的文件自定义 Q Developer。 **使用您的文件进行自定义** 打开您的 JupyterLab 空间并完成以下步骤。 1. 检查您的空间是否配置了所需的嵌入模型。 JupyterLab 只有在使用默认嵌入模型（即**CodeSage :: codesage-small）时，才能在中自定义 Q Develo** per。要进行检查，请执行以下操作： 1. 在的左侧边栏中 JupyterLab，选择 **Jupyter 人工智能聊天图标**。这将打开 **Amazon Q** 面板。 1. 选择面板右上角的设置图标。 1. **对于**嵌入模型**，如有必要，请选择**CodeSage :: codesage-small**，然后选择保存更改。** 1. 在面板的右上角，选择返回图标。 1. 要上传要用来自定义 Q 开发者版的文件，请在**文件浏览器**面板中选择**上传文件**图标。 1. 上传文件后，在**询问 Amazon Q** 聊天框中键入 `/learn file path/`。将*文件路径/* 替换为 JupyterLab 空间中文件的路径。在 Amazon Q 处理完文件后，它会在 Amazon Q 面板中显示一条聊天消息以进行确认。 1. 要向 Q 开发者版询问有关文件的问题，请在聊天框中键入 `/ask`，然后在命令后附上您的问题。Amazon Q 会根据您的文件生成答案，并在聊天中进行回复。 有关 `/learn` 和 `/ask` 命令的更多信息（例如，其选项和支持的参数），请参阅 Jupyter AI 用户文档中的[了解本地数据](https://jupyter-ai.readthedocs.io/en/latest/users/index.html#learning-about-local-data)。该页面说明了如何在 Jupyternaut AI 聊天机器人上使用这些命令。 JupyterLab在 Amazon SageMaker Studio 中支持相同的命令语法。 ## 在代码编辑器中进行自定义 如果您已在 Amazon Q 开发者版专业套餐中创建一个自定义项，则可在代码编辑器中加载此自定义项。之后，当 Q 开发者版为您的代码提供建议时，这些建议会基于您用来创建自定义项的代码库。此外，当您在 **Amazon Q：聊天**面板中使用聊天功能时，将与自定义项进行交互。 **使用您在 Amazon Q 开发者版专业套餐中创建的自定义项** 打开代码编辑器空间并完成以下步骤。 1. 在“代码编辑器”菜单中，选择**视图**，然后选择**命令面板**。 1. 在命令面板中，开始键入 **>Amazon Q: Select Customization**，当所需选项出现在筛选后的命令列表中时，选中该选项。命令面板将显示您的 Q 开发者版自定义项。 1. 选择您的自定义项。 1. 通过以下任一方式与自定义项进行交互： + 创建一个 Python 文件或 Jupyter Notebook，然后在其中编写代码。在您执行此操作时，Q 开发者版会根据您的自定义项，自动提供定制的内联建议。 + 按照以下步骤操作，在 **Amazon Q** 面板中与 Q 开发者版进行交互： 1. 在代码编辑器的左侧边栏中，选择 **Amazon Q** 图标。这将打开 **Amazon Q：聊天**面板。 1. 使用该聊天框与自定义项进行交互。 有关 Q 开发者版的功能的更多信息，请参阅《Amazon Q 开发者版用户指南》**中的[在 IDE 中使用 Amazon Q 开发者版](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-in-IDE.html)。