创建您的自定义项 - Amazon Q 开发者版

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

创建您的自定义项

本节介绍如何使用 Amazon Q 创建自定义项。

要创建自定义项,请遵循该流程:

  1. 按照开始使用 IAM Identity Center 中的说明为用户订阅 Amazon Q 开发者版专业套餐。在订阅过程中,您将安装 Amazon Q 开发者版配置文件,这是创建自定义项所必需的。

  2. 登录到 AWS 管理控制台。

  3. 切换至 Amazon Q 开发者版控制台。

  4. 在左侧导航窗格中,选择自定义项

  5. 此时将显示自定义项页面。

  6. 选择创建自定义项

  7. 输入自定义项名称和(可选)描述。

    注意

    使用能为开发者提供信息的名称和描述。您的组织中获准使用 Amazon Q 开发者版专业套餐的开发者将能够通过 AWS 插件在 IDE 中看到这些信息。

连接到您的数据来源

在创建自定义项之前,您必须连接到包含您的代码库的数据来源。执行此操作的方式取决于您的数据来源在哪里。

如果您的数据来源位于 Github、GitLab 或 Bitbucket 中,您可以使用 AWS CodeConnections 连接到它。否则,请将您的数据放入 Amazon S3 存储桶中的文件夹中。

要了解有关 CodeConnections 的详细信息,请参阅《Developer Tools console User Guide》中的 What are connections?

通过 CodeConnections 连接到数据来源
  1. 与源提供商的连接下,选择 AWS CodeStar CodeConnections

  2. 如果您要使用现有连接,请选择选择连接

    “选择连接”下拉列表。

    然后,在选择存储库选项下,执行以下操作之一:

    • 要使用连接中的所有存储库来生成自定义项,请选择使用此连接中的所有存储库

    • 要选择特定的存储库来生成自定义项,请选择选择特定存储库,然后选择选择存储库。在弹出窗口中,找到要使用的存储库,然后选择添加

      注意

      尽管对自定义项中可以包含的存储库数量没有限制,但单独选择存储库时限制为 100 个。如果您想使用 100 个以上的存储库,请选择使用所有存储库选项,或者将存储库放在 Amazon S3 中,然后按照说明通过 Amazon S3 连接您的数据来源。

  3. 如果要创建新连接,请选择创建新连接,然后按照此过程的其余步骤进行操作。

  4. 在打开的弹出窗口中,导航到您的数据来源并按照控制台中的说明操作。

  5. 创建数据来源后,返回到创建自定义项页面。

  6. 选择连接下,从下拉列表中选择您的连接。

通过 Amazon S3 连接到数据来源
  1. 与源提供商的连接下,选择 Amazon S3。

    Amazon S3 存储桶单选按钮。
  2. 选择浏览 Amazon S3

  3. 导航到您的代码库并记下 URI。代码库必须位于 Amazon S3 存储桶中的文件夹中,而不是存储桶的根目录中。

    有关更多信息,请参阅《Amazon S3 用户指南》中的创建、配置和使用 Amazon S3 存储桶访问控制最佳实践

  4. 将 URL 粘贴到名为输入 Amazon S3 URI 的字段中。

创建自定义项之前,您可以选择向其添加标签。

有关标签的更多信息,请参阅标记您的 AWS 资源用户指南

完成上述步骤后,选择创建自定义项

自定义项和您的数据

Amazon Q 自定义项使用您的内容以贵组织开发者的风格向您提供建议。

但是,AWS 不会在不直接为您的企业服务的任何情况下存储或使用您的内容。

AWS 不会使用您的内容向其他客户提供代码建议。

Amazon Q 不会引用针对其他客户(或您)的代码审查

有关更多信息,请参阅 Amazon Q 开发者版服务改进

对自定义项的创建进行故障排除

  • 您可能收到错误:Total size of the provided repositories exceeds the maximum allowed size of number for a customization.

    在这种情况下,请从您的数据来源中移除存储库,然后重试。

  • 您可能收到错误:Insufficient data to create a customization. Add more files from supported languages and retry.

    为了将使用特定语言编写的代码用于创建自定义项,您的数据来源中必须至少有 10 个文件包含使用该特定语言的代码。您的数据来源必须包含至少 2 MB 的源代码文件,不过我们建议包含使用受支持语言的接近 20 MB、最多 20 GB 的源代码文件。

    有些文件,即使是采用相关语言,也不会计入 2 MB。例如,重复的文件和格式不受支持的文件将不计算在内。

    如果您收到此错误,请添加更多包含您的自定义重点编程语言的文件,然后重试。

  • 您可能收到错误:Encountered an issue when retrieving some of the selected repositories from CodeConnections. Check the customization's log deliveries for details.

    如果您收到此错误,请尝试使用您的连接有权访问的有效存储库再次创建或更新自定义项。