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.
Création d'un problème dans CodeCatalyst
Les équipes de développement créent des problèmes pour faciliter le suivi et la gestion de leur travail. Vous pouvez créer des problèmes au sein d'un projet en fonction de vos besoins. Par exemple, vous pouvez créer un problème pour suivre la mise à jour d'une variable dans votre code. Vous pouvez attribuer des problèmes aux autres utilisateurs du projet, utiliser des libellés pour vous aider à suivre votre travail, etc.
Suivez ces instructions pour créer un problème dans CodeCatalyst.
Pour créer un problème
Ouvrez la CodeCatalyst console à l'adresse https://codecatalyst.aws/
. -
Accédez au projet pour lequel vous souhaitez créer un problème.
-
Sur la page d'accueil du projet, choisissez Créer un problème. Vous pouvez également sélectionner Problèmes dans le volet de navigation.
-
Choisissez Créer un problème.
Note
Vous pouvez également ajouter des problèmes en ligne lorsque vous utilisez une vue en grille.
-
Entrez le titre du numéro.
-
(Facultatif) Entrez une description. Vous pouvez utiliser Markdown pour ajouter une mise en forme.
-
(Facultatif) Choisissez un statut, une priorité et une estimation pour le problème.
Note
Si le paramètre d'estimation du projet est défini sur Masquer les estimations, il n'y aura pas de champ Estimation.
-
(Facultatif) Ajoutez des tâches au problème. Les tâches peuvent être utilisées pour diviser le travail sur une question en objectifs plus petits. Pour ajouter une tâche, choisissez + Ajouter des tâches. Saisissez ensuite le nom de la tâche dans le champ de texte et appuyez sur Entrée. Après avoir ajouté des tâches, vous pouvez les marquer comme étant terminées en cochant la case, ou les réorganiser en choisissant et en faisant glisser la tâche depuis le côté gauche de la case à cocher.
-
(Facultatif) Ajoutez une étiquette existante ou créez une nouvelle étiquette et ajoutez-la en choisissant + Ajouter une étiquette.
-
Pour ajouter une étiquette existante, choisissez-la dans la liste. Vous pouvez saisir un terme de recherche dans le champ pour rechercher toutes les étiquettes contenant ce terme dans le projet.
-
Pour créer une nouvelle étiquette et l'ajouter, entrez le nom de l'étiquette que vous souhaitez créer dans le champ de recherche et appuyez sur Entrée.
-
-
(Facultatif) Ajoutez un cessionnaire en choisissant + Ajouter un cessionnaire. Vous pouvez rapidement vous ajouter en tant que personne assignée en choisissant + Ajoutez-moi.
Astuce
Vous pouvez choisir d'attribuer un problème à Amazon Q pour qu'Amazon Q essaie de le résoudre. Pour de plus amples informations, veuillez consulter Tutoriel : Utiliser les fonctionnalités CodeCatalyst génératives de l'IA pour accélérer votre travail de développement. Cette fonctionnalité n'est disponible que dans la région Ouest des États-Unis (Oregon).
Cette fonctionnalité nécessite que les fonctionnalités d'IA génératives soient activées pour l'espace. Pour plus d'informations, consultez la section Gestion des fonctionnalités génératives d'IA.
-
(Facultatif) Ajoutez un champ personnalisé existant ou créez un nouveau champ personnalisé. Les problèmes peuvent comporter plusieurs champs personnalisés.
-
Pour ajouter un champ personnalisé existant, choisissez-le dans la liste. Vous pouvez saisir un terme de recherche dans le champ pour rechercher tous les champs personnalisés contenant ce terme dans le projet.
-
Pour créer un nouveau champ personnalisé et l'ajouter, entrez le nom du champ personnalisé que vous souhaitez créer dans le champ de recherche et appuyez sur Entrée. Choisissez ensuite le type de champ personnalisé que vous souhaitez créer et définissez une valeur.
-
-
Choisissez Créer un problème. Une notification apparaît dans le coin inférieur droit : si le problème a été créé avec succès, un message de confirmation apparaît indiquant que le problème a été créé avec succès. Si le problème n'a pas été créé correctement, un message d'erreur indiquant la raison de l'échec s'affiche. Vous pouvez ensuite choisir Réessayer pour modifier et réessayer de créer le problème, ou choisir Ignorer pour supprimer le problème. Les deux options supprimeront la notification.
Note
Vous ne pouvez pas lier une pull request à un problème lorsque vous le créez. Cependant, vous pouvez le modifier après l'avoir créé pour ajouter des liens vers les pull requests.
Meilleures pratiques lors de la création et de la résolution de problèmes attribués à Amazon Q
Lorsque vous créez des problèmes, certains d'entre eux persistent parfois. Les causes peuvent être complexes et variables. Parfois, c'est parce que l'on ne sait pas qui doit y travailler. D'autres fois, le problème nécessite des recherches ou une expertise sur une partie particulière de la base de code et les meilleurs candidats pour le travail sont occupés par d'autres problèmes. Souvent, il y a d'autres travaux urgents qui doivent être effectués en premier. L'une ou l'ensemble de ces causes peuvent entraîner des problèmes qui ne sont pas résolus. CodeCatalyst inclut l'intégration à 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 le 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.
Note
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).
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. Voici quelques bonnes pratiques qui vous aideront à créer des problèmes optimisés pour qu'Amazon Q puisse les résoudre.
Important
Les fonctionnalités d'IA générative ne sont disponibles que dans la région Ouest des États-Unis (Oregon).
-
Faites en sorte que ce soit simple. Amazon Q obtient de meilleurs résultats avec de simples modifications de code et des correctifs qui peuvent être expliqués dans le titre et la description du problème. N'attribuez pas les numéros avec des titres vagues ou des descriptions trop fleuries ou contradictoires.
-
Soyez précis. Plus vous pouvez fournir d'informations sur les modifications exactes nécessaires pour résoudre le problème, plus Amazon Q sera en mesure de créer une solution permettant de résoudre le problème. Si possible, incluez des détails spécifiques tels que le nom des API que vous souhaitez modifier, les méthodes que vous souhaitez mettre à jour, les tests nécessitant des modifications et tout autre détail que vous pouvez imaginer.
-
Assurez-vous que tous les détails sont inclus dans le titre et la description du problème avant de l'attribuer à Amazon Q. Vous ne pouvez pas modifier le titre ou la description d'un problème une fois que vous l'avez attribué à Amazon Q. Assurez-vous donc de disposer de toutes les informations requises dans un numéro avant de l'attribuer à Amazon Q.
-
Attribuez uniquement les problèmes nécessitant des modifications de code dans un seul référentiel source. Amazon Q ne peut travailler que sur le code d'un seul référentiel source dans CodeCatalyst. Les référentiels liés ne sont pas pris en charge. Assurez-vous que le problème ne nécessite que des modifications dans un seul référentiel source avant de l'attribuer à Amazon Q.
-
Utilisez la valeur par défaut proposée par Amazon Q pour approuver chaque étape. Par défaut, Amazon Q aura besoin de votre approbation pour chaque étape. Cela vous permet d'interagir avec Amazon Q dans les commentaires, non seulement sur le problème, mais également sur toute demande d'extraction qu'il crée. Cela fournit une expérience plus interactive avec Amazon Q qui vous aide à ajuster son approche et à affiner le code créé pour résoudre le problème.
Note
Amazon Q ne répond pas aux commentaires individuels concernant les problèmes ou les demandes d'extraction, mais il les examine lorsqu'il lui est demandé de reconsidérer son approche ou de créer une révision.
-
Lisez toujours attentivement l'approche suggérée par Amazon Q. Une fois que vous aurez approuvé son approche, Amazon Q commencera à générer du code sur la base de cette approche. Assurez-vous que l'approche semble correcte et inclut tous les détails que vous attendez avant de demander à Amazon Q de continuer.
-
Assurez-vous de n'autoriser Amazon Q à travailler sur des flux de travail que si vous ne disposez pas de flux de travail existants susceptibles de les déployer avant leur révision. 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.
Pour plus d'informations, consultez la section Gestion Tutoriel : Utiliser les fonctionnalités CodeCatalyst génératives de l'IA pour accélérer votre travail de développement des fonctionnalités génératives d'IA.
