本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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 。