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.
# Amazon Q Developer pour GitHub (version préliminaire)
**Note**
Amazon Q Developer pour GitHub est actuellement disponible en version préliminaire et susceptible d’être modifié.
[Amazon Q Developer pour GitHub ou GitHub Enterprise Cloud](https://github.com/marketplace/amazon-q-developer) vous permet de tirer parti des fonctionnalités d’Amazon Q Developer pour vos flux de travail de développement logiciel. Avec des agents de développement spécialisés, vous pouvez mettre en œuvre de nouvelles idées, examiner le code pour détecter les problèmes de qualité et corriger les vulnérabilités grâce à des tests unitaires. Une fois que l’agent a terminé une tâche, vous pouvez fournir des commentaires et l’agent répète la solution précédente. Pour de plus amples informations, veuillez consulter [Agents Amazon Q Developer](#github-agents).
Vous pouvez accéder à l’intégration d’Amazon Q Developer via [https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer) et l’autoriser à fournir un accès aux référentiels de votre organisation. Pour commencer à utiliser Amazon Q Developer pour GitHub, consultez [Démarrage rapide : installation, utilisation de fonctionnalités dans GitHub et augmentation des limites d’utilisation](github-quickstart.md).
**Important**
Pour installer l’application Amazon Q Developer et autoriser l’accès aux référentiels GitHub, vous devez satisfaire aux exigences de l’organisation GitHub. Pour plus d’informations, consultez [Requirements to install a GitHub App](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) et [Rôles dans une organisation](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization) dans la *documentation GitHub*.
**Note**
L’intégration d’Amazon Q Developer avec GitHub traites les données aux États-Unis. Pour plus d’informations, consultez [Traitement entre régions dans Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/cross-region-processing.html).
**Note**
Amazon Q Developer pour GitHub (version préliminaire) n’utilise pas votre contenu pour améliorer le service à l’heure actuelle. Si nous l’autorisons à l’avenir, nous vous en informerons suffisamment à l’avance et nous vous fournirons un moyen de vous opposer à une telle utilisation.
**Topics**
+ [Installation de l’application Amazon Q Developer et autorisation d’accès](#github-concepts-set-up)
+ [Agents Amazon Q Developer](#github-agents)
+ [Enregistrement de l’installation de l’application](#github-concepts-register-app-install)
+ [Utilisation des extensions de navigateur dans GitHub](#github-concepts-extensions)
+ [Utilisation de commandes slash dans les problèmes GitHub et les demandes de tirage](#github-slash-commands)
+ [Démarrage rapide : installation, utilisation de fonctionnalités dans GitHub et augmentation des limites d’utilisation](github-quickstart.md)
+ [Développement de fonctionnalités et itération avec Amazon Q Developer dans GitHub](github-feature-development.md)
+ [Révision du code avec Amazon Q Developer dans GitHub](github-code-reviews.md)
+ [Augmentation des limites d’utilisation et des détails de configuration dans la console Amazon Q Developer](github-register-app-install.md)
+ [Configuration des détails de l’installation enregistrée](github-configuration.md)
+ [Résolution des problèmes liés à Amazon Q Developer pour GitHub](github-troubleshooting.md)
## Installation de l’application Amazon Q Developer et autorisation d’accès
En tant qu'administrateur d'GitHuborganisation, vous pouvez installer et configurer l'application Amazon Q Developer [https://github.com/apps/amazon-q-developer](https://github.com/apps/amazon-q-developer)gratuitement sans avoir besoin de créer un AWS compte pour commencer. Au cours du processus d’installation, vous choisissez de fournir l’accès à tous les référentiels de votre organisation GitHub ou à certains d’entre eux. Après l’installation et l’autorisation, vous avez accès à une utilisation gratuite des fonctionnalités d’Amazon Q Developer dans GitHub. Vous pouvez augmenter l’utilisation gratuite en enregistrant l’installation de l’application dans la [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github). Pour de plus amples informations, veuillez consulter [Démarrage rapide : installation, utilisation de fonctionnalités dans GitHub et augmentation des limites d’utilisation](github-quickstart.md).
**Important**
Pour installer l’application Amazon Q Developer et autoriser l’accès aux référentiels GitHub, vous devez satisfaire aux exigences de l’organisation GitHub. Pour plus d’informations, consultez [Requirements to install a GitHub App](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) et [Rôles dans une organisation](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization) dans la *documentation GitHub*.
**Note**
Si l’organisation de votre entreprise GitHub a activé la liste d’adresses IP autorisées, vous devez accepter les adresses IP autorisées dans l’application GitHub. Vous pouvez également choisir d’ajouter automatiquement les adresses IP à votre liste d’autorisations. Pour plus d’informations, consultez [Allowing access by GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps) et [Enabling allowed IP addresses](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#enabling-allowed-ip-addresses) dans la *documentation GitHub*.
Les adresses IP suivantes sont utilisées pour accéder à vos ressources GitHub :
```
34.228.181.128
44.219.176.187
54.226.244.221
```
## Agents Amazon Q Developer
Les agents Amazon Q Developer fournissent une assistance tout au long du cycle de développement logiciel, depuis le codage, les tests et le déploiement jusqu'au dépannage.
+ **Agent de développement Amazon Q** : après avoir créé un problème et ajouté l’étiquette de développement des fonctionnalités, Amazon Q Developer implémente automatiquement vos nouvelles fonctionnalités et correctifs de bogues. Amazon Q Developer crée une demande de tirage avec les modifications, ainsi qu’un récapitulatif des modifications. Au lieu d’appliquer une étiquette, vous pouvez également lancer le développement de fonctionnalités à l’aide de la commande slash `/q dev` dans un commentaire du problème. Pour de plus amples informations, veuillez consulter [Développement de fonctionnalités et itération avec Amazon Q Developer dans GitHub](github-feature-development.md).
+ **Agent de révision du code Amazon Q** : lorsqu’une nouvelle demande de tirage est créée ou si une demande de tirage fermée est ouverte à nouveau, Amazon Q Developer effectue automatiquement une révision du code et fournit des commentaires sur la qualité du code, les problèmes potentiels et les problèmes de sécurité. Amazon Q Developer génère également des correctifs pour les problèmes identifiés, que vous pouvez consulter et choisir de valider dans la demande de tirage. La révision du code inclut un résumé de la révision du code avec les résultats par fil de discussion. Vous pouvez interagir avec Amazon Q Developer en utilisant la commande `/q` contenue dans les commentaires de la demande de tirage pour poser des questions sur les résultats de la révision du code.
Les révisions automatiques du code ne sont pas déclenchées par les validations ultérieures effectuées dans le cadre d’une demande de tirage existante. Vous pouvez lancer des révisions de code supplémentaires dans le cadre des demandes de tirage à l’aide de la commande slash `/q review`. Pour de plus amples informations, veuillez consulter [Révision du code avec Amazon Q Developer dans GitHub](github-code-reviews.md).
**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](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) dans la *documentation GitHub*.
## Enregistrement de l’installation de l’application
L’intégration d’Amazon Q Developer pour GitHub est disponible gratuitement sans qu’il soit nécessaire de créer un compte AWS pour commencer. Vous bénéficiez d'un nombre limité d'appels par mois pour le développement de fonctionnalités, ainsi que d'un nombre limité de lignes pour les révisions de code par mois. Vous pouvez augmenter l’utilisation gratuite en enregistrant l’installation de l’application Amazon Q Developer avec votre compte AWS . Pour de plus amples informations, veuillez consulter [Augmentation des limites d’utilisation et des détails de configuration dans la console Amazon Q Developer](github-register-app-install.md).
**Important**
Pour enregistrer l’installation de l’application dans la console Amazon Q Developer, vous devez satisfaire aux exigences de l’organisation GitHub. Pour plus d'informations, consultez la section [Conditions requises pour installer une GitHub application](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app), [OAuth des applications et des organisations](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations) dans la *GitHubdocumentation*.
## Utilisation des extensions de navigateur dans GitHub
Vous pouvez utiliser l'extension Amazon Q Developer dans un navigateur compatible pour ajouter rapidement une étiquette pour le développement de fonctionnalités en cas de GitHub problème, sans avoir à effectuer de recherche dans les menus d'étiquettes.
L’extension Amazon Q Developer est disponible pour les navigateurs suivants :
+ [Google Chrome](https://chromewebstore.google.com/detail/amazon-q-github-issue-hel/oefafjbablenakmhacfllkmpaeabnnfi)
+ [Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/amazon-q-github-issue-helper)
+ [Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/amazon-q-github-issue-helper/poghackjbfhejeppjaegbnblangjbmmc)
## Utilisation de commandes slash dans les problèmes GitHub et les demandes de tirage
Vous pouvez utiliser des commandes slash dans les problèmes relatifs aux problèmes avec GitHub ou les demandes de tirage pour invoquer Amazon Q Developer afin d’effectuer des tâches de développement ou de fournir une assistance.
+ `/q dev` : invoque Amazon Q Developer dans un problème avec GitHub pour implémenter automatiquement les nouvelles fonctionnalités et corriger les bogues. Amazon Q Developer crée une demande de tirage avec les modifications, ainsi qu’un récapitulatif des modifications.
+ `/q review` : invoque Amazon Q Developer pour effectuer automatiquement des révisions de code lorsque des demandes de tirage sont créées ou rouvertes. Les révisions de code fournissent des commentaires sur la qualité du code, les problèmes potentiels et les problèmes de sécurité, ainsi que des suggestions de correctifs et des résumés des révisions de code avec les résultats des analyses de code par fil de discussion. Utilisez `/q` dans les commentaires des demandes de tirage pour interagir avec les résultats. Les révisions automatiques ne sont pas déclenchées par les validations ultérieures des demandes de tirage existantes.
+ `/q help` : fournit des informations sur Amazon Q Developer pour GitHub, y compris les commandes slash, les fonctionnalités, les détails de personnalisation, ainsi qu’un lien vers la documentation [Amazon Q Developer pour GitHub (version préliminaire)](#amazon-q-for-github) du *Guide du développeur Amazon Q Developer*.
# Démarrage rapide : installation, utilisation de fonctionnalités dans GitHub et augmentation des limites d’utilisation
**Note**
Amazon Q Developer pour GitHub est actuellement disponible en version préliminaire et susceptible d’être modifié.
Ce didacticiel décrit les tâches suivantes :
1. Installez l’application Amazon Q Developer depuis GitHub Marketplace et donnez accès à vos référentiels.
1. Commencez avec Amazon Q Developer pour résoudre un problème en ajoutant une étiquette pour le développement de fonctionnalités ou en créant une nouvelle pull request pour la révision du code. Vous pouvez également utiliser des commandes slash en cas de problème pour lancer le développement de fonctionnalités. Vous pouvez également lancer des révisions de code supplémentaires dans les demandes de tirage à l’aide d’une commande slash.
1. (Facultatif) Enregistrez l'installation de l'application Amazon Q Developer avec votre AWS compte pour augmenter vos limites d'utilisation.
## Étape 1 : installation d’Amazon Q Developer dans GitHub et autorisation d’accès
Vous pouvez utiliser Amazon Q Developer GitHub gratuitement sans avoir besoin de créer un AWS compte pour commencer. La première étape pour utiliser Amazon Q Developer dans GitHub consiste à installer l’application depuis [https://github.com/marketplace/amazon-q-developer](https://github.com/marketplace/amazon-q-developer). Au cours de ce processus, vous pouvez fournir à Amazon Q Developer l’accès à tous vos référentiels GitHub ou à des référentiels sélectionnés.
**Important**
Pour installer l’application Amazon Q Developer et autoriser l’accès aux référentiels GitHub, vous devez satisfaire aux exigences de l’organisation GitHub. Pour plus d’informations, consultez [Requirements to install a GitHub App](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app) et [Rôles dans une organisation](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization) dans la *documentation GitHub*.
**Pour installer Amazon Q Developer et autoriser l’accès**
1. Accédez à la page [Amazon Q Developer pour l’application GitHub](https://github.com/marketplace/amazon-q-developer).
1. Si nécessaire, connectez-vous à votre [compte GitHub](https://github.com/) en utilisant vos informations d’identification GitHub.
1. Consultez la présentation et les fonctionnalités de l’application Amazon Q Developer, puis choisissez **Installer**.
1. Effectuez l’une des actions suivantes pour configurer l’accès à vos référentiels GitHub :
1. Pour fournir un accès à tous les référentiels actuels et futurs, choisissez **Tous les référentiels**.
1. Pour fournir un accès à des référentiels spécifiques, choisissez **Ne sélectionner que les référentiels**, choisissez le menu déroulant **Sélectionnez les référentiels**, puis choisissez un référentiel auquel vous souhaitez autoriser l’accès.
1. Choisissez **Installer** pour terminer l’installation d’Amazon Q Developer dans GitHub et l’autoriser à accéder à vos référentiels.
Après avoir installé l’application GitHub et autorisé l’accès, vous êtes redirigé vers la page de présentation d’Amazon Q Developer dans GitHub. Vous pouvez accéder à votre référentiel GitHub pour commencer à utiliser les fonctionnalités d’Amazon Q Developer.
**Note**
Si l’organisation de votre entreprise GitHub a activé la liste d’adresses IP autorisées, vous devez accepter les adresses IP autorisées dans l’application GitHub. Vous pouvez également choisir d’ajouter automatiquement les adresses IP à votre liste d’autorisations. Pour plus d’informations, consultez [Allowing access by GitHub Apps](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps) et [Enabling allowed IP addresses](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#enabling-allowed-ip-addresses) dans la *documentation GitHub*.
Les adresses IP suivantes sont utilisées pour accéder à vos ressources GitHub :
```
34.228.181.128
44.219.176.187
54.226.244.221
```
## Étape 2 : utilisation des fonctionnalités d’Amazon Q Developer dans GitHub
Après avoir installé l'application Amazon Q Developer GitHub et autorisé l'accès à vos référentiels, vous pouvez commencer à utiliser les agents Amazon Q Developer pour obtenir de l'assistance tout au long du cycle de développement logiciel, depuis le codage, les tests et le déploiement jusqu'au dépannage des applications. Pour plus d’informations, consultez :
**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](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) dans la *documentation GitHub*.
+ [Développement de fonctionnalités et itération avec Amazon Q Developer dans GitHub](github-feature-development.md)
+ [Révision du code avec Amazon Q Developer dans GitHub](github-code-reviews.md)
## Étape 3 : augmentation des limites d’utilisation gratuite et configuration des détails
Vous pouvez utiliser les agents Amazon Q Developer dans GitHub gratuitement sans avoir besoin de créer un compte AWS pour commencer. Vous recevez un nombre limité d'appels par mois pour le développement de fonctionnalités et la révision du code. Vous pouvez augmenter votre utilisation gratuite à tout moment en enregistrant l'installation de l'application Amazon Q Developer sur votre AWS compte. L’enregistrement permet également de configurer des détails tels que la désactivation des révisions de code et l’ajout de balises pour la recherche et le filtrage. Pour de plus amples informations, veuillez consulter [Augmentation des limites d’utilisation et des détails de configuration dans la console Amazon Q Developer](github-register-app-install.md).
**Important**
Pour enregistrer l’installation de l’application dans la console Amazon Q Developer, vous devez satisfaire aux exigences de l’organisation GitHub. Pour plus d'informations, consultez la section [Conditions requises pour installer une GitHub application](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app), [OAuth des applications et des organisations](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations) dans la *GitHubdocumentation*.
# 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](github-register-app-install.md).
**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](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) 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](https://github.com/) en utilisant vos informations d’identification GitHub.
1. Accédez à votre organisation GitHub, puis au référentiel dans lequel vous souhaitez implémenter de nouvelles fonctionnalités avec Amazon Q Developer.
1. 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](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/creating-an-issue) 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](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/editing-an-issue) dans la *documentation GitHub*.
1. 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.
1. Choisissez **Comment (Commentaire)**.
1. 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](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/editing-an-issue) 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.
1. 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.
1. Cliquez sur l’onglet **Fichiers modifiés** pour afficher les modifications du code.
1. 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](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request).
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.
1. Facultativement, pour les lignes de code spécifiques sur lesquelles vous souhaitez fournir des commentaires, choisissez **\$1** 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.
1. 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 selon les besoins.
1. 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](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request).
# Révision du code avec Amazon Q Developer dans GitHub
**Note**
Amazon Q Developer pour GitHub est actuellement disponible en version préliminaire et susceptible d’être modifié.
Amazon Q Developer permet des révisions de code automatisées au sein de GitHub. Lorsque vous créez une nouvelle demande de tirage ou que vous ouvrez à nouveau une demande de tirage fermée, Amazon Q Developer effectue automatiquement une révision du code et fournit un feedback sur la qualité du code, les problèmes potentiels et les résultats de gravité élevée. Chaque révision inclut un résumé de la révision du code avec les résultats par fil de discussion. Amazon Q Developer génère également des correctifs pour les problèmes identifiés, que vous pouvez consulter et choisir de valider dans la demande de tirage. Vous pouvez utiliser la commande `/q` dans les commentaires de la demande de tirage pour poser des questions et interagir concernant les résultats de la révision du code. Les révisions automatiques du code ne sont pas déclenchées par les validations ultérieures effectuées dans le cadre d’une demande de tirage existante.
**Note**
Le paramètre de fonctionnalité de révision du code dans la console Amazon Q Developer contrôle les révisions de code automatisées qui s'exécutent lorsque des pull requests sont créées ou rouvertes. Le lancement de révisions de code à l'aide de la commande `/q review` slash dans les commentaires de pull request n'est pas affecté par ce paramètre.
Vous pouvez également lancer des révisions de code dans le cadre des demandes de tirage à l’aide de la commande slash `/q review`. La commande slash peut être ajoutée à un nouveau commentaire de demande de tirage, ce qui lance une nouvelle révision du code de la demande de tirage dans son état actuel, y compris les commentaires et les nouvelles validations. Pour de plus amples informations, veuillez consulter [Lancement des révisions de code dans le cadre des demandes de tirage GitHub](#github-code-reviews-in-pr).
Vous pouvez demander à Amazon Q Developer d’effectuer une révision du code pour un nombre limité de lignes 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](github-register-app-install.md).
**Note**
Si la fonctionnalité de révision du code a déjà été désactivée, elle doit être activée dans la [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github) pour que vous puissiez apposer l’étiquette dans GitHub. Pour de plus amples informations, veuillez consulter [Fonctionnalités d’édition pour Amazon Q Developer dans GitHub](github-configuration.md#github-edit-features).
## Conditions préalables
Avant de pouvoir lancer des révisions de code avec Amazon Q Developer, vous devez disposer des autorisations appropriées pour le référentiel GitHub cible. Les rôles de référentiel pris en charge sont l’écriture, la gestion ou l’administration. Les utilisateurs dotés de rôles de lecture ou de triage, ainsi que les membres sans rôle, ne peuvent pas lancer de révision de code avec Amazon Q Developer.
Les utilisateurs GitHub dotés du rôle de triage peuvent toujours consulter les demandes de tirage dans un référentiel. Tout utilisateur, quel que soit son rôle, peut consulter les demandes de tirage dans les référentiels publics.
Pour plus d’informations, consultez [Rôles de dépôt pour des organisations](https://docs.github.com/en/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization#repository-roles-for-organizations) et [About pre-defined organization roles](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#about-pre-defined-organization-roles) dans la *documentation GitHub*.
## Lancement des révisions de code pour les demandes de tirage GitHub
Lorsque vous ouvrez une nouvelle demande de tirage ou que vous ouvrez à nouveau une demande précédemment clôturée, Amazon Q Developer effectue automatiquement une révision du code et fournit un feedback sur la qualité du code, les problèmes éventuels et les résultats critiques.
**Pour utiliser Amazon Q Developer pour réviser le code et appliquer des correctifs**
Avant de commencer une révision, vous pouvez personnaliser une évaluation de la qualité du code en définissant des normes de codage personnalisées dans de simples fichiers Markdown du répertoire `project-root/.amazonq/rules`. Amazon Q suit automatiquement vos directives, garantissant ainsi une qualité de code constante tout au long de votre projet. Pour de plus amples informations, veuillez consulter [Création de règles de projet pour Amazon Q Developer sur des plateformes tierces](third-party-context-project-rules.md).
1. Si nécessaire, connectez-vous à votre [compte GitHub](https://github.com/) en utilisant vos informations d’identification GitHub.
1. Accédez à votre organisation GitHub, puis au référentiel dans lequel vous souhaitez effectuer une révision de code avec Amazon Q Developer.
1. Créez une nouvelle demande de tirage pour les modifications apportées à votre code source. Pour plus d’informations, consultez [Création d’une demande de tirage](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) dans la *documentation GitHub*.
Lorsque vous créez une nouvelle demande de tirage, Amazon Q Developer lance automatiquement une révision du code afin de détecter les problèmes potentiels. Une fois qu’Amazon Q Developer a terminé la révision, il fournit un résumé de la révision du code. Chaque résultat apparaît sous forme de commentaire de fil de discussion sous le résumé, accompagné de suggestions de corrections que vous pouvez appliquer à la demande de tirage.
1. Demandez à l'agent d'implémenter les modifications et de créer des validations directement sur la branche source de votre pull request. Vous pouvez le faire en publiant un commentaire commençant par `/q` et suivi de votre demande en langage naturel pour que l'agent apporte des modifications.
1. (Facultatif) Posez des questions sur des résultats spécifiques. Dans la demande de tirage, accédez à **Ajouter un commentaire**, puis dans le champ de saisie du texte du commentaire, entrez `/q` suivi de votre question (par exemple, « `/q explain the importance of this finding` »).
1. Passez en revue les modifications de code proposées par Amazon Q Developer, choisissez **Valider la suggestion**, puis choisissez **Valider les modifications** pour mettre à jour la demande de tirage.
1. Si vous êtes satisfait des corrections de code suggérées, vous pouvez fusionner la demande de tirage pour appliquer les modifications de code suggérées par Amazon Q Developer. Pour plus d’informations, consultez [Fusion d’une demande de tirage](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request) dans la *documentation GitHub*.
## Lancement des révisions de code dans le cadre des demandes de tirage GitHub
Après une révision automatique du code effectuée par Amazon Q Developer pour une demande de tirage GitHub nouvelle ou ouverte à nouveau, vous pouvez lancer des révisions de code supplémentaires pour itérer votre code à l’aide de la commande slash `/q review`. La révision du code est effectuée sur l’intégralité de la vue comparative de la demande de tirage.
**Note**
Vous ne pouvez lancer une révision de code que dans le cadre d’une demande de tirage avec un nouveau commentaire. La commande slash `/q review` ne fonctionnera pas dans un fil de commentaires existant. Le lancement d'une révision de code à l'aide de la commande `/q review` slash n'est pas affecté par le paramètre de fonctionnalité de révision de code dans la console Amazon Q Developer.
**Pour utiliser le lancement des révisions de code dans une demande de tirage**
1. Si nécessaire, connectez-vous à votre [compte GitHub](https://github.com/) en utilisant vos informations d’identification GitHub.
1. Accédez à votre organisation GitHub, puis à la demande de tirage pour laquelle vous souhaitez effectuer une révision de code avec Amazon Q Developer. Pour plus d’informations, consultez [À propos des demandes de tirage (pull requests)](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests).
1. Dans la demande de tirage, accédez **Ajouter un commentaire**, puis saisissez `/q review` dans le champ de saisie du texte du commentaire.
1. Choisissez **Commentaire** pour lancer la révision du code.
L’analyse du code de demande de tirage par Amazon Q Developer peut prendre quelques minutes. Une fois l’analyse terminée, Amazon Q Developer fournit un résumé de la révision du code. Chaque résultat apparaît sous forme de commentaire dans un fil de discussion sous le résumé, avec les modifications proposées que vous pouvez choisir pour valider et mettre à jour la demande de tirage.
1. (Facultatif) Posez des questions sur des résultats spécifiques. Dans la demande de tirage, accédez à **Ajouter un commentaire**, puis dans le champ de saisie du texte du commentaire, entrez `/q` suivi de votre question (par exemple, « `/q explain the importance of this finding` »).
1. Si vous êtes satisfait des corrections de code suggérées, vous pouvez fusionner la demande de tirage pour appliquer les modifications de code suggérées par Amazon Q Developer. Pour plus d’informations, consultez [Fusion d’une demande de tirage](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request) dans la *documentation GitHub*.
# Augmentation des limites d’utilisation et des détails de configuration dans la console Amazon Q Developer
**Note**
Amazon Q Developer pour GitHub est actuellement disponible en version préliminaire et susceptible d’être modifié.
Vous pouvez utiliser les agents Amazon Q Developer GitHub gratuitement sans avoir besoin de créer un AWS compte pour commencer. Vous recevez un nombre limité d'appels par mois pour les fonctionnalités de développement des fonctionnalités et de révision du code. Vous pouvez augmenter votre utilisation gratuite à tout moment en enregistrant l'installation de l'application Amazon Q Developer sur votre AWS compte.
Par défaut, les **fonctionnalités de **révision du code** et de développement** de fonctionnalités sont activées GitHub lorsque vous installez l'application. Vous pouvez désactiver n’importe laquelle de ces fonctionnalités lors de votre enregistrement. L’enregistrement nécessite un profil Amazon Q Developer pour gérer les fonctionnalités depuis la console. Le profil enregistre vos paramètres et la personnalisation des recommandations de code.
**Important**
Pour enregistrer l’installation de l’application dans la console Amazon Q Developer, vous devez satisfaire aux exigences de l’organisation GitHub. Pour plus d'informations, consultez la section [Conditions requises pour installer une GitHub application](https://docs.github.com/en/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party#requirements-to-install-a-github-app), [OAuth des applications et des organisations](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-apps-and-organizations) dans la *GitHubdocumentation*.
**Pour enregistrer votre installation Amazon Q Developer**
1. Accédez à la [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home).
1. Choisissez **Enable Q Developer** en haut de la page, puis suivez les instructions pour activer Kiro et Amazon Q Developer.
Si vous avez déjà activé Kiro et Amazon Q Developer, passez à l'étape 3.
1. Dans le volet de navigation, sélectionnez **Amazon Q Developer dans GitHub**.
1. Choisissez **Enregistrer l’installation**, puis sélectionnez **Autoriser** pour être redirigé vers GitHub.
Si vous avez déjà autorisé Amazon Q Developer à accéder à votre organisation GitHub, vous serez redirigé vers la console Amazon Q Developer. Dans ce cas, passez à l'étape 7.
1. Connectez-vous à votre compte GitHub en utilisant vos informations d’identification GitHub. Si vous avez plusieurs comptes, choisissez celui dans lequel vous souhaitez donner accès à Amazon Q Developer.
1. Choisissez **Autoriser Amazon Q Developer** pour donner accès à votre compte GitHub. Vous serez redirigé vers la console Amazon Q Developer après l’autorisation.
1. Sous **Détails de l’enregistrement**, saisissez vos détails GitHub, configurez éventuellement la fonctionnalité de révision du code et ajoutez des balises.
1. Dans le champ de saisie de texte **Nom d’enregistrement**, saisissez un nom pour l’installation de votre application.
1. (Facultatif) Dans le champ **Nom de l’organisation – *Facultatif***, saisissez le nom de l’organisation associée à l’installation de l’application.
1. (Facultatif) Sous **Fonctionnalités**, configurez la fonctionnalité **Révisions du code** en cliquant sur le bouton pour activer ou désactiver la fonctionnalité. La configuration de **développement des fonctionnalités** ne peut pas être modifiée et est activée par défaut.
1. (Facultatif) Sous **Balises : facultatif**, choisissez **Ajouter une nouvelle balise** pour ajouter une balise qui peut vous aider à rechercher et à filtrer vos AWS ressourcesGitHub.
1. Choisissez **Enregistrer** pour enregistrer l'installation de votre application GitHub avec votre AWS compte.
Après avoir enregistré avec succès l'installation de l'application, vous pouvez consulter les détails de l'enregistrement. Vous pouvez toujours activer ou désactiver la fonction de révision du code, ainsi qu'ajouter des balises ultérieurement. Vous pouvez également supprimer l'enregistrement. Pour de plus amples informations, veuillez consulter [Configuration des détails de l’installation enregistrée](github-configuration.md).
# Configuration des détails de l’installation enregistrée
**Note**
Amazon Q Developer pour GitHub est actuellement disponible en version préliminaire et susceptible d’être modifié.
Après avoir créé un profil Amazon Q Developer et enregistré l’installation de l’application dans GitHub, vous pouvez effectuer les opérations suivantes depuis la console Amazon Q Developer :
+ Activer ou désactiver l’utilisation des révisions de code. La configuration du développement des fonctionnalités ne peut actuellement pas être modifiée.
+ Trouver des liens vers des extensions de navigateur qui permettent d’ajouter des étiquettes de fonctionnalités Amazon Q Developer dans les problèmes GitHub.
+ Ajoutez des balises pour rechercher et filtrer vos ressources ou suivre AWS les coûts.
+ Supprimer l’enregistrement d’une installation d’application GitHub.
## Fonctionnalités d’édition pour Amazon Q Developer dans GitHub
Les fonctionnalités disponibles pour Amazon Q Developer dans GitHub sont activées par défaut lorsque vous installez l’application dans GitHub et que vous autorisez l’accès à votre organisation. Vous pouvez choisir de désactiver une fonctionnalité si vous ne souhaitez plus l’utiliser dans GitHub.
**Pour activer ou désactiver une fonctionnalité pour Amazon Q Developer dans GitHub**
1. Accédez à la [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github).
1. Dans le volet de navigation, sous **Amazon Q Developer dans GitHub**, sélectionnez **Installations enregistrées**.
1. Dans la colonne **Nom**, choisissez le nom d’enregistrement de l’installation pour laquelle vous souhaitez activer ou désactiver une fonctionnalité.
1. Sous **Fonctionnalités**, choisissez **Modifier** pour configurer la disponibilité des fonctionnalités.
1. Dans le modal, sélectionnez le bouton correspondant à la fonctionnalité que vous souhaitez activer ou désactiver, puis choisissez **Enregistrer** pour confirmer les modifications.
Après avoir activé ou désactivé une fonctionnalité dans la [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github), les modifications sont reflétées dans GitHub. Toute tentative d’attribution d’un problème à une étiquette Amazon Q Developer après avoir désactivé la fonctionnalité entraînera une erreur. Les révisions de code n’auront plus lieu dans les nouvelles demandes de tirage si la fonctionnalité est désactivée.
## Installation d’extensions de navigateur
Vous pouvez installer l’extension Amazon Q Developer dans l’un des navigateurs compatibles. L'extension vous permet d'attribuer rapidement des tâches de développement de fonctionnalités à Amazon Q Developer en cas de GitHub problème sans avoir à effectuer de recherche dans les menus d'étiquettes.
L’extension Amazon Q Developer est disponible pour les navigateurs suivants :
+ [Google Chrome](https://chromewebstore.google.com/detail/amazon-q-github-issue-hel/oefafjbablenakmhacfllkmpaeabnnfi)
+ [Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/amazon-q-github-issue-helper)
+ [Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/amazon-q-github-issue-helper/poghackjbfhejeppjaegbnblangjbmmc)
Vous pouvez également consulter les navigateurs pris en charge sur la page des détails d’installation de l’enregistrement dans la [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github).
## Suppression de l’enregistrement de l’installation de l’application GitHub Amazon Q Developer
Vous pouvez supprimer l’enregistrement d’une ou de plusieurs de vos applications GitHub via la console Amazon Q Developer. Après avoir définitivement supprimé votre enregistrement, toutes les données associées à l’enregistrement sont également supprimées. Cette action ne peut pas être annulée.
**Pour supprimer l’installation de votre application GitHub**
1. Accédez à la [console Amazon Q Developer](https://us-east-1.console.aws.amazon.com/amazonq/developer/home#/github).
1. Dans le volet de navigation, sous **Amazon Q Developer dans GitHub**, sélectionnez **Installations enregistrées**.
1. Effectuez l’une des actions suivantes :
+ Dans la colonne **Actions**, choisissez **Supprimer l’enregistrement** pour l’installation que vous souhaitez supprimer.
+ Dans la colonne **Nom**, choisissez le nom d’enregistrement de l’installation que vous souhaitez supprimer, puis choisissez **Supprimer**.
Dans la colonne **Actions**, choisissez **Supprimer l’enregistrement** pour l’installation enregistrée que vous souhaitez supprimer.
1. Dans le modal, passez en revue les informations relatives à la suppression de l’enregistrement.
1. Dans le champ de saisie de texte, saisissez **confirm**, puis choisissez **Supprimer** pour confirmer les modifications.
Une fois que vous avez supprimé l’installation d’une application GitHub, vous pouvez choisir d’enregistrer une nouvelle installation.
# Résolution des problèmes liés à Amazon Q Developer pour GitHub
Consultez la section suivante pour résoudre les problèmes courants liés à l’utilisation d’Amazon Q Developer pour GitHub.
## Amazon Q Developer ne génère pas de demandes de tirage dans les référentiels dotés de règles de protection des branches
**Problème** : Amazon Q Developer n’est pas en mesure de créer une demande de tirage dans mon référentiel GitHub, qui comporte des règles de protection des branches.
**Solution** : les règles de protection des branches empêchent Amazon Q Developer de créer une branche pour créer une demande de tirage. Pour utiliser Amazon Q Developer pour GitHub dans des référentiels soumis à des règles de protection des branches, vous devez ajouter l’application Amazon Q Developer à votre liste d’autorisations.
**Pour ajouter l’application Amazon Q Developer à votre liste d’autorisations**
1. Si nécessaire, connectez-vous à votre [compte GitHub](https://github.com/) en utilisant vos informations d’identification GitHub.
1. Accédez à votre organisation GitHub, puis accédez au référentiel dans lequel vous souhaitez autoriser Amazon Q Developer pour l’application GitHub.
1. Choisissez **Paramètres**, puis **Branches** dans le volet de navigation.
1. Sous **Règles de protection des branches**, choisissez **Modifier** pour modifier les règles de protection des branches.
1. Choisissez **Restreindre les push qui créent des branches correspondantes**, puis recherchez l’application Amazon Q Developer pour GitHub.
1. Choisissez **Enregistrer les modifications** pour autoriser Amazon Q Developer à créer des demandes de tirage pour les problèmes liés aux étiquettes Amazon Q Developer.
Pour en savoir plus sur la modification des règles de protection des branches dans GitHub, consultez [Création d’une règle de protection de branche](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule#creating-a-branch-protection-rule).
## Étiquettes Amazon Q Developer manquantes dans les problèmes GitHub
**Problème** : je ne vois pas l'étiquette de l'**agent de développement Amazon Q** dans GitHub les problèmes.
**Solution** : si l'étiquette n'est pas créée automatiquement lorsque vous avez installé l'GitHubapplication Amazon Q Developer for, ou si elle a été 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](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/managing-labels#creating-a-label) dans la *documentation GitHub*.
## Amazon Q Developer ne crée pas de code pour les problèmes relatifs à GitHub
**Problème** : j’ai créé un problème GitHub et j’ai invoqué Amazon Q Developer pour effectuer une tâche, mais j’ai reçu la série de messages suivante concernant des problèmes techniques :
1. ⏳ I’m working on generating code for this issue. I’ll update this issue with a comment and open a pull request when I’m done.
1. ⚠️ I’m having technical difficulties. I couldn’t solve the issue. I’m going to try again. This might take some time.
1. ⚠️ I’m having technical difficulties. I couldn’t solve the issue. I’m going to try again. This might take some time.
1. 🔴 I’m having technical difficulties. I couldn’t solve the issue.
Consider reassigning this issue to a user. This will help you stay within the quotas for generative AI feature usage.
**Solution** : si le développeur Amazon Q n'est pas en mesure de traiter votre problème et de générer le code correspondant, créez un nouveau problème et apposez le label d'**agent de développement Amazon Q** au nouveau problème. Pour en savoir plus sur la création d'un problème et l'application d'un label d'agent Amazon Q Developer, consultez[Développement de fonctionnalités et itération avec Amazon Q Developer dans GitHub](github-feature-development.md).