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 à d'autres utilisateurs du projet, utiliser des étiquettes pour vous aider à suivre votre travail, etc.

Suivez ces instructions pour créer un problème dans CodeCatalyst.

Pour créer un problème

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

2. Accédez au projet dans lequel vous souhaitez créer un problème.

3. Sur la page d'accueil du projet, choisissez Créer un problème. Sinon, dans le volet de navigation, sélectionnez Problèmes.

4. Choisissez Créer un problème.

   Note

   Vous pouvez également ajouter des problèmes en ligne lorsque vous utilisez une vue en grille.

5. Entrez le titre du numéro.

6. (Facultatif) Entrez une description. Vous pouvez utiliser Markdown pour ajouter du formatage.

7. (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.

8. (Facultatif) Ajoutez des tâches au problème. Les tâches peuvent être utilisées pour décomposer le travail lié à un problème en objectifs plus petits. Pour ajouter une tâche, choisissez + Ajouter des tâches. Entrez 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 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.

9. (Facultatif) Ajoutez une étiquette existante ou créez-en une nouvelle et ajoutez-la en choisissant + Ajouter une étiquette.

   1. 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.

   2. 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.

10. (Facultatif) Ajoutez un destinataire en choisissant + Ajouter un destinataire. Vous pouvez rapidement vous ajouter en tant que cessionnaire en choisissant + M'ajouter.

    Astuce

    Vous pouvez choisir d'attribuer un problème à Amazon Q pour qu'Amazon Q essaie de le résoudre. Pour plus d’informations, consultez 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 d'IA générative.

11. (Facultatif) Ajoutez un champ personnalisé existant ou créez-en un nouveau. Les problèmes peuvent comporter plusieurs champs personnalisés.

    1. 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.

    2. 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.

12. 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 apparaît. Vous pouvez ensuite choisir Réessayer pour modifier et réessayer de créer le problème, ou choisir Ignorer pour ignorer le problème. Les deux options annuleront la notification.

    Note

    Vous ne pouvez pas lier une pull request à un problème lorsque vous la créez. Cependant, vous pouvez le modifier après l'avoir créé pour ajouter des liens vers des pull requests.

Bonnes pratiques lors de la création et du traitement des problèmes assigné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 qu'on ne sait pas exactement qui devrait 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 à d'autres problèmes. Souvent, il faut d'abord s'occuper d'autres travaux urgents. 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 avec un assistant d'intelligence artificielle 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, tandis qu'Amazon Q travaille sur une solution aux problèmes que vous ne disposez pas des ressources nécessaires pour résoudre immédiatement.

Note

Propulsé par Amazon Bedrock : AWS implémente la détection automatique des abus. La fonctionnalité Attribuer des problèmes à Amazon Q avec Amazon Q Developer Agent pour le développement de logiciels étant basée 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 est le plus performant pour résoudre les problèmes simples et 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).

• Restez simple. Amazon Q fait de son mieux avec des modifications de code simples et des correctifs qui peuvent être expliqués dans le titre et la description du problème. N'attribuez pas de problèmes à des titres vagues ou à des descriptions trop fleuries ou contradictoires.

• Soyez précis. Plus vous fournirez 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 capable 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 auquel vous pouvez penser.

• Assurez-vous d'avoir inclus tous les détails 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.

• N'attribuez que 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 suggéré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 des commentaires non seulement sur le problème, mais également sur toute pull request qu'il crée. Cela fournit une expérience plus interactive avec Amazon Q qui vous permet d'ajuster son approche et d'affiner le code qu'il crée pour résoudre le problème.

  Note

  Amazon Q ne répond pas aux commentaires individuels relatifs aux problèmes ou aux pull requests, mais il les examinera lorsqu'il lui sera 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 en fonction 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 les 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 sont peut-être configurés pour démarrer des exécutions lors d'événements de pull request. Dans ce cas, toute pull request créée par Amazon Q qui inclut la création ou la mise à jour du flux de travail YAML peut démarrer une exécution des flux de travail inclus dans la pull request. Il est recommandé de ne pas autoriser Amazon Q à travailler sur des fichiers de flux de travail, sauf si vous êtes certain qu'aucun flux de travail de votre projet n'exécutera automatiquement ces flux de travail avant de consulter et d'approuver 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 d'IA générative.