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

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 avec votre compte AWS. Pour plus d’informations, consultez 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 l’agent de développement Amazon Q et les étiquettes de l’agent de transformation Amazon Q dans les référentiels GitHub auxquels vous autorisez l’accès. Si les étiquettes ne sont pas créées automatiquement ou si elles sont supprimées par inadvertance, vous pouvez les créer manuellement dans GitHub. Les étiquettes doivent être nommées agent de développement Amazon Q et agent de transformation Amazon Q pour être reconnues et traitées en tant qu’étiquettes 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 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 generating the proposed code changes and opened a pull request: Resolve Create an image recognition app »), 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. Pour la ligne de code pour laquelle vous souhaitez laisser un commentaire et demander à Amazon Q Developer d’itérer, choisissez + pour ajouter un commentaire avec un feedback, puis choisissez Commencer un avis.

    Une fois que vous avez envoyé votre avis, Amazon Q Developer commence à examiner le code en fonction de vos commentaires. Lorsqu’Amazon Q Developer a terminé d’examiner votre feedback, il valide les modifications apportées à la demande de tirage et vous en avertit avec un commentaire.

  3. Choisissez Terminer votre examen, cliquez sur le bouton radio Demander des modifications, puis choisissez Soumettre un examen pour que votre feedback soit examiné.

  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.

Amazon Q Developer s’intègre aux flux de travail Actions GitHub pour créer un système de boucle de feedback intelligent. Lorsqu’une demande de tirage est créée, les flux de travail configurés, tels que les tests unitaires, sont exécutés automatiquement. Si le flux de travail échoue, Amazon Q Developer analyse le résultat et, sur la base des résultats et des informations relatives à l’échec, itère les modifications apportées au code. Au fur et à mesure que les modifications de code sont appliquées et que les flux de travail sont exécutés, Amazon Q Developer interprète les résultats et utilise ces informations pour affiner son approche. Cela crée une boucle d’apprentissage continu dans laquelle chaque itération s’appuie sur les tentatives précédentes et où Amazon Q Developer est en mesure de faire évoluer ses solutions.

L’efficacité d’une boucle de feedback dépend de la mise en place de tests et de flux de travail bien définis qui fournissent des commentaires significatifs à Amazon Q Developer pour qu’il puisse les interpréter et en tenir compte. Vous pouvez configurer des flux de travail à l’aide des fichiers YAML Actions GitHub de votre référentiel, ce qui permet des processus de test et de validation personnalisés auxquels Amazon Q Developer peut répondre. Pour plus d’informations, consultez Comprendre GitHub Actions dans la documentation GitHub.