Skip to main content

À propos des agents personnalisés

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

À 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.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 ».

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 :