Amazon Q 自訂的先決條件

Amazon Q 自訂建立在 Amazon Q 開發人員專業版的基礎上，並使用其功能。

若要使用 Amazon Q 自訂，您必須先遵循下面的 Amazon Q 開發人員專業版設定程序設置 Amazon Q 開發人員。這包括將任何使用者新增至您也想授與 Amazon Q 自訂存取權的 Amazon Q 開發人員專業設定檔。

當您使用 Amazon Q 自訂時，您的 Amazon Q 管理員必須獲得授權才能存取您的程式碼庫，您可以透過 Amazon S3 或透過 AWS CodeConnections存放該程式碼庫。但是，在 Amazon Q 開發人員專業版的標準設定程序期間，您的 AWS Organizations 管理員不會向 Amazon Q 管理員提供這些服務的存取權。

注意

如果您使用 GitHub 做為資料來源，則可以限制某些儲存庫的使用量。請參閱開發人員工具主控台使用者指南 GitHub中的建立連線。

因此，在您使用 Amazon Q 自訂之前，必須將下列許可新增至 Amazon Q 管理員的角色：

注意

codewhisperer前置詞是與 Amazon Q 開發人員合併的服務的舊名稱。如需詳細資訊，請參閱 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 開發人員專業版設定的加密金鑰也會用於自訂。

使用盡可能最好的來源材料建立自訂是很重要的。準備資料來源時，請新增包含團隊鼓勵的模式的程式碼。避免包含反模式、錯誤、安全漏洞、效能問題等的程式碼。

您的資料來源必須包含至少 2 MB，最多 20 GB 的原始程式碼檔案 來自支持的語言。任何大於 10 MB 的檔案都會被忽略。檔案數目沒有限制，但您必須針對希望自訂支援的每種語言包含至少 10 個檔案。在 Amazon S3 數據 source，請確保所有源代碼都放在目錄中，而不是放置在根目錄中 水平。任何位於根層級的檔案都將被忽略。

注意

Amazon Q 自訂支援下列語言和副檔名：

• 爪哇

• JavaScript (.js, .jsx)

• Python（.py）

• TypeScript (. TS, .tsx)

您可以在 Amazon CloudWatch 日誌中存放有關建立自訂的資訊。如需更多詳細資訊，請參閱 存取 Amazon 日誌中的自訂相關訊息 CloudWatch 。