{"meta":{"title":"Création d’agents personnalisés pour Copilot cloud agent dans votre IDE","intro":"Vous pouvez créer des agents spécialisés avec une expertise personnalisée pour des tâches de développement spécifiques.","product":"GitHub Copilot","breadcrumbs":[{"href":"/fr/copilot","title":"GitHub Copilot"},{"href":"/fr/copilot/how-tos","title":"Procédures"},{"href":"/fr/copilot/how-tos/use-copilot-agents","title":"Utiliser des agents Copilot"},{"href":"/fr/copilot/how-tos/use-copilot-agents/cloud-agent","title":"Cloud agent"},{"href":"/fr/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents-in-your-ide","title":"Créer des agents personnalisés dans votre IDE"}],"documentType":"article"},"body":"# Création d’agents personnalisés pour Copilot cloud agent dans votre IDE\n\nVous pouvez créer des agents spécialisés avec une expertise personnalisée pour des tâches de développement spécifiques.\n\nCustom agents vous permet de personnaliser Copilotl’expertise de l’entreprise pour des tâches spécifiques. Pour obtenir une vue d’ensemble conceptuelle de custom agents, consultez [À propos des agents personnalisés](/fr/copilot/concepts/agents/cloud-agent/about-custom-agents).\n\n> \\[!NOTE]\n> Les Custom agents sont en préversion publique pour les IDEs JetBrains, Eclipse et Xcode, et sont susceptibles d'être modifiées.\n\n<div class=\"ghd-tool vscode\">\n\n## Création d’un custom agent profil\n\n1. Ouvrir GitHub Copilot Chat dans Visual Studio Code.\n2. Dans la liste déroulante des agents en bas de l’affichage conversation, cliquez sur **Configurer des agents personnalisés...**, puis sur **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-plus\" aria-label=\"Plus button\" role=\"img\"><path d=\"M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z\"></path></svg> Créer custom agent**.\n3. Choisissez l’emplacement où le agent profile doit être créé :\n   * **Espace de** travail : créez le custom agent profil dans le `.github/agents` dossier de votre espace de travail pour l’utiliser uniquement dans cet espace de travail.\n   * **Profil utilisateur** : créez le custom agent profil dans le dossier de profil utilisateur actuel pour l’utiliser dans tous vos espaces de travail.\n4. Entrez un nom de fichier pour le custom agent. Il s’agit du nom par défaut qui apparaît dans la liste déroulante des agents.\n5. Configurez le agent profile dans le fichier nouvellement créé `.agent.md`, en y incluant la description, les outils et les invitations. Pour plus d’informations sur ce que l’élément agent profile peut inclure, consultez [Configuration d’un agent profile](#configuring-an-agent-profile).\n   * Vous pouvez utiliser le bouton **Configurer les outils...** dans l’éditeur pour ouvrir la boîte de dialogue « Configurer des outils », où vous pouvez afficher et sélectionner des outils disponibles, y compris des outils et outils intégrés à partir de serveurs MCP. Cliquez sur **OK** pour ajouter des outils sélectionnés au agent profile.\n   * Pour définir le modèle IA que l’agent utilise, ajoutez un `model:` attribut et sélectionnez votre modèle préféré dans la liste déroulante d'autocomplétion.\n\nPour mettre à jour un agent profileagent, sélectionnez **Configurer des agents personnalisés** dans la liste déroulante des agents, puis cliquez sur un agent dans la liste pour le modifier. Pour plus d’informations sur custom agents dans VS Code, consultez [Custom agents dans VS Code](https://code.visualstudio.com/docs/copilot/customization/custom-agents).\n\n</div>\n\n<!-- --------------------- -->\n\n<!-- JetBrains -->\n\n<!-- --------------------- -->\n\n<div class=\"ghd-tool jetbrains\">\n\n## Créer un custom agent profil\n\n1. Ouvrez la GitHub Copilot Chat fenêtre dans votre IDE JetBrains.\n2. Dans la liste déroulante des agents en bas de l’affichage conversation, cliquez sur **Configurer les agents...**, puis, dans la fenêtre paramètres, sous « Agents de conversation », cliquez sur **Espace de travail**.\n3. Entrez un nom de fichier pour le custom agent. Il s’agit du nom par défaut qui apparaît dans la liste déroulante des agents.\n4. Configurez le agent profile dans le fichier `.agent.md` nouvellement créé du répertoire `.github/agents`, y compris la description, les outils et les commandes. Pour plus d’informations sur ce que l’élément agent profile peut inclure, consultez [Configuration d’un agent profile](#configuring-an-agent-profile).\n   * Vous pouvez utiliser le bouton **Configurer les outils...** dans l’éditeur pour ouvrir la boîte de dialogue outils, où vous pouvez afficher et sélectionner des outils disponibles, y compris des outils et outils intégrés à partir de serveurs MCP. Cliquez sur **Appliquer** pour ajouter des outils sélectionnés à l’objet agent profile.\n   * Pour définir le modèle IA que l’agent utilise, ajoutez un `model:` attribut et sélectionnez votre modèle préféré dans la liste déroulante d'autocomplétion.\n\nPour mettre à jour un agent profileagent personnalisé, sélectionnez **Configurer des agents personnalisés** dans la liste déroulante des agents, puis cliquez en <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-pencil\" aria-label=\"The pencil icon\" role=\"img\"><path d=\"M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z\"></path></svg> regard de l’agent que vous souhaitez modifier.\n\n</div>\n\n<!-- --------------------- -->\n\n<!-- Eclipse -->\n\n<!-- --------------------- -->\n\n<div class=\"ghd-tool eclipse\">\n\n## Création d’un profil custom agent\n\n1. Ouvrez la GitHub Copilot Chat fenêtre dans Eclipse.\n2. Dans la liste déroulante des agents en bas de l’affichage conversation, cliquez sur **Configurer les agents...**, puis sur **Ajouter...**.\n3. Entrez un nom de fichier pour le custom agent. Il s’agit du nom par défaut qui apparaît dans la liste déroulante des agents.\n4. Configurez le agent profile dans le fichier `.agent.md` nouvellement créé du répertoire `.github/agents`, y compris la description, les outils et les commandes. Pour plus d’informations sur ce que l’élément agent profile peut inclure, consultez [Configuration d’un agent profile](#configuring-an-agent-profile).\n   * Vous pouvez utiliser le bouton **Configurer les outils...** dans l’éditeur pour ouvrir la boîte de dialogue « Configurer des outils », où vous pouvez afficher et sélectionner des outils disponibles, y compris des outils et outils intégrés à partir de serveurs MCP. Cliquez sur **Appliquer** pour ajouter des outils sélectionnés à l’objet agent profile.\n   * Pour définir le modèle IA que l’agent utilise, ajoutez un `model:` attribut et sélectionnez votre modèle préféré dans la liste déroulante d'autocomplétion.\n\nPour mettre à jour un agent profile, sélectionnez **Configurer les agents...** dans la liste déroulante des agents, puis sélectionnez l’agent que vous souhaitez modifier, puis cliquez sur **Modifier**.\n\n</div>\n\n<!-- --------------------- -->\n\n<!-- XCode -->\n\n<!-- --------------------- -->\n\n<div class=\"ghd-tool xcode\">\n\n## Création d’un profil custom agent\n\n1. Ouvrez la GitHub Copilot Chat fenêtre dans Xcode.\n2. Dans la liste déroulante des agents en bas de la vue conversation, cliquez sur **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-plus\" aria-label=\"Plus button\" role=\"img\"><path d=\"M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z\"></path></svg> Créer un agent**.\n3. Entrez un nom de fichier pour le custom agent. Il s’agit du nom par défaut qui apparaît dans la liste déroulante des agents.\n4. Configurez le agent profile dans le fichier `.agent.md` nouvellement créé du répertoire `.github/agents`, y compris la description, les outils et les commandes. Pour plus d’informations sur ce que l’élément agent profile peut inclure, consultez [Configuration d’un agent profile](#configuring-an-agent-profile).\n   * Vous pouvez utiliser le bouton **Personnaliser l’agent** dans l’éditeur de fichiers pour ouvrir une boîte de dialogue, où vous pouvez sélectionner le modèle IA de l’agent à utiliser, sélectionner les outils disponibles (y compris les outils intégrés et les outils serveur MCP) et configurer la `handoffs` propriété pour la transition entre custom agents. Cliquez sur **Appliquer** pour ajouter des options sélectionnées au agent profile.\n\nPour mettre à jour un agent profile, dans la liste déroulante des agents, cliquez sur l’icône de crayon à côté de l’agent que vous souhaitez modifier.\n\n</div>\n\n## Configuration d’un agent profile\n\nIl s'agit d'un fichier Markdown avec un frontmatter YAML qui spécifie le nom, la description, les outils disponibles, et les configurations du serveur MCP. La configuration d’un agent profile implique la définition de l’identité, des fonctionnalités, de l’accès aux outils et des instructions comportementales de l’agent.\n\nPour obtenir des informations de configuration détaillées sur les propriétés YAML, les outils, la configuration du serveur MCP, les alias d’outils et la façon dont custom agents ils sont traités, consultez [Configuration des agents personnalisés](/fr/copilot/reference/custom-agents-configuration).\n\nPour configurer votre agent profile:\n\n1. Si vous le souhaitez, écrivez un `name` pour votre custom agent. Si ce paramètre n’est pas défini, le nom sera par défaut le nom de fichier (sans le suffixe `.md` ou `.agent.md`).\n2. Écrivez un bref texte (requis) expliquant ce que fait votre agent et ses capacités spécifiques ou son domaine d'expertise.\n3. Dans la `tools` propriété, définissez les outils que l’agent peut utiliser. Il s’agit d’une liste de noms d’outils ou d’alias, y compris les outils des serveurs MCP configurés dans les paramètres du référentiel ou le agent profile (par exemple, `tools: [\"read\", \"edit\", \"search\", \"some-mcp-server/tool-1\"]`). Si vous omettez cette propriété, l’agent aura accès à tous les outils disponibles. Consultez « Outils » dans [Configuration des agents personnalisés](/fr/copilot/reference/custom-agents-configuration#tools).\n4. Si vous le souhaitez, dans la `mcp-servers` propriété, vous pouvez configurer des serveurs MCP qui seront disponibles uniquement pour cet agent afin d’étendre ses fonctionnalités. Consultez « Détails de la configuration du serveur MCP » dans [Configuration des agents personnalisés](/fr/copilot/reference/custom-agents-configuration#mcp-server-configuration-details).\n5. Si vous créez et utilisez le agent profile dans les IDE JetBrains, Eclipse ou Xcode, vous pouvez également utiliser la propriété VS Code pour contrôler le modèle d'IA que l'agent doit utiliser.\n6. Si vous le souhaitez, définissez la propriété `target` sur `vscode` ou `github-copilot` si vous souhaitez uniquement utiliser l’agent dans un environnement spécifique. L’agent sera disponible dans les deux environnements si vous omettez la propriété.\n7. Écrivez les instructions de l’agent. Définissez le comportement, l’expertise et les instructions de l’agent dans le contenu Markdown sous le frontmatter YAML. L’invite peut comporter au maximum 30 000 caractères.\n\n## Exemple agent profiles\n\nLes exemples suivants montrent ce qu’un agent profile pourrait ressembler aux tâches courantes d’écriture de tests ou de planification de l’implémentation d’un projet. Pour vous inspirer davantage, consultez les exemples [Custom agents](/fr/copilot/tutorials/customization-library/custom-agents) dans la bibliothèque de personnalisation. Vous trouverez également des exemples plus spécifiques dans la collection [awesome-copilot](https://github.com/github/awesome-copilot/tree/main/agents) de la communauté.\n\n### Spécialiste des tests\n\nCet exemple active tous les outils en omettant la `tools` propriété.\n\n```text copy\n---\nname: test-specialist\ndescription: Focuses on test coverage, quality, and testing best practices without modifying production code\n---\n\nYou are a testing specialist focused on improving code quality through comprehensive testing. Your responsibilities:\n\n- Analyze existing tests and identify coverage gaps\n- Write unit tests, integration tests, and end-to-end tests following best practices\n- Review test quality and suggest improvements for maintainability\n- Ensure tests are isolated, deterministic, and well-documented\n- Focus only on test files and avoid modifying production code unless specifically requested\n\nAlways include clear test descriptions and use appropriate testing patterns for the language and framework.\n```\n\n### Planificateur d’implémentation\n\nCet exemple active uniquement un sous-ensemble d’outils.\n\n```text copy\n---\nname: implementation-planner\ndescription: Creates detailed implementation plans and technical specifications in markdown format\ntools: [\"read\", \"search\", \"edit\"]\n---\n\nYou are a technical planning specialist focused on creating comprehensive implementation plans. Your responsibilities:\n\n- Analyze requirements and break them down into actionable tasks\n- Create detailed technical specifications and architecture documentation\n- Generate implementation plans with clear steps, dependencies, and timelines\n- Document API designs, data models, and system interactions\n- Create markdown files with structured plans that development teams can follow\n\nAlways structure your plans with clear headings, task breakdowns, and acceptance criteria. Include considerations for testing, deployment, and potential risks. Focus on creating thorough documentation rather than implementing code.\n```\n\n## Utilisation de custom agents\n\nUne fois que vous avez créé un custom agent, vous pouvez l’utiliser partout où Copilot cloud agent il est disponible.\n\n* Lorsque vous êtes invité à Copilot cloud agent avec une tâche sur GitHub.com, utilisez le menu déroulant dans le panneau des agents ou l’onglet Agents pour sélectionner votre custom agent au lieu de cloud agent par défaut.\n* Lorsque vous attribuez Copilot cloud agent à un problème, vous pouvez sélectionner votre custom agent dans le menu déroulant pour gérer le problème avec votre configuration spécialisée.\n* Lorsque vous utilisez le GitHub Copilot CLI, vous pouvez choisir d’utiliser un custom agent particulier en utilisant la commande slash `/agent`, en référençant l’agent dans une invite ou via un argument de ligne de commande. Pour plus d’informations, consultez « [Utilisation du CLI GitHub Copilot](/fr/copilot/how-tos/copilot-cli/use-copilot-cli/overview#use-custom-agents) ».\n\nLorsque Copilot ouvre des pull requests, il indique quel custom agent a été utilisé pour effectuer le travail dans la description de la pull request.\n\nPour plus d’informations sur l’utilisation d’Copilot cloud agent, consultez « [Démarrage des sessions GitHub Copilot](/fr/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions) ».\n\n### Utilisation custom agents dans votre IDE\n\nVous pouvez également utiliser votre code personnalisé agent profiles directement dans les IDE pris en charge. Vous pouvez basculer entre les agents à l'aide de la liste déroulante située dans la fenêtre de chat, ce qui vous permet d’accéder à des configurations spécialisées pour différentes tâches telles que la planification, la modification de code ou la recherche.\n\nCertaines propriétés peuvent fonctionner différemment entre l’environnement GitHub.com et l’environnement IDE. Pour plus d’informations sur les propriétés prises en charge, consultez [Configuration des agents personnalisés](/fr/copilot/reference/custom-agents-configuration#yaml-frontmatter-properties).\n\nPour plus d’informations plus précisément sur custom agents dans VS Code, consultez [Custom agents dans VS Code](https://code.visualstudio.com/docs/copilot/customization/custom-agents) la documentation VS Code.\n\n## Étapes suivantes\n\n* Pour obtenir un didacticiel pratique pour créer votre premier custom agent, consultez [Votre premier agent personnalisé](/fr/copilot/tutorials/customization-library/custom-agents/your-first-custom-agent).\n* Pour obtenir des informations de configuration détaillées, consultez [Configuration des agents personnalisés](/fr/copilot/reference/custom-agents-configuration).\n* Pour plus d'informations sur l'utilisation des agents cloud, y compris vos custom agents, pour démarrer des sessions Copilot, consultez [Démarrage des sessions GitHub Copilot](/fr/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions)."}