Conditions requises pour les personnalisations d'Amazon Q

Les personnalisations d'Amazon Q s'appuient sur les bases d'Amazon Q Developer Pro et utilisent ses fonctionnalités.

Pour utiliser les personnalisations Amazon Q, vous devez d'abord suivre le processus de configuration d'Amazon Q Developer Pro ci-dessous. Commencer à utiliser Amazon Q Developer Cela inclut l'ajout de tous les utilisateurs à votre profil Amazon Q Developer Pro auxquels vous souhaitez également accorder l'accès aux personnalisations Amazon Q.

Autorisation de votre administrateur

Lorsque vous utilisez les personnalisations Amazon Q, votre administrateur Amazon Q doit être autorisé à accéder à votre base de code, que vous pouvez stocker sur Amazon S3 ou via AWS CodeConnections. Toutefois, au cours du processus de configuration standard d'Amazon Q Developer Pro, votre AWS Organizations l'administrateur ne fournit pas à l'administrateur Amazon Q l'accès à ces services.

Note

Si vous l'utilisez GitHub comme source de données, vous pouvez limiter l'utilisation à certains référentiels. Voir Création d'une connexion à GitHub dans le guide de l'utilisateur de la console Developer Tools.

Par conséquent, avant d'utiliser Amazon Q Customizations, vous devez ajouter les autorisations suivantes au rôle d'administrateur Amazon Q :

Note

Le codewhisperer préfixe est un ancien nom issu d'un service fusionné avec Amazon Q Developer. Pour de plus amples informations, veuillez consulter Changement du nom du développeur Amazon Q - Résumé des modifications.

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

Note

La clé de chiffrement que vous avez configurée pour Amazon Q Developer Pro est également utilisée pour les personnalisations.

Préparation de vos données

Il est important de créer votre personnalisation en utilisant le meilleur matériel source possible. Lorsque vous préparez votre source de données, ajoutez du code contenant des modèles qui sont encouragés au sein de votre équipe. Évitez le code contenant des anti-modèles, des bogues, des failles de sécurité, des problèmes de performance, etc.

Votre source de données doit contenir au moins 2 Mo et au plus 20 Go de fichiers de code source à partir des langues prises en charge. Tout fichier supérieur à 10 Mo sera ignoré. Le nombre de fichiers n'est pas limité, mais vous devez inclure au moins 10 fichiers pour chaque langue que vous souhaitez que votre personnalisation prenne en charge. Dans les données Amazon S3 source, assurez-vous que tout le code source est placé dans un répertoire et non à la racine niveau. Tous les fichiers situés au niveau de la racine seront ignorés.

Note

Amazon Q Customizations prend en charge les langues et extensions de fichiers suivantes :

• Java (.java)

• JavaScript (.js, .jsx)

• Python (.py)

• TypeScript (.ts, .tsx)

(aperçu) Activation de la personnalisation dans le chat

La personnalisation dans le chat (aperçu) configure la personnalisation sélectionnée dans le IDE à utiliser également pour la fonctionnalité de chat (dans leIDE). Cela permet aux développeurs d'utiliser le langage naturel pour générer du code basé sur des bibliothèques internes. Les développeurs peuvent également poser des questions sur la base de code, par exemple sur la manière dont certaines fonctions ou bibliothèques sont utilisées, ou sur les fonctions, méthodes ou APIs fonctions spécifiques.

Pour activer la personnalisation dans le chat, suivez la procédure ci-dessous.

1. Accédez à la console Amazon Q Developer.

2. Dans le panneau de navigation, choisissez Réglages.

3. Choisissez Afficher les paramètres.

4. Sous Détails, choisissez Modifier.

5. Sous Paramètres avancés, cochez la case à côté de Activer la fonctionnalité de personnalisation du chat.

6. Sélectionnez Enregistrer les modifications.

Vous pouvez stocker des informations relatives à la création de vos personnalisations dans Amazon CloudWatch Logs. Pour de plus amples informations, veuillez consulter Accès aux messages relatifs à la personnalisation dans Amazon Logs CloudWatch .