Ajout d’instructions personnalisées de référentiel pour GitHub Copilot dans votre IDE

Créez des fichiers d’instructions personnalisées de référentiel qui donnent un Copilot contexte supplémentaire sur la façon de comprendre votre projet et comment générer, tester et valider ses modifications.

Tool navigation

Dans cet article

Cette version de cet article est destinée à l'utilisation des instructions personnalisées du référentiel et des fichiers de commande dans VS Code. Cliquez sur les onglets ci-dessus pour obtenir les indications sur l’utilisation des instructions personnalisées dans d’autres environnements.

Présentation

Les instructions personnalisées du référentiel vous permettent de fournir à Copilot des instructions et des préférences spécifiques au référentiel. Pour plus d’informations, consultez « À propos de la personnalisation des réponses GitHub Copilot ».

Conditions préalables pour les instructions personnalisées du référentiel

Création d’instructions personnalisées

          VS Code prend en charge trois types d’instructions personnalisées de référentiel. Pour plus d’informations sur les fonctionnalités qui GitHub Copilot prennent en charge ces types d’instructions, consultez [AUTOTITLE](/copilot/concepts/prompting/response-customization?tool=vscode#support-for-repository-custom-instructions-1).

  • Instructions personnalisées à l’échelle du référentiel, qui s’appliquent à toutes les demandes effectuées dans le contexte d’un référentiel.

    Ceux-ci sont spécifiés dans un fichier copilot-instructions.md dans le répertoire .github du référentiel. Consultez Création d’instructions personnalisées à l’échelle du dépôt.

  • Instructions personnalisées spécifiques à un chemin d’accès, qui s’appliquent aux requêtes effectuées dans le contexte de fichiers correspondant à un chemin d’accès spécifié.

    Ceux-ci sont spécifiés dans un ou plusieurs fichiers NAME.instructions.md dans ou en dessous du répertoire .github/instructions dans le référentiel. Consultez Création d’instructions personnalisées spécifiques d’un chemin d’accès.

    Si le chemin d’accès que vous spécifiez correspond à un fichier sur lequel Copilot travaille, et qu’un fichier d’instructions personnalisées dans l'ensemble du référentiel existe également, les instructions des deux fichiers sont utilisées.

  •           Les **instructions de l’agent** sont utilisées par les assistants IA.

    Vous pouvez créer un ou plusieurs fichiers AGENTS.md, stockés n'importe où dans le référentiel. Lorsque Copilot est en fonctionnement, le fichier AGENTS.md le plus proche dans l’arborescence de répertoires sera prioritaire. Pour plus d’informations, consultez le dépôt agentsmd/agents.md.

    Remarque

    La prise en charge des AGENTS.md fichiers en dehors de la racine de l’espace de travail est actuellement désactivée par défaut. Pour plus d’informations sur l’activation de cette fonctionnalité, consultez Utiliser des instructions personnalisées dans VS Code dans la VS Code documentation.

Création d’instructions personnalisées à l’échelle du dépôt

  1. À la racine de votre référentiel, créez un fichier nommé .github/copilot-instructions.md.

    Créez le répertoire .github s’il n’existe pas déjà.

  2. Ajouter des instructions en langage naturel dans le fichier, au format Markdown.

    L'espacement entre les instructions est ignoré, de sorte que les instructions peuvent être écrites comme un seul paragraphe, chacune sur une nouvelle ligne, ou séparées par des lignes vides pour plus de lisibilité.

Création d’instructions personnalisées spécifiques à un chemin

  1. Créez le .github/instructions répertoire s'il n'existe pas déjà.

  2. Si vous le souhaitez, créez des sous-répertoires de .github/instructions pour organiser vos fichiers d’instructions.

  3. Créez un ou plusieurs fichiers NAME.instructions.md, où NAME indique l’objectif des instructions. Le nom de fichier doit se terminer par .instructions.md.

  4. Au début du fichier, créez un bloc frontmatter contenant le mot-clé applyTo. Utilisez la syntaxe glob pour spécifier les fichiers ou répertoires auxquels les instructions s’appliquent.

    Par exemple :

    ---
applyTo: "app/models/**/*.rb"
---

    Vous pouvez spécifier plusieurs modèles en les séparant par des virgules. Par exemple, pour appliquer les instructions à tous les fichiers TypeScript du référentiel, vous pouvez utiliser le bloc frontmatter suivant :

    ---
applyTo: "**/*.ts,**/*.tsx"
---

    Exemples Glob :

    • * - correspond à tous les fichiers du répertoire en cours.
    • ** ou **/* - correspond à tous les fichiers de tous les répertoires.
    • *.py - correspond à tous les .py fichiers du répertoire actif.
    • **/*.py - correspond de manière récursive à tous les .py fichiers de tous les répertoires.
    • src/*.py - correspond à tous les .py fichiers du src répertoire. Par exemple, src/foo.py et src/bar.py mais passrc/foo/bar.py.
    • src/**/*.py - correspond de manière récursive à tous les .py fichiers du src répertoire. Par exemple, src/foo.py, src/foo/bar.pyet src/foo/bar/baz.py.
    •           `**/subdir/**/*.py` - correspond de manière récursive à tous les `.py` fichiers d’un répertoire à n’importe quelle `subdir` profondeur. Par exemple, `subdir/foo.py`, `subdir/nested/bar.py`, `parent/subdir/baz.py` et `deep/parent/subdir/nested/qux.py`, mais _pas_`foo.py` à un chemin qui ne contient pas de répertoire `subdir`.

  5. Si vous le souhaitez, pour empêcher l’utilisation du fichier par Agent cloud Copilot ou révision du code Copilot, ajoutez le mot clé excludeAgent au bloc frontmatter. Utilisez l’une ou l’autre "code-review" ou "cloud-agent".

    Par exemple, le fichier suivant est lu uniquement par Agent cloud Copilot.

    ---
applyTo: "**"
excludeAgent: "code-review"
---

    Si le mot clé excludeAgent n’est pas inclus dans le front matterblock, révision du code Copilot et Agent cloud Copilot utiliseront vos instructions.

  6. Ajoutez vos instructions personnalisées en langage naturel à l’aide du format Markdown. L'espacement entre les instructions est ignoré, de sorte que les instructions peuvent être écrites comme un seul paragraphe, chacune sur une nouvelle ligne, ou séparées par des lignes vides pour plus de lisibilité.

Avez-vous réussi à ajouter un fichier d’instructions personnalisé à votre référentiel ?

          <a href="https://docs.github.io/success-test/yes.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline">
          <span>Oui</span></a><a href="https://docs.github.io/success-test/no.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline"><span>Non</span></a>

Instructions personnalisées en cours d’utilisation

Les instructions du fichier ou des fichiers sont disponibles pour une utilisation par Copilot dès que vous enregistrez le fichier ou les fichiers. Les instructions sont automatiquement ajoutées aux demandes que vous envoyez à Copilot.

Les instructions personnalisées ne sont pas visibles dans la vue Chat ou dans le chat en ligne, mais vous pouvez vérifier qu'elles sont utilisées par Copilot en consultant la liste des références d'une réponse dans la vue Chat. Si des instructions personnalisées ont été ajoutées à l'invite envoyée au modèle, le fichier .github/copilot-instructions.md est indiqué comme référence. Vous pouvez cliquer sur la référence pour ouvrir le fichier.

Capture d'écran d'une liste de références étendue, montrant le fichier « copilot-instructions.md » surligné d'un contour orange foncé.

Activation ou désactivation des instructions personnalisées du référentiel

Vous pouvez choisir si vous souhaitez ou non que Copilot utilise des instructions personnalisées basées sur le référentiel.

Activer ou désactiver les instructions personnalisées pour Discussion avec Copilot

Les instructions personnalisées sont activées par défaut pour Discussion avec Copilot, mais vous pouvez les désactiver ou les réactiver à tout moment. Cela s'applique à votre propre utilisation de Discussion avec Copilot et n'affecte pas les autres utilisateurs.

  1. Pour afficher l’éditeur Paramètres, utilisez le raccourci clavier Commande+, (Mac) / Ctrl+, (Linux/Windows).
  2. Tapez instruction file dans la zone de recherche.
  3. Cochez ou décochez la case sous Génération de code : Utiliser les fichiers d'instructions.

Activer ou désactiver les instructions personnalisées pour révision du code Copilot

Les instructions personnalisées sont activées par défaut pour révision du code Copilot, mais vous pouvez les désactiver ou les réactiver dans les paramètres du référentiel sur GitHub.com. Cela s'applique à l'utilisation par Copilot d'instructions personnalisées pour toutes les révisions de code qu'il effectue dans ce référentiel.

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Sous le nom de votre référentiel, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran d’un en-tête de dépôt montrant les onglets. L’onglet « Paramètres » est mis en évidence avec un encadré orange foncé.

  3. Dans la section « Code et automatisation » de la barre latérale, cliquez sur Copilot, puis Revue du code.

  4. Activez ou désactivez l’option “Utiliser des instructions personnalisées lors de l’examen de l’option des demandes” de tirage.

Activation et utilisation des fichiers de prompt

Remarque

Les fichiers d’invite vous permettent de créer et de partager des instructions d’invite réutilisables avec un contexte supplémentaire. Un fichier d’invite est un fichier Markdown, stocké dans votre espace de travail, qui imite le format existant des invites d’écriture dans Discussion avec Copilot (par exemple, Rewrite #file:x.ts). Vous pouvez disposer de plusieurs fichiers d’invite dans votre espace de travail, chacun définissant une invite à des fins différentes.

Activation des fichiers de prompt

Pour activer les fichiers de prompt, configurez les paramètres de l’espace de travail.

  1. Ouvrez la palette de commandes en appuyant sur Ctrl+Maj+P (Windows/Linux) / Commande+Maj+P (Mac).
  2. Tapez « Ouvrir les paramètres de l’espace de travail (JSON) » et sélectionnez l’option qui s’affiche.
  3. Dans le fichier settings.json, ajoutez "chat.promptFiles": true pour activer le dossier .github/prompts comme emplacement des fichiers de prompt. Ce dossier sera créé s’il n’existe pas déjà.

Création de fichiers de prompt

  1. Ouvrez la palette de commandes en appuyant sur Ctrl+Maj+P (Windows/Linux) / Commande+Maj+P (Mac).

  2. Tapez « prompt » et sélectionnez Conversation : créer un prompt.

  3. Entrez un nom pour le fichier de prompt, en excluant l’extension de nom de fichier .prompt.md. Le nom peut contenir des caractères alphanumériques et des espaces et doit décrire l’objectif des informations de prompt que le fichier contiendra.

  4. Écrivez les instructions du prompt à l’aide du formatage Markdown.

    Vous pouvez référencer d’autres fichiers dans l’espace de travail en utilisant des liens Markdown, par exemple [index](../../web/index.ts), ou en utilisant la syntaxe #file:../../web/index.ts. Les chemins d’accès sont relatifs au fichier de prompt. La référence à d’autres fichiers vous permet de fournir un contexte supplémentaire, tel que les spécifications de l’API ou la documentation du produit.

Utilisation des fichiers de commande

  1. En bas de la Discussion avec Copilot vue, cliquez sur l’icône Attacher le contexte ().

  2. Dans le menu déroulant, cliquez sur Prompt... et choisissez le fichier de prompt que vous souhaitez utiliser.

  3. Vous pouvez également joindre des fichiers supplémentaires, y compris des fichiers prompts, pour fournir plus de contexte.

  4. Vous pouvez également taper des informations supplémentaires dans la zone de prompt de conversation.

    Vous pouvez le faire ou non en fonction du contenu du prompt que vous utilisez.

  5. Envoyez le prompt de conversation.

Pour plus d’informations sur les fichiers d’invite, consultez la documentation, Utiliser les fichiers d’invite dans Visual Studio CodeVisual Studio Code.

Lectures complémentaires

Cette version de cet article concerne l’utilisation des instructions personnalisées du dépôt et des fichiers d’invite dans Visual Studio. Cliquez sur les onglets ci-dessus pour obtenir les indications sur l’utilisation des instructions personnalisées dans d’autres environnements.

Présentation

Les instructions personnalisées du référentiel vous permettent de fournir à Copilot des instructions et des préférences spécifiques au référentiel. Pour plus d’informations, consultez « À propos de la personnalisation des réponses GitHub Copilot ».

Conditions préalables pour les instructions personnalisées du référentiel

Création d’instructions personnalisées

          Visual Studio prend en charge deux types d’instructions personnalisées. Pour plus d’informations sur les fonctionnalités qui GitHub Copilot prennent en charge ces types d’instructions, consultez [AUTOTITLE](/copilot/concepts/prompting/response-customization?tool=visualstudio#support-for-repository-custom-instructions-2).

  • Instructions personnalisées à l’échelle du référentiel, qui s’appliquent à toutes les demandes effectuées dans le contexte d’un référentiel.

    Ceux-ci sont spécifiés dans un fichier copilot-instructions.md dans le répertoire .github du référentiel. Consultez Création d’instructions personnalisées à l’échelle du dépôt.

  • Instructions personnalisées spécifiques à un chemin d’accès, qui s’appliquent aux requêtes effectuées dans le contexte de fichiers correspondant à un chemin d’accès spécifié.

    Ceux-ci sont spécifiés dans un ou plusieurs fichiers NAME.instructions.md dans ou en dessous du répertoire .github/instructions dans le référentiel. Consultez Création d’instructions personnalisées spécifiques d’un chemin d’accès.

    Si le chemin d’accès que vous spécifiez correspond à un fichier sur lequel Copilot travaille, et qu’un fichier d’instructions personnalisées dans l'ensemble du référentiel existe également, les instructions des deux fichiers sont utilisées.

Création d’instructions personnalisées à l’échelle du dépôt

  1. À la racine de votre référentiel, créez un fichier nommé .github/copilot-instructions.md.

    Créez le répertoire .github s’il n’existe pas déjà.

  2. Ajouter des instructions en langage naturel dans le fichier, au format Markdown.

    L'espacement entre les instructions est ignoré, de sorte que les instructions peuvent être écrites comme un seul paragraphe, chacune sur une nouvelle ligne, ou séparées par des lignes vides pour plus de lisibilité.

Création d’instructions personnalisées spécifiques à un chemin

  1. Créez le .github/instructions répertoire s'il n'existe pas déjà.

  2. Si vous le souhaitez, créez des sous-répertoires de .github/instructions pour organiser vos fichiers d’instructions.

  3. Créez un ou plusieurs fichiers NAME.instructions.md, où NAME indique l’objectif des instructions. Le nom de fichier doit se terminer par .instructions.md.

  4. Au début du fichier, créez un bloc frontmatter contenant le mot-clé applyTo. Utilisez la syntaxe glob pour spécifier les fichiers ou répertoires auxquels les instructions s’appliquent.

    Par exemple :

    ---
applyTo: "app/models/**/*.rb"
---

    Vous pouvez spécifier plusieurs modèles en les séparant par des virgules. Par exemple, pour appliquer les instructions à tous les fichiers TypeScript du référentiel, vous pouvez utiliser le bloc frontmatter suivant :

    ---
applyTo: "**/*.ts,**/*.tsx"
---

    Exemples Glob :

    • * - correspond à tous les fichiers du répertoire en cours.
    • ** ou **/* - correspond à tous les fichiers de tous les répertoires.
    • *.py - correspond à tous les .py fichiers du répertoire actif.
    • **/*.py - correspond de manière récursive à tous les .py fichiers de tous les répertoires.
    • src/*.py - correspond à tous les .py fichiers du src répertoire. Par exemple, src/foo.py et src/bar.py mais passrc/foo/bar.py.
    • src/**/*.py - correspond de manière récursive à tous les .py fichiers du src répertoire. Par exemple, src/foo.py, src/foo/bar.pyet src/foo/bar/baz.py.
    •           `**/subdir/**/*.py` - correspond de manière récursive à tous les `.py` fichiers d’un répertoire à n’importe quelle `subdir` profondeur. Par exemple, `subdir/foo.py`, `subdir/nested/bar.py`, `parent/subdir/baz.py` et `deep/parent/subdir/nested/qux.py`, mais _pas_`foo.py` à un chemin qui ne contient pas de répertoire `subdir`.

  5. Si vous le souhaitez, pour empêcher l’utilisation du fichier par Agent cloud Copilot ou révision du code Copilot, ajoutez le mot clé excludeAgent au bloc frontmatter. Utilisez l’une ou l’autre "code-review" ou "cloud-agent".

    Par exemple, le fichier suivant est lu uniquement par Agent cloud Copilot.

    ---
applyTo: "**"
excludeAgent: "code-review"
---

    Si le mot clé excludeAgent n’est pas inclus dans le front matterblock, révision du code Copilot et Agent cloud Copilot utiliseront vos instructions.

  6. Ajoutez vos instructions personnalisées en langage naturel à l’aide du format Markdown. L'espacement entre les instructions est ignoré, de sorte que les instructions peuvent être écrites comme un seul paragraphe, chacune sur une nouvelle ligne, ou séparées par des lignes vides pour plus de lisibilité.

Avez-vous réussi à ajouter un fichier d’instructions personnalisé à votre référentiel ?

          <a href="https://docs.github.io/success-test/yes.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline">
          <span>Oui</span></a><a href="https://docs.github.io/success-test/no.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline"><span>Non</span></a>

Instructions personnalisées en cours d’utilisation

Les instructions du fichier ou des fichiers sont disponibles pour une utilisation par Copilot dès que vous enregistrez le fichier ou les fichiers. Les instructions sont automatiquement ajoutées aux demandes que vous envoyez à Copilot.

Les instructions personnalisées ne sont pas visibles dans la vue Chat ou dans le chat en ligne, mais vous pouvez vérifier qu'elles sont utilisées par Copilot en consultant la liste des références d'une réponse dans la vue Chat. Si des instructions personnalisées ont été ajoutées à l'invite envoyée au modèle, le fichier .github/copilot-instructions.md est indiqué comme référence. Vous pouvez cliquer sur la référence pour ouvrir le fichier.

Capture d'écran de la fenêtre contextuelle Références, montrant le fichier « copilot-instructions.md » surligné d'un contour orange foncé.

Activation ou désactivation des instructions personnalisées du référentiel

Vous pouvez choisir si vous souhaitez ou non que Copilot utilise des instructions personnalisées basées sur le référentiel.

Activer ou désactiver les instructions personnalisées pour Discussion avec Copilot

Les instructions personnalisées sont activées par défaut pour Discussion avec Copilot, mais vous pouvez les désactiver ou les réactiver à tout moment. Cela s'applique à votre propre utilisation de Discussion avec Copilot et n'affecte pas les autres utilisateurs.

  1. Dans la barre de Visual Studio menus, sous Outils, cliquez sur Options.

    Capture d’écran de la barre de menus Visual Studio. Le menu « Outils » est développé et l’élément « Options » est mis en évidence avec un encadré orange.

  2. Dans la boîte de dialogue « Options », tapez custom instructions dans la zone de recherche, puis cliquez sur Copilot.

  3. Cochez ou décochez la case pour Activer le chargement d'instructions personnalisées à partir des fichiers .github/copilot-instructions.md et leur ajout aux requêtes.

    Capture d’écran de la boîte de dialogue Options de Visual Studio montrant la case à cocher « Activer les instructions personnalisées » sélectionnée.

Activer ou désactiver les instructions personnalisées pour révision du code Copilot

Les instructions personnalisées sont activées par défaut pour révision du code Copilot, mais vous pouvez les désactiver ou les réactiver dans les paramètres du référentiel sur GitHub.com. Cela s'applique à l'utilisation par Copilot d'instructions personnalisées pour toutes les révisions de code qu'il effectue dans ce référentiel.

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Sous le nom de votre référentiel, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran d’un en-tête de dépôt montrant les onglets. L’onglet « Paramètres » est mis en évidence avec un encadré orange foncé.

  3. Dans la section « Code et automatisation » de la barre latérale, cliquez sur Copilot, puis Revue du code.

  4. Activez ou désactivez l’option “Utiliser des instructions personnalisées lors de l’examen de l’option des demandes” de tirage.

Utilisation des fichiers de commande

Remarque

Les fichiers d’invite vous permettent de créer et de partager des instructions d’invite réutilisables avec un contexte supplémentaire. Un fichier d’invite est un fichier Markdown, stocké dans votre espace de travail, qui imite le format existant des invites d’écriture dans Discussion avec Copilot (par exemple, Rewrite #file:x.ts). Vous pouvez disposer de plusieurs fichiers d’invite dans votre espace de travail, chacun définissant une invite à des fins différentes.

Création de fichiers de prompt

  1. Ajoutez un fichier d’invite, y compris l’extension de nom de fichier .prompt.md dans le dossier .github/prompts à la racine du référentiel. Le nom peut contenir des caractères alphanumériques et des espaces et doit décrire l’objectif des informations de prompt que le fichier contiendra.

  2. Écrivez les instructions du prompt à l’aide du formatage Markdown.

    Vous pouvez référencer d’autres fichiers dans l’espace de travail en utilisant des liens Markdown, par exemple [index](../../web/index.ts), ou en utilisant la syntaxe #file:'../../web/index.ts'. Les chemins d’accès sont relatifs au fichier de prompt. La référence à d’autres fichiers vous permet de fournir un contexte supplémentaire, tel que les spécifications de l’API ou la documentation du produit.

Pour plus d’informations sur les fichiers d’invite, consultez la documentation Utiliser les fichiers d’invite dans Visual StudioVisual Studio.

Lectures complémentaires

Cette version de l’article concerne l’utilisation des instructions personnalisées du dépôt dans les IDE JetBrains. Cliquez sur les onglets ci-dessus pour obtenir les indications sur l’utilisation des instructions personnalisées dans d’autres environnements.

Présentation

Les instructions personnalisées du référentiel vous permettent de fournir à Copilot des instructions et des préférences spécifiques au référentiel. Pour plus d’informations, consultez « À propos de la personnalisation des réponses GitHub Copilot ».

Conditions préalables pour les instructions personnalisées du référentiel

  • Vous devez disposer d'un fichier d'instructions personnalisé (voir les instructions ci-dessous).

  • La dernière version de l’extension Copilot doit être installée dans votre IDE JetBrains.

Création d’instructions personnalisées

Les IDE JetBrains prennent en charge un seul fichier d’instructions personnalisées du dépôt .github/copilot-instructions.md ainsi qu’un fichier global-copilot-instructions.md stocké localement.

Vous pouvez créer le .github/copilot-instructions.md fichier dans votre référentiel à l’aide de la Copilot page paramètres, ou vous pouvez le créer manuellement.

L'espacement entre les instructions est ignoré, de sorte que les instructions peuvent être écrites comme un seul paragraphe, chacune sur une nouvelle ligne, ou séparées par des lignes vides pour plus de lisibilité.

Utilisation de la page des paramètres

  1. Dans votre IDE JetBrains, cliquez sur le menu Fichier (Windows) ou sur le nom de l’application dans la barre de menus (macOS), puis cliquez sur Paramètres.

           1. Dans la barre latérale gauche, cliquez sur **Outils****, cliquez sur GitHub Copilot**, puis cliquez sur **Personnalisations**.

  2. Sous «Copilot Instructions », cliquez sur Espace de travail ou Global pour choisir si les instructions personnalisées s’appliquent à l’espace de travail actuel ou à tous les espaces de travail.

Création manuelle d’un fichier d’instructions personnalisées de l’espace de travail

  1. À la racine de votre référentiel, créez un fichier nommé .github/copilot-instructions.md.

    Créez le répertoire .github s’il n’existe pas déjà.

  2. Ajouter des instructions en langage naturel dans le fichier, au format Markdown.

Une fois enregistrées, ces instructions s’appliquent à l’espace de travail actuel dans les IDE JetBrains que vous ouvrez avec Copilot activé.

Création manuelle d’un fichier d’instructions personnalisées global

Pour appliquer les mêmes instructions à tous les espaces de travail dans les IDE JetBrains, vous pouvez créer un fichier d’instructions personnalisées global sur votre machine locale.

  1. Ouvrez votre explorateur de fichiers ou votre terminal.

  2. Accédez à l’emplacement approprié pour votre système d’exploitation :

    • macOS : /Users/YOUR-USERNAME/.config/github-copilot/intellij/
    • Windows : C:\Users\YOUR-USERNAME\AppData\Local\github-copilot\intellij\

  3. Créez un fichier nommé global-copilot-instructions.md dans ce répertoire.

  4. Ajoutez vos instructions personnalisées en langage naturel à l’aide du format Markdown.

Une fois enregistrées, ces instructions s’appliquent globalement à tous les espaces de travail dans les ID JetBrains que vous ouvrez avec Copilot activé.

Avez-vous réussi à ajouter un fichier d’instructions personnalisé à votre référentiel ?

          <a href="https://docs.github.io/success-test/yes.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline">
          <span>Oui</span></a><a href="https://docs.github.io/success-test/no.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline"><span>Non</span></a>

Instructions personnalisées en cours d’utilisation

Les instructions du fichier ou des fichiers sont disponibles pour une utilisation par Copilot dès que vous enregistrez le fichier ou les fichiers. Les instructions sont automatiquement ajoutées aux demandes que vous envoyez à Copilot.

Les instructions personnalisées ne sont pas visibles dans la vue Chat ou dans le chat en ligne, mais vous pouvez vérifier qu'elles sont utilisées par Copilot en consultant la liste des références d'une réponse dans la vue Chat. Si des instructions personnalisées ont été ajoutées à l'invite envoyée au modèle, le fichier .github/copilot-instructions.md est indiqué comme référence. Vous pouvez cliquer sur la référence pour ouvrir le fichier.

Utilisation des fichiers de commande

Remarque

Les fichiers d’invite vous permettent de créer et de partager des instructions d’invite réutilisables avec un contexte supplémentaire. Un fichier d’invite est un fichier Markdown, stocké dans votre espace de travail, qui imite le format existant des invites d’écriture dans Discussion avec Copilot (par exemple, Rewrite #file:x.ts). Vous pouvez disposer de plusieurs fichiers d’invite dans votre espace de travail, chacun définissant une invite à des fins différentes.

Lorsque vous écrivez des instructions d’invite, vous pouvez référencer d’autres fichiers dans l’espace de travail à l’aide de liens Markdown par exemple [index](../../web/index.ts), ou à l’aide de la syntaxe #file:../../web/index.ts. Les chemins d’accès sont relatifs au fichier de prompt. La référence à d’autres fichiers vous permet de fournir un contexte supplémentaire, tel que les spécifications de l’API ou la documentation du produit.

Une fois les fichiers d’invite enregistrés, leurs instructions s’appliquent à l’espace de travail actuel dans les IDE JetBrains que vous ouvrez avec Copilot activé.

Création de fichiers d’invite à l’aide de la ligne de commande

  1. Créez le .github/prompts répertoire s’il n’existe pas déjà dans votre espace de travail. Ce répertoire sera l’emplacement de vos fichiers d’invite.
  2. Créez un fichier d’invite dans le .github/prompts répertoire. Le nom du fichier d’invite peut contenir des caractères alphanumériques et des espaces et doit décrire l’objectif des informations d’invite que le fichier contiendra. Le nom de fichier doit se terminer par l’extension .prompt.md de nom de fichier, par exemple TESTPROMPT.prompt.md.
  3. Écrivez les instructions d’invite à l’aide de la mise en forme Markdown et enregistrez le fichier.

Création de fichiers d’invite à l’aide de la page paramètres

  1. Dans votre IDE JetBrains, cliquez sur le menu Fichier (Windows) ou sur le nom de l’application dans la barre de menus (macOS), puis cliquez sur Paramètres.
  2. Sous Outils, sous GitHub Copilot, cliquez sur Modifier les paramètres.
  3. Sous « Catégories de paramètres », cliquez sur Personnalisations.
  4. Sous « Fichiers d’invite », cliquez sur Espace de travail pour créer un fichier d’invite dans votre espace de travail.
  5. Entrez un nom pour le fichier de prompt, en excluant l’extension de nom de fichier .prompt.md. Le nom du fichier d’invite peut contenir des caractères alphanumériques et des espaces et doit décrire l’objectif des informations d’invite que le fichier contiendra.
  6. Cliquez sur Ok pour enregistrer le nom du fichier d’invite.
  7. Écrivez les instructions de la commande en utilisant le formatage Markdown et sauvegardez le fichier.

Utilisation des fichiers de commande

  1. Dans la boîte de saisie du chat, tapez / suivi du nom du fichier d’invite. Par exemple : /TESTPROMPT.

  2. Si vous le souhaitez, joignez des fichiers supplémentaires pour fournir davantage de contexte.

  3. Vous pouvez également taper des informations supplémentaires dans la zone de prompt de conversation.

    Vous pouvez le faire ou non en fonction du contenu du prompt que vous utilisez.

  4. Envoyez le prompt de conversation.

Lectures complémentaires

Cette version de l’article concerne l’utilisation des instructions personnalisées du dépôt dans Xcode. Cliquez sur les onglets ci-dessus pour obtenir les indications sur l’utilisation des instructions personnalisées dans d’autres environnements.

Présentation

Les instructions personnalisées du référentiel vous permettent de fournir à Copilot des instructions et des préférences spécifiques au référentiel. Pour plus d’informations, consultez « À propos de la personnalisation des réponses GitHub Copilot ».

Conditions préalables pour les instructions personnalisées du référentiel

  • Vous devez disposer d'un fichier d'instructions personnalisé (voir les instructions ci-dessous).

  • La dernière version de l’extension Copilot doit être installée dans Xcode.

Création d’instructions personnalisées

Xcode prend en charge un seul fichier d’instructions personnalisées .github/copilot-instructions.md stocké dans le dépôt.

Vous pouvez créer un fichier d’instructions personnalisé dans votre référentiel via la Copilot page paramètres.

L'espacement entre les instructions est ignoré, de sorte que les instructions peuvent être écrites comme un seul paragraphe, chacune sur une nouvelle ligne, ou séparées par des lignes vides pour plus de lisibilité.

  1. Ouvrez l’application GitHub Copilot Xcode.
  2. En haut de la fenêtre de l’application, sous Paramètres, cliquez sur Avancé.
  3. À droite de « Instructions personnalisées », cliquez sur Espace de travail actuel ou Global pour choisir si les instructions personnalisées s’appliquent à l’espace de travail actuel ou à tous les espaces de travail.

Avez-vous réussi à ajouter un fichier d’instructions personnalisé à votre référentiel ?

          <a href="https://docs.github.io/success-test/yes.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline">
          <span>Oui</span></a><a href="https://docs.github.io/success-test/no.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline"><span>Non</span></a>

Instructions personnalisées en cours d’utilisation

Les instructions du fichier ou des fichiers sont disponibles pour une utilisation par Copilot dès que vous enregistrez le fichier ou les fichiers. Les instructions sont automatiquement ajoutées aux demandes que vous envoyez à Copilot.

Les instructions personnalisées ne sont pas visibles dans la vue Chat ou dans le chat en ligne, mais vous pouvez vérifier qu'elles sont utilisées par Copilot en consultant la liste des références d'une réponse dans la vue Chat. Si des instructions personnalisées ont été ajoutées à l'invite envoyée au modèle, le fichier .github/copilot-instructions.md est indiqué comme référence. Vous pouvez cliquer sur la référence pour ouvrir le fichier.

Lectures complémentaires

Remarque

Cette fonctionnalité est actuellement en cours préversion publique et peut être modifiée.

Cette version de l’article concerne l’utilisation des instructions personnalisées du dépôt dans Eclipse. Cliquez sur les onglets ci-dessus pour obtenir les indications sur l’utilisation des instructions personnalisées dans d’autres environnements.

Présentation

Les instructions personnalisées du référentiel vous permettent de fournir à Copilot des instructions et des préférences spécifiques au référentiel. Pour plus d’informations, consultez « À propos de la personnalisation des réponses GitHub Copilot ».

Conditions préalables pour les instructions personnalisées du référentiel

  • Vous devez disposer d'un fichier d'instructions personnalisé (voir les instructions ci-dessous).

  • La dernière version de l’extension Copilot doit être installée dans Eclipse.

Création d’instructions personnalisées

Eclipse prend en charge deux types d’instructions personnalisées du dépôt : les instructions personnalisées de l’espace de travail et les instructions personnalisées du projet.

Pour créer un fichier d’instructions personnalisées d’espace de travail, vous pouvez utiliser la Copilot page des paramètres. Pour créer un fichier d’instructions personnalisées du projet, vous pouvez créer le fichier manuellement dans le répertoire du projet.

L'espacement entre les instructions est ignoré, de sorte que les instructions peuvent être écrites comme un seul paragraphe, chacune sur une nouvelle ligne, ou séparées par des lignes vides pour plus de lisibilité.

Création d’un fichier d’instructions personnalisées de l’espace de travail

  1. Pour ouvrir le Discussion avec Copilot panneau, cliquez sur l’icône Copilot () dans la barre d’état en bas d’Eclipse.
  2. Dans le menu, sélectionnez « Modifier les préférences ».
  3. Dans le volet gauche, développez GitHub Copilot et cliquez sur Instructions personnalisées.
  4. Sélectionnez Activer les instructions de l’espace de travail.
  5. Dans la section « Espace de travail », sous « Définir des instructions personnalisées pour guider Copilotles suggestions de code dans cet espace de travail », ajoutez des instructions en langage naturel au fichier, au format Markdown.

Création d’un fichier d’instructions personnalisées du projet

  1. À la racine du répertoire de votre projet, créez un fichier nommé .github/copilot-instructions.md.
  2. Ajoutez vos instructions personnalisées en langage naturel à l’aide du format Markdown.

Une fois enregistrées, ces instructions s’appliquent au projet actuel dans Eclipse que vous ouvrez avec Copilot activé.

Avez-vous réussi à ajouter un fichier d’instructions personnalisé à votre référentiel ?

          <a href="https://docs.github.io/success-test/yes.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline">
          <span>Oui</span></a><a href="https://docs.github.io/success-test/no.html" target="_blank" class="btn btn-outline mt-3 mr-3 no-underline"><span>Non</span></a>

Instructions personnalisées en cours d’utilisation

Les instructions du fichier ou des fichiers sont disponibles pour une utilisation par Copilot dès que vous enregistrez le fichier ou les fichiers. Les instructions sont automatiquement ajoutées aux demandes que vous envoyez à Copilot.

Lectures complémentaires