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 个文件。在亚马逊 S3 的数据中 source，确保所有源代码都放在一个目录中，而不是放在根目录下 级别。根级别的所有文件都将被忽略。

注意

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

• Java (.java)

• JavaScript (.js、.jsx)

• Python (.py)

• TypeScript (.ts、.tsx)

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