Amazon Q 定制的先决条件 - Amazon Q 开发者版
正在授权准备数据（预览）在聊天中启用自定义

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

Amazon Q 定制的先决条件

Amazon Q 自定义项建立在 Amazon Q Developer Pro 的基础上，并使用其功能。

要使用 Amazon Q 自定义设置，您必须先按照下开始使用 Amazon Q 开发者方的 Amazon Q Developer Pro 设置流程进行操作。这包括将任何用户添加到您的 Amazon Q Developer Pro 个人资料中，您也希望授予他们访问 Amazon Q 定制服务的权限。

授权您的管理员

当您使用 Amazon Q 自定义项时，必须授权您的 Amazon Q 管理员才能访问您的代码库，您可以将代码库存储在 Amazon S3 上或通过 AWS CodeConnections。 但是，在 Amazon Q Developer Pro 的标准设置过程中，您的 AWS Organizations 管理员不向 Amazon Q 管理员提供访问这些服务的权限。

注意

如果您使用 GitHub 作为数据源，则可以将使用限制在某些存储库中。请参阅《开发者工具控制台用户指南》 GitHub中的创建与的连接。

因此，在使用 Amazon Q 自定义项之前，您必须向 Amazon Q 管理员的角色添加以下权限：

注意

前codewhisperer缀是与 Amazon Q Developer 合并的服务的旧名称。有关更多信息，请参阅 Amazon Q 开发者重命名-变更摘要。

{
    "Version": "2012-10-17",
    "Statement": [{
            "Effect": "Allow",
            "Action": [
                "sso-directory:DescribeUsers"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "codewhisperer:CreateCustomization",
                "codewhisperer:DeleteCustomization",
                "codewhisperer:ListCustomizations",
                "codewhisperer:UpdateCustomization",
                "codewhisperer:GetCustomization",
                "codewhisperer:ListCustomizationPermissions",
                "codewhisperer:AssociateCustomizationPermission",
                "codewhisperer:DisassociateCustomizationPermission"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "codeconnections:ListConnections",
                "codeconnections:ListOwners",
                "codeconnections:ListRepositories",
                "codeconnections:GetConnection"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": "codeconnections:UseConnection",
            "Resource": "*",
            "Condition": {
                "ForAnyValue:StringEquals": {
                    "codeconnections:ProviderAction": [
                        "GitPull",
                        "ListRepositories",
                        "ListOwners"
                    ]
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetObject*",
                "s3:GetBucket*",
                "s3:ListBucket*"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}
注意

您为 Amazon Q Developer Pro 设置的加密密钥也用于自定义。

准备数据

使用尽可能好的原始材料创建自定义内容非常重要。准备数据源时，请添加包含团队鼓励使用的模式的代码。避免使用包含反模式、错误、安全漏洞、性能问题等的代码。

您的数据源必须包含至少 2 MB、最多 20 GB 的源代码文件 来自支持的语言。任何大于 10 MB 的文件都将被忽略。文件数量没有限制，但是对于要自定义支持的每种语言，您必须至少包含 10 个文件。在 Amazon S3 的数据中 source，确保所有源代码都放在一个目录中，而不是放在根目录下 级别。根级别的所有文件都将被忽略。

注意

Amazon Q 定制支持以下语言和文件扩展名：

  • Java (.java)

  • JavaScript (.js、.jsx)

  • Python (.py)

  • TypeScript (.ts、.tsx)

（预览）在聊天中启用自定义

聊天中的自定义（预览）将中选定的自定义项配置IDE为也用于聊天功能（在IDE）。这允许开发人员使用自然语言生成基于内部库的代码。开发人员还可以询问有关代码库的问题，例如如何使用某些函数或库，或者特定的函数、方法或APIs执行哪些操作。

要在聊天中启用自定义，请按以下步骤操作。

  1. 前往 Amazon Q 开发者控制台。

  2. 从导航面板中选择 “设置”。

  3. 选择 查看设置。

  4. 在 “详细信息” 下，选择 “编辑”。

  5. 在 “高级设置” 下，选中 “启用聊天自定义功能” 旁边的复选框。

  6. 选择 Save changes（保存更改）。

您可以在 Amazon Lo CloudWatch gs 中存储有关创建自定义项的信息。有关更多信息，请参阅 访问 Amazon 日志中与自定义相关的消息 CloudWatch 。