Prerequisiti per le personalizzazioni di Amazon Q

Le personalizzazioni di Amazon Q si basano sulle fondamenta di Amazon Q Developer Pro e ne utilizzano le funzionalità.

Per utilizzare le personalizzazioni di Amazon Q devi prima seguire la procedura di configurazione di Amazon Q Developer Pro riportata sottoConfigurazione di Amazon Q Developer. Ciò include l'aggiunta di tutti gli utenti al tuo profilo Amazon Q Developer Pro a cui desideri concedere anche l'accesso alle personalizzazioni di Amazon Q.

Quando utilizzi Amazon Q Customizations, il tuo amministratore di Amazon Q deve essere autorizzato ad accedere alla tua codebase, che puoi archiviare su Amazon S3 o tramite Amazon S3. AWS CodeConnections Tuttavia, durante la procedura di configurazione standard per Amazon Q Developer Pro, AWS Organizations l'amministratore non fornisce all'amministratore di Amazon Q l'accesso a tali servizi.

Nota

Se utilizzi GitHub come fonte di dati, puoi limitarne l'utilizzo a determinati repository. Vedi Creare una connessione a GitHub nella Guida per l'utente della console Developer Tools.

Pertanto, prima di utilizzare Amazon Q Customizations, devi aggiungere le seguenti autorizzazioni al tuo ruolo di amministratore di Amazon Q:

Nota

Il codewhisperer prefisso è un nome legacy di un servizio che si è unito ad Amazon Q Developer. Per ulteriori informazioni, consulta Amazon Q Developer rename - Riepilogo delle modifiche.

{
    "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": [
                "*"
            ]
        }
    ]
}

Nota

La chiave di crittografia configurata per Amazon Q Developer Pro viene utilizzata anche per le personalizzazioni.

È importante creare la personalizzazione utilizzando il miglior materiale sorgente possibile. Quando prepari la fonte dei dati, aggiungi codice contenente modelli consigliati dal tuo team. Evita il codice contenente anti-pattern, bug, vulnerabilità di sicurezza, problemi di prestazioni e così via.

L'origine dati deve contenere almeno 2 MB e al massimo 20 GB di file di codice sorgente dalle lingue supportate. Qualsiasi file di dimensioni superiori a 10 MB verrà ignorato. Non c'è limite al numero di file, ma devi includere almeno 10 file per ogni lingua che desideri supportare con la personalizzazione. Nei dati di Amazon S3 source, assicurati che tutto il codice sorgente sia collocato all'interno di una directory e non nella directory principale livello. Tutti i file a livello di root verranno ignorati.

Nota

Amazon Q Customizations supporta le seguenti lingue ed estensioni di file:

• Java (.java)

• JavaScript (.js, .jsx)

• Python (.py)

• TypeScript (.ts, .tsx)

Puoi memorizzare informazioni sulla creazione delle tue personalizzazioni in Amazon CloudWatch Logs. Per ulteriori informazioni, consulta Accesso ai messaggi relativi alla personalizzazione in Amazon Logs CloudWatch .