À propos des agents personnalisés

          Agents personnalisés améliorer Copilot avec une assistance adaptée à vos besoins.

Dans cet article

À propos de agents personnalisés

          Agents personnalisés sont des versions spécialisées de l’agent Copilot que vous pouvez adapter à vos workflows uniques, conventions de codage et cas d’usage. Ils agissent comme des collègues personnalisés qui suivent vos normes, utilisent les outils appropriés et implémentent des pratiques spécifiques à l’équipe. Vous définissez ces agents une fois au lieu de fournir à plusieurs reprises les mêmes instructions et le même contexte.

Vous définissez agents personnalisés à l’aide de fichiers Markdown appelés profils d’agent. Ces fichiers spécifient des invites, des outils et des serveurs MCP. Cela vous permet d’encoder vos conventions, frameworks et résultats souhaités directement dans Copilot.

          profil d’agent définit le comportement de assistant personnalisé. Lorsque vous affectez l’agent à une tâche ou à un problème, il instancie le assistant personnalisé.

En plus de agents personnalisés que vous définissez vous-même, Copilot inclut un ensemble de agents personnalisés prédéfinis. Consultez les agents intégrés.

          Profil de l’agent Format

          Profils de l’agent sont des fichiers Markdown avec le frontmatter YAML. Dans leur forme la plus simple, ils incluent :

* Nom (facultatif) : un nom d'affichage pour le assistant personnalisé. S’il est omis, le nom de fichier de l’agent est utilisé comme identificateur et nom d’affichage par défaut. * Description : explique l’objectif et les fonctionnalités de l’agent. * Invite de commande : instructions personnalisées qui définissent le comportement et l'expertise de l'agent. * Outils (facultatifs) : des outils spécifiques que l’agent peut accéder. Par défaut, les agents peuvent accéder à tous les outils disponibles, y compris les outils intégrés et les outils serveur MCP.

          Profils de l’agent peut également inclure des configurations de serveur MCP à l’aide de la `mcp-servers` propriété.

Exemple profil d’agent

Cet exemple est un modèle de base profil d’agent avec le nom, la description et l’invite configurés.

---
name: readme-creator
description: Agent specializing in creating and improving README files
---

You are a documentation specialist focused on README files. Your scope is limited to README files or other related documentation files only - do not modify or analyze code files.

Focus on the following instructions:
- Create and update README.md files with clear project descriptions
- Structure README sections logically: overview, installation, usage, contributing
- Write scannable content with proper headings and formatting
- Add appropriate badges, links, and navigation elements
- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository
- Make links descriptive and add alt text to images

Où vous pouvez configurer agents personnalisés

Vous pouvez définir profils d’agent à différents niveaux :

  •         **Niveau de référentiel** : créez `.github/agents/CUSTOM-AGENT-NAME.md` dans votre référentiel pour les agents spécifiques au projet.

  •         **Niveau d'organisation ou d'entreprise** : Créer `/agents/CUSTOM-AGENT-NAME.md` dans un référentiel `.github-private` pour une plus large disponibilité.

Pour plus d’informations, consultez « Préparation à l’utilisation d’agents personnalisés dans votre organisation » et « Préparation à l’utilisation d’agents personnalisés dans votre entreprise ».

Agents intégrés

Outre l’agent principal Copilot , qui traite votre demande lorsque vous envoyez une invite, Copilot CLI inclut les agents intégrés suivants que l’agent principal peut exécuter en tant que sous-agents pour faciliter les tâches de développement courantes. Ces agents sont optimisés pour optimiser l’efficacité et la précision, en tirant parti des fonctionnalités des modèles et outils de langage sous-jacents pour fournir une assistance de haute qualité dans leurs domaines respectifs.

          Copilot utilise automatiquement un agent intégré approprié en fonction de votre invite et du contexte actuel. Par exemple, l’invite `How does authentication work in this codebase?` déclenche généralement l’agent Explorer et l’utilisation de la `/research` commande barre oblique déclenche l’agent Research.

* explorer : agent d’exploration de base de code rapide et léger. Il utilise l’intelligence du code, grep, glob, view et les outils shell pour rechercher des fichiers et comprendre la structure du code. Il ne modifie aucun fichier. Il peut donc être appelé en parallèle avec d’autres sous-agents exécutés par l’agent principal Copilot . Il dispose d’un accès en lecture seule aux outils de serveur MCP GitHub.

  •         **tâche** : agent d’exécution de commande qui exécute les commandes de développement (tests, builds, linters, formateurs, installations de dépendances) et signale efficacement les résultats. Elle retourne un bref résumé en cas de réussite et un résultat complet en cas d’échec, tout en gardant le contexte principal clair. Il a accès à tous les outils que l’agent parent peut utiliser (à l’exclusion de certains qui ne sont pas appropriés dans un contexte subagent), avec les mêmes autorisations accordées ou refusées.

  •         **usage général** : cet agent a essentiellement les mêmes fonctionnalités que l’agent principal Copilot . L’agent principal peut exécuter l’agent à usage général en tant que sous-agent pour faciliter toute tâche nécessitant une fenêtre de contexte distincte ou s’exécuter en parallèle si nécessaire.

  •         **révision du code** : passe en revue les modifications de code avec un ratio signal/bruit extrêmement élevé. Cet agent analyse les modifications intermédiaires/non mises en scène et les différences de branche, en exposant uniquement les problèmes qui importent réellement : bogues, vulnérabilités de sécurité, conditions de concurrence, fuites de mémoire et erreurs logiques. Il ne commente jamais le style ou la mise en forme. Il n’apporte aucune modification aux fichiers.

  •         **recherche** — Cet agent fonctionne en tant qu’ingénieur logiciel et spécialiste de la recherche au niveau du personnel. Il fournit des réponses exhaustives et minutieusement étudiées sur les bases de code, les API, les bibliothèques et l’architecture logicielle. Il utilise des outils de recherche et d'exploration GitHub, des outils de récupération et de recherche web, ainsi que des outils locaux. Contrairement aux autres agents, l'agent de recherche ne peut être invoqué qu'à l'aide de la commande slash `/research`. Il ne peut pas être déclenché automatiquement par l’agent principal.

Exécution d’agents en tant que sous-agents

L’un des avantages de l’utilisation d’agents personnalisés que vous avez définis vous-même ( ou les agents intégrés) est que l’agent principal Copilot peut les exécuter en tant que sous-agents avec une fenêtre de contexte distincte. Cela signifie que votre agent personnalisé, ou agent intégré, peut se concentrer sur une sous-tâche spécifique sans encombrer la fenêtre de contexte de l’agent principal.

Si nécessaire, les tâches effectuées par des sous-éléments peuvent être exécutées en parallèle, ce qui permet à la tâche globale d’être exécutée plus rapidement.

Pour plus d’informations, consultez « Comparaison des fonctionnalités de personnalisation GitHub Copilot CLI ».

Étapes suivantes

Pour créer votre propre agents personnalisés, consultez :

  •         [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)

  •         [AUTOTITLE](/copilot/reference/customization-cheat-sheet)