Amazon Q カスタマイズの前提条件

Amazon Q カスタマイズは Amazon Q Developer Pro の基盤に基づいて構築され、その機能を使用します。

Amazon Q のカスタマイズを使用するには、まず の Amazon Q Developer Pro セットアッププロセスに従う必要がありますAmazon Q Developer の開始方法。これには、Amazon Q Customizations へのアクセスを許可するユーザーを Amazon Q Developer Pro プロファイルに追加することも含まれます。

Amazon Q Customizations を使用する場合、Amazon Q 管理者はコードベースにアクセスする権限を持っている必要があります。コードベースは、Amazon S3 または を介して保存できます AWS CodeConnections。ただし、Amazon Q Developer Pro の標準セットアッププロセスでは、 AWS Organizations 管理者は Amazon Q 管理者にこれらのサービスへのアクセスを提供しません。

したがって、Amazon Q Customizations を使用する前に、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": [
                "*"
            ]
        }
    ]
}

可能な限り最適なソースマテリアルを使用してカスタマイズを作成することが重要です。データソースを準備するときは、チームに推奨されるパターンを含むコードを追加します。アンチパターン、バグ、セキュリティの脆弱性、パフォーマンスの問題などを含むコードは避けてください。

データソースには、少なくとも 2 MB、最大 20 GB のソースコードファイルが含まれている必要があります。
 サポートされている言語から。10 MB を超えるファイルは無視されます。ファイル数に制限はありませんが、カスタマイズでサポートする言語ごとに少なくとも 10 個のファイルを含める必要があります。Amazon S3 データ内
 source、すべてのソースコードがルートではなくディレクトリに配置されることを確認します。
 レベル。ルートレベルのファイルは無視されます。

カスタマイズの作成に関する情報は、Amazon CloudWatch Logs に保存できます。詳細については、「Amazon CloudWatch Logs でのカスタマイズ関連のメッセージへのアクセス」を参照してください。