À propos des agents personnalisés

Custom agents améliorer Copilot avec une assistance adaptée à vos besoins.

Dans cet article

À propos de custom agents

Custom agents 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 custom agents à l’aide de fichiers Markdown appelés agent profiles. 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.

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

Agent profile Format

Agent profiles sont des fichiers Markdown avec le frontmatter YAML. Dans leur forme la plus simple, ils incluent :

  • Nom (facultatif) : un nom d'affichage pour le custom agent. 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.

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

Exemple agent profile

Cet exemple est un modèle de base agent profile 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 custom agents

Vous pouvez définir agent profiles à 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 de l’organisation : créez /agents/CUSTOM-AGENT-NAME.md dans le référentiel .github ou .github-private de l’organisation pour une disponibilité plus large au sein de l’organisation.
  • Niveau Entreprise : créez /agents/CUSTOM-AGENT-NAME.md dans le .github-private référentiel d’une organisation qu’un propriétaire d’entreprise a désigné dans les paramètres d’entreprise pour la disponibilité dans tous les référentiels de l’entreprise.

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 custom agents

Remarque

Les Custom agents 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éé custom agents, ils deviennent disponibles pour :

  • Copilot cloud agent sur GitHub.com   : l’onglet et le panneau des agents, l’assignation des issues et les pull requests
  • Copilot cloud agent dans les IDE: Visual Studio Code, IDE JetBrains, Eclipse et Xcode
  • GitHub Copilot CLI

Vous pouvez utiliser agent profiles 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 custom agents dans Visual Studio Code, consultez Custom agents .VS Code

Étapes suivantes

Pour créer votre propre custom agents, consultez :