在 IDE 中安装 Amazon Q 开发者版扩展程序或插件 - Amazon Q 开发者版
支持的 IDE 版本在 Eclipse IDEs 中在 JetBrains IDEs 中在 Visual Studio Code 中在 Visual Studio 中控制台中的 IAM 委托人 AWS

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

在 IDE 中安装 Amazon Q 开发者版扩展程序或插件

要在集成式开发环境 (IDE) 中设置 Amazon Q 开发者版，请完成以下步骤。安装 Amazon Q 扩展程序或插件后，通过 IAM Identity Center 或 AWS 构建者 ID进行身份验证。通过使用建筑商 ID 进行身份验证，无需 AWS 账户即可免费使用 Amazon Q。

首先，请下载适用于您的 IDE 的 Amazon Q 扩展程序或插件：

注意

通常，通过 IAM Identity Center 进行身份验证的会话的默认持续时间为 8 小时。但是，对于 Amazon Q，默认会话持续 90 天（如果您在 2024 年 4 月 18 日或之后设置 IAM Identity Center）。有关更多信息，请参阅《AWS IAM Identity Center 用户指南》中的如何在 IDE 中延长 Amazon Q 的会话持续时间。

要登录并进行身份验证，请完成本节中的步骤。

先决条件：支持的 IDE 版本

  • Amazon Q 支持的最低 Eclipse 版本为 2024-06（4.32）。

  • Amazon Q 支持的最低版本 JetBrains IDEs （包括IntelliJ和PyCharm）是 2024.3。

  • Amazon Q 支持的最低 Visual Studio Code 版本为 1.85.0。

  • 仅 Visual Studio for Windows 受 Amazon Q 支持。支持的最低 Visual Studio 版本是 Visual Studio 2022 版本 17.7。所有 Visual Studio 2022 版本均受支持。

在 Eclipse IDEs 中进行身份验证

订阅 Amazon Q Developer Pro，您可以通过 IAM 身份中心免费进行身份验证， AWS 构建者 ID 也可以通过 IAM 身份中心进行身份验证。选择您的身份验证方法以查看开始在 Eclipse 中使用 Amazon Q 的步骤。

Builder ID

此过程不要求您拥有构建者 ID。如果您尚未注册构建者 ID，则有机会在登录过程中注册。

  1. 在 Eclipse 中安装 Amazon Q 插件。

  2. 选择 IDE 右上角的 Amazon Q 图标。

  3. IDE 底部会打开一个 Amazon Q 选项卡。在选择登录选项下，选择个人账户，然后选择继续。系统会将您重定向到浏览器。

  4. 按照浏览器中的说明使用构建者 ID 进行身份验证。验证完成后，返回 Eclipse IDE。

  5. 要开始使用 Amazon Q，选择 Amazon Q 图标以打开 Amazon Q 聊天面板。

IAM Identity Center

在开始此过程之前，您的管理员应满足以下要求：

  • 已经在 IAM Identity Center 为您创建身份

  • 已将该身份订阅到 Amazon Q 开发者版专业套餐

在您的身份订阅 Amazon Q 开发者版专业套餐后，请完成以下步骤进行身份验证：

  1. 在 Eclipse 中安装 Amazon Q 插件。

  2. 选择 IDE 右上角的 Amazon Q 图标。

  3. IDE 底部会打开一个 Amazon Q 选项卡。在选择登录选项下，选择公司账户，然后选择继续。

  4. 输入您的管理员从 Amazon Q 订阅控制台获得的起始 URL。

  5. 选择您的管理员 AWS 区域 在其中设置您的 IAM 身份中心实例的。

  6. 选择继续。系统会将您重定向到浏览器。

  7. 按照浏览器中的说明使用 IAM Identity Center 进行身份验证。验证完成后，返回 Eclipse IDE。

  8. 要开始使用 Amazon Q，选择 Amazon Q 图标以打开 Amazon Q 聊天面板。

在 JetBrains IDEs 中进行身份验证

订阅 Amazon Q Developer Pro，您可以通过 IAM 身份中心免费进行身份验证， AWS 构建者 ID 也可以通过 IAM 身份中心进行身份验证。选择您的身份验证方法以查看在 JetBrains IDE 中开始使用 Amazon Q 的步骤。

Builder ID

此过程不要求您拥有构建者 ID。如果您尚未注册构建者 ID，则有机会在登录过程中注册。

  1. 在您的 JetBrains IDE 中安装 Amazon Q 插件。

  2. 在您的 IDE 中选择 Amazon Q 图标。

    默认情况下，该图标将位于界面的一侧。

  3. 按照浏览器中的说明使用构建者 ID 进行身份验证。

  4. 要开始使用 Amazon Q，请选择 Amazon Q 图标与 Amazon Q 聊天，或者从 IDE 底部的导航栏中选择 Amazon Q。

IAM Identity Center

在开始此过程之前，您的管理员应满足以下要求：

  • 已经在 IAM Identity Center 为您创建身份

  • 已将该身份订阅到 Amazon Q 开发者版专业套餐

在您的身份订阅 Amazon Q 开发者版专业套餐后，请完成以下步骤进行身份验证：

  1. 在您的 JetBrains IDE 中安装 Amazon Q 插件。

  2. 在您的 IDE 中选择 Amazon Q 图标。

    默认情况下，该图标将位于界面的一侧。

  3. 选择公司账户。

  4. 提供管理员从 Amazon Q 订阅控制台获得的起始 URL。

  5. 提供您的管理员 AWS 区域 在其中设置您的 IAM 身份中心实例的。

  6. 选择继续。将关注点切换到您的 Web 浏览器。

  7. 按照浏览器中的说明使用 IAM Identity Center 进行身份验证，然后返回 IDE。

  8. 如果您的管理员配置了多个 Amazon Q 开发者版配置文件，您将看到自己有权访问的所有配置文件。请选择符合当前工作需求的配置文件，或管理员指示您使用的配置文件。有关配置文件的更多信息，请参阅什么是 Amazon Q 开发者版配置文件？。

    若仅存在一个可用配置文件，系统将自动选择该配置文件，您可直接开始使用 Amazon Q。

    更改 Amazon Q 开发者版配置文件，请从 IDE 底部选择 Amazon Q，然后选择更改配置文件。在出现的窗口中，选择要使用的配置文件。

  9. 要开始使用 Amazon Q，请选择 Amazon Q 图标与 Amazon Q 聊天，或者从 IDE 底部的导航栏中选择 Amazon Q。

在 Visual Studio Code 中进行身份验证

订阅 Amazon Q Developer Pro，您可以通过 IAM 身份中心免费进行身份验证， AWS 构建者 ID 也可以通过 IAM 身份中心进行身份验证。选择您的身份验证方法以查看开始在 VS Code 中使用 Amazon Q 的步骤。

Builder ID

此过程不要求您拥有构建者 ID。如果您尚未注册构建者 ID，则有机会在登录过程中注册。

  1. 在 VS Code 中安装 Amazon Q 扩展程序。

  2. 在您的 IDE 中选择 Amazon Q 图标。

    默认情况下，该图标将位于界面的一侧。

  3. 按照浏览器中的说明使用构建者 ID 进行身份验证。

  4. 要开始使用 Amazon Q，请选择 Amazon Q 图标与 Amazon Q 聊天，或者从 IDE 底部的导航栏中选择 Amazon Q。

IAM Identity Center

在开始此过程之前，您的管理员应满足以下要求：

  • 已经在 IAM Identity Center 为您创建身份

  • 已将该身份订阅到 Amazon Q 开发者版专业套餐

在您的身份订阅 Amazon Q 开发者版专业套餐后，请完成以下步骤进行身份验证：

  1. 在 VS Code 中安装 Amazon Q 扩展程序。

  2. 在您的 IDE 中选择 Amazon Q 图标。

    默认情况下，该图标将位于界面的一侧。

  3. 选择公司账户。

  4. 提供管理员从 Amazon Q 订阅控制台获得的起始 URL。

  5. 提供您的管理员 AWS 区域 在其中设置您的 IAM 身份中心实例的。

  6. 选择继续。将关注点切换到您的 Web 浏览器。

  7. 按照浏览器中的说明使用 IAM Identity Center 进行身份验证，然后返回 IDE。

  8. 如果您的管理员配置了多个 Amazon Q 开发者版配置文件，您将看到自己有权访问的所有配置文件。请选择符合当前工作需求的配置文件，或管理员指示您使用的配置文件。有关配置文件的更多信息，请参阅什么是 Amazon Q 开发者版配置文件？。

    若仅存在一个可用配置文件，系统将自动选择该配置文件，您可直接开始使用 Amazon Q。

    更改 Amazon Q 开发者版配置文件，请从 IDE 底部选择 Amazon Q，然后选择更改配置文件。在命令面板中，选择要使用的配置文件。

  9. 要开始使用 Amazon Q，请选择 Amazon Q 图标与 Amazon Q 聊天，或者从 IDE 底部的导航栏中选择 Amazon Q。

在 Visual Studio 中进行身份验证

要从 Visual Studio 的 Toolkit for Visual Studio 连接到您的 AWS 帐户，请完成以下步骤打开 AWS Toolkit 用户界面入门（连接 UI）。

  1. 在 Visual Studio 主菜单中，展开扩展程序，然后展开 AWS Toolkit。

  2. 从 AWS Toolkit 菜单选项中选择开始使用。

  3. AWS 工具包连接入门用户界面将在 Visual Studio 中打开。

订阅 Amazon Q Developer Pro，您可以通过 IAM 身份中心免费进行身份验证， AWS 构建者 ID 也可以通过 IAM 身份中心进行身份验证。选择您的身份验证方法，查看在 Visual Studio 中开始使用 Amazon Q 的步骤。

Builder ID

  1. 在 Visual Studio 中，从主菜单展开扩展程序，然后展开 AWS 工具包子菜单。

  2. 选择开始使用。开始使用选项卡将在 Visual Studio 编辑器窗口中打开。

  3. 在 Amazon Q 部分，选择启用。

  4. 在免费套餐部分，选择注册或登录按钮。

  5. 确认您要在默认 Web 浏览器中打开 AWS 授权请求门户。

  6. 按照默认 Web 浏览器中的提示进行操作。身份验证过程完成时，您会收到通知，此时便可安全关闭浏览器窗口，返回到 Visual Studio。

IAM Identity Center

  1. 在 Visual Studio 中，从主菜单展开扩展程序，然后展开 AWS 工具包子菜单。

  2. 选择开始使用。开始使用选项卡将在 Visual Studio 编辑器窗口中打开。

  3. 在 Amazon Q 部分，选择启用。您需填写“专业套餐”部分的信息以完成身份验证。

  4. 凭证配置文件由以下信息组成：配置文件名、起始 URL、配置文件区域或 SSO 区域，这些信息由您所在公司或组织的管理员提供。有关 IAM Identity Center 凭证的信息，请参阅《IAM Identity Center 用户指南》中的什么是 IAM Identity Center？。

    如果您已有凭证配置文件，在“专业套餐”面板的下拉菜单中选择该配置文件，然后选择连接。

    若要创建新的凭证配置文件，请在“专业套餐”部分填写以下字段：

    1. 在配置文件名文本框中，输入您要用于身份验证的 IAM Identity Center 的配置文件名。

    2. 在起始 URL 文本框中，输入与您的 IAM Identity Center 凭证关联的起始 URL。

    3. 从个人资料区域（默认为 us-east-1）下拉菜单中，选择 AWS 区域 由您正在进行身份验证的 IAM Identity Center 用户个人资料定义的。

    4. 从 SSO 区域（默认为 us-east-1）下拉菜单中，选择由您的 IA M 身份中心证书定义的 SSO 区域，然后选择 Connect 按钮打开使用 IAM 身份中心登录对话框。 AWS

  5. 确认您要在默认 Web 浏览器中打开 AWS 授权请求门户。

  6. 按照默认 Web 浏览器中的提示进行操作。身份验证过程完成时，您会收到通知，此时便可安全关闭浏览器窗口，返回到 Visual Studio。

  7. 将弹出登录 Amazon Q 窗口。在“凭证配置文件”下拉菜单中，选择您在之前步骤中用于进行身份验证的配置文件。

  8. 如果您的管理员配置了多个 Amazon Q 开发者版配置文件，系统会提示您从下拉菜单中选择一个 Q 开发者版配置文件。请选择符合当前工作需求的配置文件，或管理员指示您使用的配置文件。有关配置文件的更多信息，请参阅什么是 Amazon Q 开发者版配置文件？。

    若仅存在一个可用配置文件，系统将自动选择该配置文件，您可直接开始使用 Amazon Q。

    要更改您的 Amazon Q 开发者版配置文件，请从 IDE 底部选择 Amazon Q，然后选择更改 Q 开发者版配置文件。在出现的窗口中，选择要使用的配置文件。

    您也可以通过选择聊天窗口右上角的溢出菜单，然后选择更改 Q 开发者版配置文件来更改您的配置文件。

有关在 Toolkit for Visual Studio 中进行身份验证的更多信息，请参阅《AWS Toolkit for Visual Studio 用户指南》中的开始使用。

在 AWS 控制台中使用 IAM 委托人

根据您的使用方式 AWS，您可能习惯于使用您的 IAM 证书登录所有 AWS 服务的控制台。但是，您不能在 IDE 中作为 IAM 主体或通过 IAM 角色使用 Amazon Q 开发者版。您必须使用 IAM Identity Center 或构建者 ID 的凭证进行身份验证。