À 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é.
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.mddans votre référentiel pour les agents spécifiques au projet. - Niveau d'organisation ou d'entreprise : Créer
/agents/CUSTOM-AGENT-NAME.mddans un référentiel.github-privatepour 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 ».
Où vous pouvez utiliser agents personnalisés
Remarque
Les Agents personnalisés sont en préversion publique pour les IDEs JetBrains, Eclipse et Xcode, et sont susceptibles d'être modifiées.
Une fois que vous avez créé agents personnalisés, ils deviennent disponibles pour :
Agent cloud Copilot sur GitHub.com**: onglet agents et panneau, assignation de problème et pull requests
Agent cloud Copilot in IDEs** : Visual Studio Code, JetBrains IDEs, Eclipse et Xcode
- CLI GitHub Copilot
Vous pouvez utiliser profils d’agent directement dans Visual Studio Code, JetBrains IDEs, Eclipse et Xcode. Certaines propriétés peuvent fonctionner différemment ou être ignorées entre les environnements.
Pour plus d’informations sur l’utilisation agents personnalisés dans Visual Studio Code, consultez Agents personnalisés .VS Code
Étapes suivantes
Pour créer votre propre agents personnalisés, consultez :