View a markdown version of this page

Tutoriel : Utiliser les fonctionnalités CodeCatalyst génératives de l'IA pour accélérer votre travail de développement - Amazon CodeCatalyst
Conditions préalablesUtiliser Amazon Q pour choisir un plan lors de la création d'un projet ou de l'ajout de fonctionnalitésAjouter un résumé généré automatiquement lors de la création d'une pull requestCréer un résumé des commentaires laissés sur les modifications de code dans une pull requestCréez un problème et attribuez-le à Amazon QCréez un problème et demandez à Amazon Q de vous recommander des tâchesnettoyer des ressources ;

Amazon n' CodeCatalyst est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour de plus amples informations, veuillez consulter Comment effectuer une migration depuis CodeCatalyst.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Tutoriel : Utiliser les fonctionnalités CodeCatalyst génératives de l'IA pour accélérer votre travail de développement

Si vous avez un projet et un référentiel de sources sur Amazon CodeCatalyst dans un espace où les fonctionnalités génératives d'IA sont activées, vous pouvez utiliser ces fonctionnalités pour accélérer le développement logiciel. Les développeurs ont souvent plus de tâches à accomplir que de temps pour les accomplir. Ils ne prennent souvent pas le temps d'expliquer les modifications apportées à leur code à leurs collègues lorsqu'ils créent des pull requests pour la révision de ces modifications, s'attendant à ce que les autres utilisateurs trouvent ces modifications explicites. Les créateurs et les réviseurs de pull request n'ont pas non plus le temps de trouver et de lire attentivement tous les commentaires d'une pull request, en particulier si la pull request comporte plusieurs révisions. CodeCatalyst s'intègre à l'agent de développement Amazon Q pour le développement de logiciels afin de fournir des fonctionnalités d'IA génératives qui peuvent à la fois aider les membres de l'équipe à accomplir leurs tâches plus rapidement et à leur permettre de se concentrer sur les aspects les plus importants de leur travail.

Amazon Q Developer est un assistant AI-powered conversationnel génératif qui peut vous aider à comprendre, créer, étendre et exploiter AWS des applications. Pour accélérer votre développement AWS, le modèle qui sous-tend Amazon Q est complété par un AWS contenu de haute qualité afin de produire des réponses plus complètes, exploitables et référencées. Pour plus d’informations, consultez la section What is Amazon Q Developer? du guide de l’utilisateur Amazon Q Developer.

Note

Propulsé par Amazon Bedrock  : AWS met en œuvre une détection https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html automatique des abus. Étant donné que les fonctionnalités Rédiger une description pour moi, Créer un résumé du contenu, Recommander des tâches, Utiliser Amazon Q pour créer ou ajouter des fonctionnalités à un projet et Attribuer des problèmes à Amazon Q avec l’agent Amazon Q Developer de développement logiciel sont basées sur Amazon Bedrock, les utilisateurs peuvent tirer pleinement parti des contrôles mis en œuvre dans Amazon Bedrock pour renforcer la sûreté, la sécurité et l’utilisation responsable de l’intelligence artificielle (IA).

Dans ce didacticiel, vous apprendrez à utiliser les fonctionnalités génératives de l'IA pour vous aider CodeCatalyst à créer des projets avec des plans, ainsi qu'à ajouter des plans à des projets existants. En outre, vous apprendrez à résumer les modifications entre les branches lors de la création de pull requests et à résumer les commentaires laissés sur une pull request. Vous apprendrez également à créer des problèmes avec vos idées de modifications ou d'améliorations de code et à les attribuer à Amazon Q. Dans le cadre de la gestion des problèmes attribués à Amazon Q, vous apprendrez comment autoriser Amazon Q à suggérer des tâches et comment attribuer et traiter toutes les tâches qu'il crée dans le cadre de la résolution d'un problème.

Conditions préalables

Pour utiliser les CodeCatalyst fonctionnalités de ce didacticiel, vous devez d'abord avoir terminé et avoir accès aux ressources suivantes :

  • Vous disposez d'un AWS Builder ID ou d'une identité SSO (Single Sign-on) à laquelle vous pouvez vous connecter. CodeCatalyst

  • Vous vous trouvez dans un espace où les fonctionnalités génératives d'IA sont activées. Pour plus d'informations, consultez la section Gestion des fonctionnalités génératives d'IA.

  • Vous avez le rôle de contributeur ou d'administrateur de projet dans un projet de cet espace.

  • À moins que vous ne créiez un projet avec une IA générative, au moins un référentiel source est configuré pour votre projet existant. Les référentiels liés ne sont pas pris en charge.

  • Lorsque vous attribuez des problèmes pour qu'une solution initiale soit créée par l'IA générative, le projet ne peut pas être configuré avec l'extension Jira Software. L'extension n'est pas prise en charge pour cette fonctionnalité.

Pour plus d'informations, consultez Création d’un espace, Suivez et organisez le travail en cas de problèmes dans CodeCatalyst, Ajoutez des fonctionnalités aux projets avec des extensions dans CodeCatalyst et Octroi d'un accès avec des rôles d'utilisateur.

Ce didacticiel est basé sur un projet créé à l'aide du plan d'application Web moderne à trois niveaux avec Python. Si vous utilisez un projet créé avec un plan différent, vous pouvez toujours suivre les étapes, mais certaines spécificités peuvent varier, telles que l'exemple de code et la langue.

Utiliser Amazon Q pour choisir un plan lors de la création d'un projet ou de l'ajout de fonctionnalités

En tant que développeur de projets, vous pouvez collaborer avec Amazon Q, un assistant d'IA génératif, lors de la création de nouveaux projets ou de l'ajout de composants à des projets existants. Vous pouvez fournir à Amazon Q les exigences relatives à votre projet en interagissant avec celui-ci dans une interface de type chat. En fonction de vos besoins, Amazon Q suggère un plan et décrit également les exigences qui ne peuvent pas être satisfaites. Si votre espace possède des plans personnalisés, Amazon Q apprend et inclut également ces plans dans les recommandations. Vous pouvez ensuite suivre la suggestion d'Amazon Q si vous êtes satisfait, et l'entreprise créera les ressources nécessaires, telles qu'un référentiel de sources contenant le code correspondant à vos besoins. Amazon Q crée également des problèmes pour les exigences qui ne peuvent pas être satisfaites par un plan. Pour en savoir plus sur les CodeCatalyst plans disponibles, consultezCréation d'un projet complet avec des CodeCatalyst plans. Pour en savoir plus sur l'utilisation d'Amazon Q avec des plans, consultezMeilleures pratiques lors de l'utilisation d'Amazon Q pour créer des projets ou ajouter des fonctionnalités à l'aide de plans.

Pour créer un projet avec Amazon Q

  1. Ouvrez la CodeCatalyst console à l'adresse https://codecatalyst.aws/.

  2. Dans la CodeCatalyst console, accédez à l'espace dans lequel vous souhaitez créer un plan.

  3. Sur le tableau de bord de l'espace, choisissez Créer avec Amazon Q.

  4. Dans le champ de saisie de texte rapide Amazon Q, fournissez des instructions en écrivant une brève description du projet que vous souhaitez créer. Par exemple, “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”

    (Facultatif) Sous Exemples d'essais, vous pouvez utiliser une invite préécrite en choisissant un plan. Par exemple, si vous choisissez l'application React, l'invite suivante s'affiche : “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”

  5. Choisissez Envoyer pour envoyer vos instructions à Amazon Q. L'assistant IA génératif propose une suggestion et décrit les exigences qui ne peuvent pas être satisfaites par le plan. Par exemple, Amazon Q peut vous suggérer ce qui suit en fonction de vos critères :

    I recommend using the Modern three-tier web application blueprint based on 
                    your requirements. Blueprints are dynamic and can always be updated and edited later.

Modern three-tier web application
By Amazon Web Services

This blueprint creates a Mythical Mysfits 3-tier web application with a modular presentation, application, and data layers. 
The application leverages containers, infrastructure as code (IaC), continuous integration and continuous delivery (CI/CD), 
and serverless code functions.

Version: 0.1.163

View details

The following requirements could not be met so I will create issues for you.
• Add authentication and authorization mechanisms for security and allowable actions.

  6. (Facultatif) Pour afficher les détails détaillés du plan suggéré, choisissez Afficher les détails.

  7. Effectuez l’une des actions suivantes :

    1. Choisissez Oui, utilisez ce plan si vous êtes satisfait de la suggestion.

    2. Choisissez Modifier l'invite si vous souhaitez modifier l'invite.

    3. Choisissez Recommencer si vous souhaitez effacer complètement l'invite.

  8. Effectuez l’une des actions suivantes :

    1. Choisissez Configurer si vous souhaitez configurer le plan suggéré. Vous pouvez également configurer le plan ultérieurement.

    2. Choisissez Ignorer si vous ne souhaitez pas modifier les configurations du plan pour le moment.

  9. Si vous avez choisi de configurer le plan, choisissez Continuer après avoir modifié les ressources du projet.

  10. Lorsque vous y êtes invité, entrez le nom que vous souhaitez attribuer à votre projet et les noms des ressources associées. Le nom doit être unique au sein de votre espace.

  11. Choisissez Créer un projet pour créer un projet avec le plan. Amazon Q crée des ressources à l'aide du plan. Par exemple, si vous créez un projet avec le plan de l' Single-page application, un référentiel source contenant le code et les flux de travail pertinents est créé. CI/CD

  12. (Facultatif) Par défaut, Amazon Q crée également des problèmes pour les exigences qui ne sont pas satisfaites par un plan. Vous pouvez choisir les articles pour lesquels vous ne souhaitez pas créer de problèmes. Après avoir choisi de laisser Amazon Q créer des problèmes, vous pouvez également attribuer un problème à Amazon Q. Il analysera le problème dans le contexte des référentiels sources donnés, en fournissant un résumé des fichiers sources et du code pertinents. Pour plus d’informations, consultez Recherche et affichage des problèmes, Créez un problème et attribuez-le à Amazon Q et Meilleures pratiques lors de la création et de la résolution de problèmes attribués à Amazon Q.

Après avoir créé un projet avec Amazon Q, vous pouvez également utiliser Amazon Q pour ajouter de nouveaux composants car il suggère des CodeCatalyst plans en fonction de vos besoins.

Pour ajouter un plan avec Amazon Q

  1. Ouvrez la CodeCatalyst console à l'adresse https://codecatalyst.aws/.

  2. Dans la CodeCatalyst console, accédez au projet dans lequel vous souhaitez ajouter un plan.

  3. Choisissez Ajouter avec Amazon Q.

  4. Dans le champ de saisie de texte rapide Amazon Q, fournissez des instructions en écrivant une brève description du projet que vous souhaitez créer. Par exemple, “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”

    (Facultatif) Sous Exemples d'essais, vous pouvez utiliser une invite préécrite en choisissant un plan. Par exemple, si vous choisissez l'application React, l'invite suivante s'affiche : “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”

  5. Choisissez Envoyer pour envoyer vos instructions à Amazon Q. L'assistant IA génératif propose une suggestion et décrit les exigences qui ne peuvent pas être satisfaites par le plan. Par exemple, Amazon Q peut vous suggérer ce qui suit en fonction de vos critères :

    I recommend using the Single-page application blueprint based on your requirements. Blueprints are dynamic and can always be updated and edited later.

Single-page application
By Amazon Web Services

This blueprint creates a SPA (single-page application) using React, Vue, or Angular frameworks and deploys to AWS Amplify Hosting.

Version: 0.2.15
View details

The following requirements could not be met so I will create issues for you.
• The application should have reusable UI components
• The application should support for client-side routing
• The application may require server-side rendering for improved performance and SEO

  6. (Facultatif) Pour afficher les détails détaillés du plan suggéré, choisissez Afficher les détails.

  7. Effectuez l’une des actions suivantes :

    1. Choisissez Oui, utilisez ce plan si vous êtes satisfait de la suggestion.

    2. Choisissez Modifier l'invite si vous souhaitez modifier l'invite.

    3. Choisissez Recommencer si vous souhaitez effacer complètement l'invite.

  8. Effectuez l’une des actions suivantes :

    1. Choisissez Configurer si vous souhaitez configurer le plan suggéré. Vous pouvez également configurer le plan ultérieurement.

    2. Choisissez Ignorer si vous ne souhaitez pas modifier les configurations du plan pour le moment.

  9. Si vous avez choisi de configurer le plan, choisissez Continuer après avoir modifié les ressources du projet.

  10. Choisissez Ajouter au projet pour ajouter des ressources à un projet avec le plan. Amazon Q crée des ressources à l'aide du plan. Par exemple, si vous ajoutez à un projet le plan de l' Single-page application, un référentiel source contenant le code et les flux de travail pertinents est créé. CI/CD

  11. (Facultatif) Par défaut, Amazon Q crée également des problèmes pour les exigences qui ne sont pas satisfaites par un plan. Vous pouvez choisir les articles pour lesquels vous ne souhaitez pas créer de problèmes. Après avoir choisi de laisser Amazon Q créer des problèmes, vous pouvez également attribuer un problème à Amazon Q. Il analysera le problème dans le contexte des référentiels sources donnés, en fournissant un résumé des fichiers sources et du code pertinents. Pour plus d’informations, consultez Créez un problème et attribuez-le à Amazon Q et Meilleures pratiques lors de la création et de la résolution de problèmes attribués à Amazon Q.

Créez un résumé des modifications de code entre les branches lors de la création d'une pull request

Une pull request est le principal moyen par lequel vous et les autres membres du projet pouvez examiner, commenter et fusionner les modifications de code d'une branche à l'autre. Vous pouvez utiliser les pull requests pour examiner les modifications de code de manière collaborative afin de détecter des modifications ou des corrections mineures, des ajouts de fonctionnalités majeurs ou de nouvelles versions de votre logiciel publié. Résumer les modifications de code et l'intention qui les sous-tend dans la description de la pull request est utile aux autres personnes qui réviseront le code, et permet également de comprendre l'historique des modifications apportées au code au fil du temps. Cependant, les développeurs s'appuient souvent sur leur code pour s'expliquer ou fournir des détails ambigus au lieu de décrire leurs modifications avec suffisamment de détails pour que les réviseurs puissent comprendre ce qu'ils révisent ou quelle était l'intention qui sous-tendait les modifications apportées au code.

Vous pouvez utiliser la fonction Rédiger une description pour moi lorsque vous créez des pull requests pour qu'Amazon Q crée une description des modifications contenues dans une pull request. Lorsque vous choisissez cette option, Amazon Q analyse les différences entre la branche source qui contient les modifications de code et la branche de destination dans laquelle vous souhaitez fusionner ces modifications. Il crée ensuite un résumé de ces changements, ainsi que sa meilleure interprétation de l'intention et de l'effet de ces changements.

Note

Cette fonctionnalité ne fonctionne pas avec les sous-modules Git. Il ne récapitule aucune modification apportée à un sous-module Git faisant partie de la pull request.

Cette fonctionnalité n'est pas disponible pour les demandes d'extraction dans les référentiels liés.

Vous pouvez essayer cette fonctionnalité avec n'importe quelle pull request que vous créez, mais dans ce didacticiel, nous allons la tester en apportant quelques modifications simples au code contenu dans un projet créé dans un plan d'application Web Python-based moderne à trois niveaux.

Astuce

Si vous utilisez un projet créé avec un plan différent ou votre propre code, vous pouvez toujours suivre ce didacticiel, mais les exemples de ce didacticiel ne correspondront pas au code de votre projet. Au lieu de suivre l'exemple suggéré ci-dessous, apportez des modifications simples au code de votre projet dans une branche, puis créez une pull request pour tester la fonctionnalité, comme indiqué dans les étapes suivantes.

Tout d'abord, vous allez créer une branche dans le référentiel source. Vous allez ensuite modifier rapidement le code d'un fichier de cette branche à l'aide de l'éditeur de texte de la console. Vous allez ensuite créer une pull request et utiliser la fonction Rédiger une description pour moi pour résumer les modifications que vous avez apportées.

Pour créer une branche (console)

  1. Dans la CodeCatalyst console, accédez au projet dans lequel se trouve votre référentiel source.

  2. Choisissez le nom du référentiel dans la liste des référentiels sources du projet. Sinon, dans le volet de navigation, choisissez Code, puis choisissez Dépôts sources.

  3. Choisissez le référentiel dans lequel vous souhaitez créer une branche.

  4. Sur la page de présentation du référentiel, choisissez Plus, puis choisissez Créer une branche.

  5. Entrez un nom pour la succursale.

  6. Choisissez une branche à partir de laquelle créer la branche, puis choisissez Créer.

Une fois que vous avez créé une branche, modifiez un fichier dans cette branche en effectuant une simple modification. Dans cet exemple, vous allez modifier le test_endpoint.py fichier pour faire passer le nombre de nouvelles tentatives pour les tests 3 à 5.

Astuce

Vous pouvez également choisir de créer ou d'utiliser un environnement de développement pour effectuer cette modification de code. Pour de plus amples informations, veuillez consulter Création d’un environnement de développement.

Pour modifier le fichier test_endpoint.py dans la console

  1. Sur la page de présentation du référentiel mysfits source, choisissez la liste déroulante des branches et choisissez la branche que vous avez créée lors de la procédure précédente.

  2. Dans Fichiers, accédez au fichier que vous souhaitez modifier. Par exemple, pour modifier le test_endpoint.py fichier, développez les tests, développez integ, puis choisisseztest_endpoint.py.

  3. Choisissez Modifier.

  4. À la ligne 7, modifiez le nombre de fois que tous les tests seront réessayés à partir de :

    def test_list_all(retry=3):

    par :

    def test_list_all(retry=5):

  5. Choisissez Valider et validez vos modifications dans votre branche.

Maintenant que vous avez une branche avec une modification, vous pouvez créer une pull request.

Créez une pull request avec un résumé des modifications

  1. Sur la page de présentation du référentiel, choisissez Plus, puis choisissez Créer une demande d'extraction.

  2. Dans Branche de destination, choisissez la branche dans laquelle fusionner le code après l'avoir révisé.

    Astuce

    Choisissez la branche à partir de laquelle vous avez créé votre branche dans la procédure précédente pour obtenir la démonstration la plus simple de cette fonctionnalité. Par exemple, si vous avez créé votre branche à partir de la branche par défaut du référentiel, choisissez cette branche comme branche de destination pour votre pull request.

  3. Dans Branche source, choisissez la branche qui contient les modifications que vous venez de valider dans le test_endpoint.py fichier.

  4. Dans Titre de la demande d'extraction, saisissez un titre qui aide les autres utilisateurs à comprendre ce qui doit être révisé et pourquoi.

  5. Dans Description de la demande d'extraction, choisissez Écrire une description pour moi pour qu'Amazon Q crée une description des modifications contenues dans la demande d'extraction.

  6. Un résumé des modifications s'affiche. Passez en revue le texte suggéré, puis choisissez Accepter et ajouter à la description.

  7. Vous pouvez éventuellement modifier le résumé pour mieux refléter les modifications que vous avez apportées au code. Vous pouvez également choisir d'ajouter des réviseurs ou de lier les problèmes à cette pull request. Lorsque vous avez terminé d'apporter les modifications supplémentaires souhaitées, choisissez Créer.

Créer un résumé des commentaires laissés sur les modifications de code dans une pull request

Lorsque les utilisateurs examinent une pull request, ils laissent souvent plusieurs commentaires sur les modifications apportées à cette pull request. S'il y a beaucoup de commentaires de la part d'un grand nombre de réviseurs, il peut être difficile de choisir des thèmes communs dans les commentaires, ou même de s'assurer que vous avez revu tous les commentaires dans toutes les révisions. Vous pouvez utiliser la fonction Créer un résumé des commentaires pour qu'Amazon Q analyse tous les commentaires laissés sur les modifications de code dans une pull request et crée un résumé de ces commentaires.

Note

Les résumés des commentaires sont éphémères. Si vous actualisez une pull request, le résumé disparaîtra. Les résumés de contenu n'incluent pas de commentaires sur la demande d'extraction globale, mais uniquement des commentaires laissés sur les différences de code dans les révisions de la pull request.

Cette fonctionnalité ne fonctionne pas avec les commentaires laissés sur les modifications de code dans les sous-modules Git.

Cette fonctionnalité n'est pas disponible pour les demandes d'extraction dans les référentiels liés.

Pour créer un résumé des commentaires dans une pull request

  1. Accédez à la pull request que vous avez créée lors de la procédure précédente.

    Astuce

    Si vous préférez, vous pouvez utiliser n'importe quelle pull request ouverte dans votre projet. Dans la barre de navigation, choisissez Code, choisissez Pull requests, puis choisissez n'importe quelle pull request ouverte.

  2. Ajoutez quelques commentaires à la demande d'extraction dans Changes si la demande d'extraction ne contient pas déjà de commentaires.

  3. Dans Vue d'ensemble, choisissez Créer un résumé des commentaires. Une fois terminée, la section Résumé des commentaires s'agrandit.

  4. Passez en revue le résumé des commentaires laissés sur les modifications apportées au code dans les révisions de la pull request et comparez-le aux commentaires de la pull request.

Créez un problème et attribuez-le à Amazon Q

Les équipes de développement créent des problèmes pour suivre et gérer leur travail, mais parfois un problème persiste parce que soit on ne sait pas qui doit y travailler, soit le problème nécessite des recherches sur une partie particulière de la base de code, soit d'autres tâches urgentes doivent d'abord être effectuées. CodeCatalyst inclut l'intégration avec Amazon Q Developer Agent pour le développement de logiciels. Vous pouvez attribuer des problèmes à un assistant d'IA génératif appelé Amazon Q, qui peut analyser un problème en fonction de son titre et de sa description. Si vous attribuez le problème à Amazon Q, celui-ci tentera de créer un projet de solution que vous pourrez évaluer. Cela peut vous aider, vous et votre équipe, à vous concentrer et à optimiser votre travail sur les problèmes qui nécessitent votre attention, pendant qu'Amazon Q travaille sur une solution aux problèmes que vous ne disposez pas de ressources pour résoudre immédiatement.

Astuce

Amazon Q fonctionne de manière optimale sur les problèmes simples et les problèmes directs. Pour de meilleurs résultats, utilisez un langage simple pour expliquer clairement ce que vous voulez faire.

Lorsque vous attribuez un problème à Amazon Q, CodeCatalyst le problème est marqué comme bloqué jusqu'à ce que vous confirmiez la manière dont vous souhaitez qu'Amazon Q traite le problème. Vous devez répondre à trois questions avant de pouvoir continuer :

  • Que vous souhaitiez confirmer chaque étape ou que vous souhaitiez qu'elle se poursuive sans commentaire. Si vous choisissez de confirmer chaque étape, vous pouvez répondre à Amazon Q en lui faisant part de vos commentaires sur l'approche qu'il a créée afin qu'il puisse la modifier si nécessaire. Amazon Q peut également consulter les commentaires laissés par les utilisateurs sur toute pull request qu'il crée si vous choisissez cette option. Si vous choisissez de ne pas confirmer chaque étape, Amazon Q peut terminer son travail plus rapidement, mais il ne prendra pas en compte les commentaires que vous lui donnez dans le numéro ou dans les pull request qu'il crée.

  • Si vous souhaitez l'autoriser à mettre à jour les fichiers de flux de travail dans le cadre de ses activités. Les flux de travail de votre projet peuvent être configurés pour démarrer les exécutions lors d'événements de pull request. Si tel est le cas, toute demande d'extraction créée par Amazon Q qui inclut la création ou la mise à jour du flux de travail YAML peut démarrer l'exécution des flux de travail inclus dans la demande d'extraction. Il est recommandé de ne pas autoriser Amazon Q à travailler sur des fichiers de flux de travail à moins d'être certain qu'aucun flux de travail de votre projet n'exécutera automatiquement ces flux de travail avant que vous ne vérifiiez et n'approuviez la pull request qu'il crée.

  • Si vous souhaitez l'autoriser à suggérer la création de tâches pour décomposer le travail du numéro en petits incréments pouvant être attribués individuellement aux utilisateurs, y compris Amazon Q lui-même. Permettre à Amazon Q de suggérer et de créer des tâches peut contribuer à accélérer le développement de problèmes complexes en permettant à plusieurs personnes de travailler sur des parties distinctes du problème. Cela peut également contribuer à réduire la complexité de la compréhension de l'ensemble du travail, car le travail nécessaire pour effectuer chaque tâche est idéalement plus simple que le problème auquel elle appartient.

  • Dans quel référentiel source souhaitez-vous qu'il fonctionne. Même si votre projet possède plusieurs référentiels sources, Amazon Q ne peut travailler que sur le code d'un seul référentiel source. Les référentiels liés ne sont pas pris en charge.

Une fois que vous avez fait et confirmé vos choix, Amazon Q fait passer le problème à l'état En cours pendant qu'il tente de déterminer en quoi consiste la demande en fonction du titre du problème et de sa description, ainsi que du code du référentiel spécifié. Il créera un commentaire épinglé dans lequel il fournira des mises à jour sur l'état de ses travaux. Après avoir examiné les données, Amazon Q formulera une approche potentielle pour une solution. Amazon Q enregistre ses actions en mettant à jour son commentaire épinglé et en commentant l'avancement du problème à chaque étape. Contrairement aux commentaires et aux réponses épinglés, il ne conserve pas de trace strictement chronologique de ses travaux. Il place plutôt les informations les plus pertinentes sur son travail au premier niveau du commentaire épinglé. Il tentera de créer du code en fonction de son approche et de son analyse du code déjà présent dans le référentiel. S'il parvient à générer une solution potentielle, il créera une branche et y validera le code. Il crée ensuite une pull request qui fusionnera cette branche avec la branche par défaut. Une fois qu'Amazon Q a terminé son travail, le problème est placé en cours de révision afin que vous et votre équipe sachiez qu'il existe du code prêt à être évalué.

Note

Cette fonctionnalité est uniquement disponible via Issues in the USA West (Oregon) Region. Il n'est pas disponible si vous avez configuré votre projet pour utiliser Jira avec l'extension Jira Software. De plus, si vous avez personnalisé la mise en page de votre tableau, il est possible que le problème ne change pas d'état. Pour de meilleurs résultats, n'utilisez cette fonctionnalité qu'avec des projets dont la mise en page de tableau est standard.

Cette fonctionnalité ne fonctionne pas avec les sous-modules Git. Il ne peut pas apporter de modifications aux sous-modules Git inclus dans le référentiel.

Une fois que vous avez attribué un problème à Amazon Q, vous ne pouvez pas modifier le titre ou la description du problème, ni l'attribuer à quelqu'un d'autre. Si vous annulez l'attribution du problème à Amazon Q, l'étape en cours sera terminée, puis cessera de fonctionner. Il ne peut pas reprendre le travail ni être réaffecté au problème une fois qu'il n'est plus attribué.

Un problème peut être automatiquement placé dans la colonne En révision s'il est attribué à Amazon Q si un utilisateur choisit de l'autoriser à créer des tâches. Cependant, le problème dans En révision peut toujours contenir des tâches dans un état différent, par exemple dans l'état En cours.

Dans cette partie du didacticiel, vous allez créer trois problèmes en fonction des fonctionnalités potentielles du code inclus dans les projets créés avec le plan d'application Web moderne à trois niveaux : un pour ajouter un pour créer une nouvelle créature Mysfit, un pour ajouter une fonction de tri et un pour mettre à jour un flux de travail afin d'inclure une branche nommée. test

Note

Si vous travaillez sur un projet avec un code différent, créez des problèmes avec les titres et les descriptions liés à cette base de code.

Pour créer un problème et générer une solution que vous pourrez évaluer

  1. Dans le volet de navigation, choisissez Problèmes et assurez-vous que vous êtes dans la vue Tableau.

  2. Choisissez Créer un problème.

  3. Donnez au numéro un titre qui explique ce que vous voulez faire en langage clair. Par exemple, pour ce numéro, entrez le titre deCreate another mysfit named Quokkapus. Dans Description, fournissez les informations suivantes :

    Expand the table of mysfits to 13, and give the new mysfit the following characteristics:

Name: Quokkapus

Species: Quokka-Octopus hybrid

Good/Evil: Good

Lawful/Chaotic: Chaotic

Age: 216

Description: Australia is full of amazing marsupials, but there's nothing there quite like the Quokkapus. 
She's always got a friendly smile on her face, especially when she's using her eight limbs to wrap you up 
in a great big hug. She exists on a diet of code bugs and caffeine. If you've got some gnarly code that needsa
assistance, adopt Quokkapus and put her to work - she'll love it! Just make sure you leave enough room for 
her to grow, and keep that coffee coming.

  4. (Facultatif) Joignez une image à utiliser comme miniature et photo de profil pour le mysfit au numéro. Dans ce cas, mettez à jour la description pour inclure des détails sur les images que vous souhaitez utiliser et pourquoi. Par exemple, vous pouvez ajouter ce qui suit à la description : « Le mysfit nécessite le déploiement de fichiers image sur le site Web. Ajoutez les images jointes à ce numéro au référentiel source dans le cadre du travail, puis déployez les images sur le site Web. »

    Note

    Les images jointes peuvent être déployées ou non sur le site Web lors des interactions de ce didacticiel. Vous pouvez ajouter vous-même les images au site Web, puis laisser des commentaires pour qu'Amazon Q mette à jour son code afin qu'il pointe vers les images que vous souhaitez qu'il utilise après avoir créé une pull request.

    Passez en revue la description et assurez-vous qu'elle contient tous les détails nécessaires avant de passer à l'étape suivante.

  5. Dans Destinataires, choisissez Attribuer à Amazon Q.

  6. Dans Référentiel source, choisissez le référentiel source qui contient le code du projet.

  7. Faites glisser le bouton Exiger qu'Amazon Q s'arrête après chaque étape et attendez la révision de son sélecteur de travail pour passer à l'état actif si nécessaire.

    Note

    Choisir l'option permettant à Amazon Q d'arrêter après chaque étape vous permet de commenter le problème ou toute tâche créée. Vous pouvez ainsi demander à Amazon Q de modifier son approche jusqu'à trois fois en fonction de vos commentaires. Si vous choisissez l'option qui empêche Amazon Q de s'arrêter après chaque étape afin de pouvoir revoir son travail, il se peut que le travail avance plus rapidement car Amazon Q n'attend pas vos commentaires, mais vous ne pourrez pas influencer la direction prise par Amazon Q en laissant des commentaires. Amazon Q ne répondra pas non plus aux commentaires laissés dans le cadre d'une pull request si vous choisissez cette option.

  8. Laissez le sélecteur Autoriser Amazon Q à modifier les fichiers de flux de travail à l'état inactif.

  9. Faites glisser le sélecteur Autoriser Amazon Q à suggérer la création de tâches sur l'état actif.

  10. Choisissez Créer un problème. Votre point de vue passe au tableau des problèmes.

  11. Choisissez Créer un numéro pour créer un autre numéro, cette fois avec le titreChange the get_all_mysfits() API to return mysfits sorted by the Age attribute. Attribuez ce problème à Amazon Q et créez le problème.

  12. Choisissez Créer un numéro pour créer un autre numéro, cette fois avec le titreUpdate the OnPullRequest workflow to include a branch named test in its triggers. Vous pouvez éventuellement créer un lien vers le flux de travail dans la description. Attribuez ce problème à Amazon Q, mais cette fois, assurez-vous que le sélecteur Autoriser Amazon Q à modifier les fichiers de flux de travail est réglé sur l'état actif. Créez le problème pour revenir au tableau des problèmes.

    Astuce

    Vous pouvez rechercher des fichiers, y compris des fichiers de flux de travail, en saisissant le symbole arobase (@) et en saisissant le nom du fichier.

Une fois que vous avez créé et attribué les problèmes, ceux-ci seront transférés dans En cours. Amazon Q ajoutera des commentaires pour suivre sa progression dans le numéro dans un commentaire épinglé. S'il est en mesure de définir une approche pour une solution, il mettra à jour la description du problème avec une section Contexte contenant son analyse de la base de code et une section Approche qui détaille l'approche proposée pour créer une solution. Si Amazon Q parvient à trouver une solution au problème décrit dans le problème, il créera une branche et modifiera le code dans cette branche afin de mettre en œuvre la solution proposée. Si le code proposé présente des similitudes avec du code open source connu par Amazon Q, Amazon Q fournira un fichier contenant des liens vers ce code afin que vous puissiez le consulter. Une fois que le code est prêt, il crée une pull request afin que vous puissiez consulter les modifications de code suggérées, ajoute un lien vers cette pull request vers le problème et déplace le problème en cours de révision.

Important

Vous devez toujours vérifier toute modification de code dans une pull request avant de la fusionner. La fusion des modifications de code effectuées par Amazon Q, comme toute autre modification de code, peut avoir un impact négatif sur votre base de code et votre code d'infrastructure si le code fusionné n'est pas correctement révisé et contient des erreurs lors de la fusion.

Pour examiner un problème et une demande d'extraction liée contenant des modifications apportées par Amazon Q

  1. Dans Problèmes, choisissez un problème attribué à Amazon Q qui est en cours. Consultez les commentaires pour suivre la progression d'Amazon Q. Le cas échéant, examinez le contexte et l'approche enregistrés dans la description du problème. Si vous avez choisi d'autoriser Amazon Q à suggérer des tâches, passez en revue toutes les tâches proposées et prenez les mesures nécessaires. Par exemple, si Amazon Q a suggéré des tâches et que vous souhaitez modifier l'ordre ou attribuer des tâches à des utilisateurs spécifiques, choisissez Modifier, ajouter ou réorganiser les tâches et effectuez les mises à jour nécessaires. Lorsque vous avez terminé de consulter le problème, choisissez X pour fermer le volet du problème.

    Astuce

    Pour consulter la progression des tâches, sélectionnez-la dans la liste des tâches du numéro. Les tâches n'apparaissent pas en tant qu'éléments distincts sur le tableau et ne sont accessibles que par le biais d'un problème. Si une tâche est attribuée à Amazon Q, vous devez l'ouvrir pour approuver les actions qu'elle souhaite effectuer. Vous devez également ouvrir une tâche pour voir toutes les demandes d'extraction liées, car elles n'apparaîtront pas sous forme de liens dans le numéro, mais uniquement dans la tâche. Pour revenir à un problème à partir d'une tâche, choisissez le lien vers le problème.

  2. Choisissez maintenant un problème attribué à Amazon Q qui est en cours de révision. Passez en revue le contexte et l'approche enregistrés dans la description du problème. Passez en revue les commentaires pour comprendre les actions qu'il a effectuées. Passez en revue toutes les tâches créées pour les travaux liés à ce problème, y compris leur progression, les actions que vous pourriez avoir besoin de prendre et les commentaires éventuels. Dans Pull requests, choisissez le lien vers la pull request à côté de l'étiquette Open pour consulter le code.

    Astuce

    Les demandes d'extraction générées pour les tâches apparaissent uniquement sous forme de demandes d'extraction liées dans la vue des tâches. Elles n'apparaissent pas sous forme de pull requests liées au problème.

  3. Dans la pull request, vérifiez les modifications de code. Pour de plus amples informations, veuillez consulter Révision d’une demande pull. Laissez des commentaires sur la pull request si vous souhaitez qu'Amazon Q modifie l'un des codes suggérés. Pour de meilleurs résultats, soyez précis lorsque vous laissez des commentaires pour Amazon Q.

    Par exemple, lorsque vous examinez la pull request créée pourCreate another mysfit named Quokkapus, vous remarquerez peut-être qu'il y a une faute de frappe dans la description. Vous pouvez laisser un commentaire pour Amazon Q indiquant « Modifiez la description pour corriger la faute de frappe « needsa » en ajoutant un espace entre « needs » et « a » ». Vous pouvez également laisser un commentaire demandant à Amazon Q de mettre à jour la description et de fournir l'intégralité de la description révisée pour qu'elle puisse l'intégrer.

    Si vous avez téléchargé des images pour le nouveau MySfit sur le site Web, vous pouvez laisser un commentaire pour qu'Amazon Q mette à jour le MySfit avec des pointeurs vers l'image et une miniature à utiliser pour le nouveau MySfit.

    Note

    Amazon Q ne répondra pas aux commentaires individuels. Amazon Q n'intégrera les commentaires laissés dans les commentaires des pull requests que si vous avez choisi l'option par défaut qui consiste à arrêter après chaque étape pour approbation lorsque vous avez créé le problème.

  4. (Facultatif) Une fois que vous et les autres utilisateurs du projet avez laissé tous les commentaires que vous souhaitez concernant les modifications apportées au code, choisissez Créer une révision pour qu'Amazon Q crée une révision de la pull request qui intègre les modifications que vous avez demandées dans les commentaires. L'avancement de la création des révisions sera indiqué par Amazon Q dans la section Vue d'ensemble, et non dans la section Modifications. Assurez-vous d'actualiser votre navigateur pour consulter les dernières mises à jour d'Amazon Q lors de la création de la révision.

    Note

    Seul l'utilisateur qui a créé le problème peut créer une révision de la pull request. Vous ne pouvez demander qu'une seule révision d'une pull request. Assurez-vous que vous avez résolu tous les problèmes liés aux commentaires et que vous êtes satisfait du contenu des commentaires avant de choisir Créer une révision.

  5. Dans cet exemple de projet, un flux de travail est exécuté pour chaque pull request. Assurez-vous qu'un flux de travail s'exécute correctement avant de fusionner la pull request. Vous pouvez également choisir de créer des flux de travail et des environnements supplémentaires pour tester le code avant de le fusionner. Pour de plus amples informations, veuillez consulter Commencer à utiliser les flux de travail.

  6. Lorsque vous êtes satisfait de la dernière révision de la pull request, choisissez Fusionner.

Créez un problème et demandez à Amazon Q de vous recommander des tâches

Un numéro peut parfois impliquer une charge de travail complexe ou longue. CodeCatalyst inclut l'intégration avec Amazon Q Developer Agent pour le développement de logiciels. Vous pouvez demander à Amazon Q d'analyser un problème en fonction de son titre et de sa description, et recommander une répartition logique du travail en tâches distinctes. Il tentera de créer une liste de tâches recommandées que vous pourrez ensuite revoir, modifier et choisir de créer ou non. Cela peut vous aider, vous et votre équipe, à attribuer des parties individuelles du travail aux utilisateurs de manière plus facile à gérer et à réaliser plus rapidement.

Pour créer et consulter une liste de tâches recommandées pour un problème

  1. Dans le volet de navigation, choisissez Problèmes et assurez-vous que vous êtes dans la vue Tableau.

  2. Choisissez Créer un problème.

  3. Donnez au numéro un titre qui explique ce que vous voulez faire en langage clair. Par exemple, pour ce numéro, entrez le titre deChange the get_all_mysfits() API to return mysfits sorted by the Good/Evil attribute. Dans Description, fournissez les informations suivantes :

    Update the API to allow sorting of mysfits by whether they are Good, Neutral, or Evil. Add a button on the website that allows users to quickly choose this sort and to exclude alignments that they don't want to see.

  4. Passez en revue la description et assurez-vous qu'elle contient tous les détails nécessaires avant de passer à l'étape suivante.

  5. Dans Destinataires, choisissez de vous attribuer le problème.

  6. Choisissez Créer un problème. Votre point de vue passe au tableau des problèmes.

  7. Choisissez le numéro que vous venez de créer pour l'ouvrir. Choisissez Recommander des tâches.

  8. Choisissez le référentiel source qui contient le code du problème. Choisissez Commencer à recommander des tâches.

La boîte de dialogue se ferme et Amazon Q commence à analyser le problème pour en déterminer la complexité. Si le problème est complexe, il proposera une répartition du travail en tâches séquentielles distinctes. Lorsque la liste est prête, choisissez Afficher les tâches recommandées. Vous pouvez ajouter des tâches supplémentaires, modifier les tâches recommandées et réorganiser les tâches. Si vous êtes d'accord avec les recommandations, choisissez Créer des tâches pour créer les tâches. Vous pouvez ensuite attribuer ces tâches aux utilisateurs pour qu'ils y travaillent, ou même à Amazon Q lui-même.

nettoyer des ressources ;

Une fois ce didacticiel terminé, envisagez de prendre les mesures suivantes pour nettoyer toutes les ressources que vous avez créées pendant ce didacticiel et dont vous n'avez plus besoin.

  • Annulez l'attribution à Amazon Q des problèmes qui ne sont plus résolus. Si Amazon Q a terminé ses travaux sur un problème ou n'a pas trouvé de solution, veillez à annuler l'attribution d'Amazon Q afin d'éviter d'atteindre le quota maximum pour les fonctionnalités d'IA génératives. Pour plus d'informations, consultez la section Gestion des fonctionnalités génératives de l'IA et de la tarification.

  • Déplacez tous les problèmes pour lesquels le travail est terminé vers Terminé.

  • Si le projet n'est plus nécessaire, supprimez-le.