Développement de fonctionnalités et itération avec Amazon Q Developer dans GitHub

Note

Amazon Q Developer pour GitHub est actuellement disponible en version préliminaire et susceptible d’être modifié.

Vous pouvez utiliser Amazon Q Developer dans GitHub pour rationaliser le développement en implémentant automatiquement de nouvelles fonctionnalités et en corrigeant des bogues, en faisant passer les tâches de l’idée à une demande de tirage terminée. Lorsque vous ajoutez l’étiquette de développement de fonctionnalités à un problème ou que vous utilisez la commande slash /q dev, Amazon Q Developer utilise le problème, y compris son titre et sa description, ainsi que le code du référentiel comme contexte pour générer de nouveaux correctifs de code et créer une demande de tirage. Sur la demande de tirage, vous pouvez fournir un feedback et Amazon Q Developer répète le code suggéré.

Vous pouvez demander à Amazon Q Developer de développer des fonctionnalités un nombre limité de fois par mois. Vous pouvez augmenter votre utilisation gratuite à tout moment en enregistrant l'installation de l'application Amazon Q Developer sur votre AWS compte. Pour de plus amples informations, veuillez consulter Augmentation des limites d’utilisation et des détails de configuration dans la console Amazon Q Developer.

Important

L'application Amazon Q Developer tente de créer automatiquement le label d'agent de développement Amazon Q dans GitHub les référentiels auxquels vous autorisez l'accès. Si l'étiquette n'est pas créée automatiquement ou si elle est supprimée par inadvertance, vous pouvez la créer manuellement dansGitHub. L'étiquette doit être nommée agent de développement Amazon Q pour être reconnue et traitée en tant qu'étiquette Amazon Q Developer. Pour plus d’informations, consultez Création d’une étiquette dans la documentation GitHub.

Pour utiliser Amazon Q Developer pour le développement de fonctionnalités

1. Si nécessaire, connectez-vous à votre compte GitHub en utilisant vos informations d’identification GitHub.

2. Accédez à votre organisation GitHub, puis au référentiel dans lequel vous souhaitez implémenter de nouvelles fonctionnalités avec Amazon Q Developer.

3. Choisissez Problèmes, puis créez un nouveau problème ou choisissez un problème existant. Pour plus d’informations, consultez Création d’un problème dans la documentation GitHub.

   1. Pour un nouveau problème, dans le champ de saisie de texte Ajouter un titre, saisissez un titre qui fournit le contexte à Amazon Q Developer pour le développement des fonctionnalités (exemple : « Créer une application de reconnaissance d’image »). La description du problème doit également être incluse, car elle fournit également un contexte.

      Pour un problème existant, vous pouvez modifier le titre et la description du problème afin de fournir le contexte à Amazon Q Developer pour le développement des fonctionnalités. Pour plus d’informations, consultez Modification d’un problème dans la documentation GitHub.

4. Lorsque vous créez un problème ou que vous configurez un problème existant, vous pouvez appliquer l’étiquette Amazon Q Developer destinée au développement de fonctionnalités ou utiliser la commande slash /q dev. Effectuez l’une des actions suivantes :

   • Pour appliquer l’étiquette au problème, effectuez l’une des actions suivantes :

     • Choisissez le menu déroulant Attribuer à Amazon Q fourni sous forme d’extension de navigateur, puis choisissez l’étiquette de l’agent de développement Amazon Q.

     • Dans le menu de droite, choisissez Étiquettes, puis sélectionnez l’étiquette de l’agent de développement Amazon Q.

   • Pour utiliser la commande slash /q dev dans un commentaire :

     1. Dans le problème, accédez à Ajouter un commentaire, puis saisissez /q dev dans le champ d’entrée du texte de commentaire.

     2. Choisissez Comment (Commentaire).

5. Pour un nouveau problème, choisissez Créer un problème pour finaliser la création du problème avec les informations nécessaires pour qu’Amazon Q Developer développe des fonctionnalités. Si vous configurez un problème existant, veillez à enregistrer les modifications. Pour plus d’informations, consultez Modification d’un problème dans la documentation GitHub.

   Lorsqu’Amazon Q Developer a fini de générer des modifications de code pour le développement des fonctionnalités, il commente le problème et ouvre une demande de tirage.

6. Accédez au commentaire laissé par Amazon Q Developer (exemple : « I finished the proposed code changes, and the pull request is ready for review: [PR link] »), puis choisissez le lien de la demande de tirage.

   Vous pouvez également accéder à l’onglet demandes de tirage, puis choisir la demande de tirage créée par Amazon Q Developer.

7. Cliquez sur l’onglet Fichiers modifiés pour afficher les modifications du code.

8. Si vous êtes satisfaits des modifications de code proposées, vous pouvez fusionner la demande de tirage. Pour plus d’informations, consultez Fusion d’une demande de tirage.

Vous pouvez également consulter la demande de tirage pour le développement des fonctionnalités et répéter les modifications de code suggérées en envoyant des commentaires à Amazon Q Developer.

Pour itérer le code de développement des fonctionnalités Amazon Q Developer

1. Choisissez la demande de tirage créée par Amazon Q Developer, puis cliquez sur l’onglet Fichiers modifiés pour afficher les modifications de code.

2. Facultativement, pour les lignes de code spécifiques sur lesquelles vous souhaitez fournir des commentaires, choisissez + pour ajouter un commentaire avec des commentaires.

   Dans la conversation, vous pouvez utiliser la /q commande suivie de vos instructions en langage naturel (par exemple, /q implement my suggestions ou/q refactor this function for better performance). Le développeur Amazon Q répondra par un commentaire décrivant les modifications qu'il apportera en fonction de vos commentaires (par exemple, « Je vais implémenter les modifications suivantes en fonction des commentaires :... »). Une fois l'implémentation terminée, le développeur Amazon Q publiera un autre commentaire confirmant les modifications (par exemple, « J'ai mis en œuvre les modifications suggérées ») ainsi qu'un lien vers le commit généré où vous pourrez consulter les modifications.

3. Passez en revue les modifications apportées par Amazon Q Developer en suivant le lien de validation fourni lors de la conversation. Vous pouvez continuer à fournir des commentaires supplémentaires à l'aide de la /q commande pour d'autres itérations si nécessaire.

4. Si vous êtes satisfait des modifications apportées au code, vous pouvez fusionner la demande de tirage ou répéter une nouvelle itération sur le code avec un nouveau feedback. Pour plus d’informations, consultez Fusion d’une demande de tirage.