Vos premières instructions personnalisées

À propos des personnalisations

Vous pouvez personnaliser les réponses de GitHub Copilot à l’aide de deux types de fichiers :

• Les instructions personnalisées fournissent des conseils continus sur la manière dont GitHub Copilot doit se comporter dans toutes vos interactions.
• Les fichiers de prompts (préversion publique) définissent des prompts réutilisables pour des tâches spécifiques que vous pouvez invoquer au besoin. Les fichiers d’invite sont disponibles uniquement dans VS Code, Visual Studio, et les IDE JetBrains. Pour obtenir un exemple d’introduction, consultez Votre premier fichier de prompt.

Bien que les instructions personnalisées aident à ajouter du contexte à chaque flux de travail IA, les fichiers de prompts vous permettent d’ajouter des instructions à une interaction de conversation spécifique.

Les instructions personnalisées du référentiel sont les plus couramment utilisées et prises en charge, mais vous pouvez également définir des instructions personnalisées personnelles et d’organisation, uniquement pour GitHub Copilot Chat dans GitHub. Vous pouvez créer des instructions personnalisées pour le référentiel de deux manières :

•         **Instructions à l’échelle du référentiel** : créez un seul fichier `copilot-instructions.md` à la racine du référentiel qui s’applique à tous les fichiers du référentiel.
  

•         **Instructions spécifiques au chemin d’accès** : créez un ou plusieurs fichiers `.instructions.md` avec un champ `applyTo` qui s’applique uniquement à des fichiers ou répertoires spécifiques. Les instructions spécifiques au chemin d’accès sont actuellement prises en charge pour **Discussion avec Copilot** dans Visual Studio Code, Visual Studio, et **GitHub Copilot code agent**.
  

Vos premières instructions

Commencez par ces instructions personnalisées de base qui aident GitHub Copilot à comprendre vos préférences en matière de codage.

Instructions pour l’écriture de fonctions

When writing functions, always:
- Add descriptive JSDoc comments
- Include input validation
- Use early returns for error conditions
- Add meaningful variable names
- Include at least one example usage in comments

When writing functions, always:
- Add descriptive JSDoc comments
- Include input validation
- Use early returns for error conditions
- Add meaningful variable names
- Include at least one example usage in comments

Ces instructions modifieront la façon dont GitHub Copilot génère les fonctions.

Essayez-le

Pour tester rapidement la différence que les instructions personnalisées peuvent effectuer, vous pouvez utiliser des instructions personnalisées personnelles dans Discussion avec Copilot.

1. Tout d’abord, rendez-vous sur GitHub.com/copilot et entrez ce prompt :

   Create a JavaScript function that calculates the area of a circle

          **Sans instructions personnalisées**, vous pourriez obtenir :
   

   function areaOfCircle(radius) {
       if (typeof radius !== 'number' || radius < 0) {
           throw new Error('Radius must be a non-negative number');
       }
       return Math.PI * radius * radius;
   }
   

2. Accédez maintenant à vos instructions personnalisées en cliquant sur votre photo de profil en bas à gauche de la page, puis cliquez sur Instructions personnelles. Collez les instructions ci-dessus dans la zone de texte, puis cliquez sur Enregistrer.

   Saisissez maintenant la même requête que celle que vous avez entrée précédemment.

          **Avec des instructions personnalisées**, vous obtiendrez quelque chose comme :
   

   /**
    * Calculates the area of a circle given its radius.
    *
    * @param {number} radius - The radius of the circle. Must be a positive number.
    * @returns {number|null} The area of the circle, or null if the input is invalid.
    *
    * @example
    * // returns 78.53981633974483
    * areaOfCircle(5);
    *
    * @example
    * // returns null (invalid input)
    * areaOfCircle(-2);
    */
   function areaOfCircle(radius) {
     if (typeof radius !== "number" || isNaN(radius) || radius <= 0) {
       // Invalid input: radius must be a positive number
       return null;
     }
   
     const area = Math.PI * Math.pow(radius, 2);
     return area;
   }
   
   // Example usage:
   console.log(areaOfCircle(5));   // 78.53981633974483
   console.log(areaOfCircle(-2));  // null
   

Pour aller plus loin

•         [AUTOTITLE](/copilot/concepts/response-customization) - Vue d’ensemble de la personnalisation des réponses dans GitHub Copilot
  

•         [AUTOTITLE](/copilot/how-tos/configure-custom-instructions) - Comment configurer des instructions personnalisées
  

•         [Personnalisations remarquables de GitHub Copilot](https://github.com/github/awesome-copilot/blob/main/README.md) - Référentiel d’instructions personnalisées fournies par la communauté et d’autres personnalisations pour des langages et des scénarios spécifiques