Création et utilisation d’agents personnalisés pour GitHub Copilot CLI

Présentation

Custom agentsLes vous permettent d’adapter l’expertise de Copilot à des tâches spécifiques.

Lorsque vous êtes invité Copilot à effectuer une tâche, il peut choisir d’utiliser l’un de vos custom agents, si Copilot vous déterminez que l’expertise de l’agent est adaptée à la tâche.

Le travail réalisé par un custom agent est effectué à l'aide d'un sous-agent, qui est un agent temporaire déployé pour terminer la tâche. Le sous-agent possède sa propre fenêtre de contexte, qui peut être remplie par des informations qui ne sont pas pertinentes pour l’agent principal. De cette façon, en particulier pour les tâches plus volumineuses, certaines parties du travail peuvent être déchargées vers custom agents, sans encombrer la fenêtre de contexte de l’agent principal. L’agent principal peut ensuite se concentrer sur la planification et la coordination de niveau supérieur.

Pour plus d’informations, consultez « À propos des agents personnalisés ».

Création d’un custom agent

Chacun custom agent est défini par un fichier Markdown avec une .agent.md extension. Vous pouvez créer ces fichiers vous-même ou les ajouter à partir de l’interface CLI, comme décrit dans les étapes suivantes.

1. En mode interactif, entrez /agent.

2. Sélectionnez Créer un agent dans la liste des options.

3. Choisissez entre les options pour créer custom agent soit dans le référentiel, soit dans votre répertoire personnel :

   • Projet (.github/agents/)

   • Utilisateur (~/.copilot/agents/)

   Remarque

   Si vous avez custom agents le même nom dans les deux emplacements, celui de votre répertoire de base sera utilisé, plutôt que celui du référentiel.

4. Choisissez si vous souhaitez que Copilot crée le fichier custom agent, ou le créer vous-même.

Option 1 : Utiliser Copilot

Entrez les détails de l’agent que vous souhaitez créer. Décrivez l’expertise de l’agent et quand l’agent doit être utilisé. Copilot prend la description que vous entrez et l’utilise pour écrire un profil d’agent pour vous.

Par exemple, vous pourriez saisir :

I am a security expert. I check code files thoroughly for potential security issues. Use me whenever a security review/check/audit is requested for one or more code files, or when the word "seccheck" is used in a prompt in reference to code files.

I will identify potential problems, such as code that:

- Exposes secrets or credentials
- Allows cross-site scripting
- Allows SQL injection
- Contains vulnerable dependencies
- Allows authentication to be bypassed

If any problems are identified, create a single GitHub issue in this repository on GitHub.com with details of problems, giving full details of each issue, including, but not limited to, risk level and recommended fix.

Une fois que le profil d’agent initial a été généré par Copilot, il affiche les options suivantes :

• Continuer
• Examiner le contenu
• Réessayez
• Quitter

Si vous choisissez de passer en revue le contenu, le fichier agent est ouvert dans votre éditeur par défaut. Vous pouvez passer en revue et apporter des modifications, si nécessaire, avant de poursuivre le processus de création de l’agent dans l’interface CLI.

Pour terminer le processus de création, choisissez Continuer.

Option 2 : Créer le profil d’agent manuellement

Lorsque vous choisissez de créer le fichier d’agent vous-même, vous serez guidé dans une série d’invites pour renseigner les informations nécessaires pour créer le profil de l’agent.

1. Entrez un nom pour l’agent. Le nom que vous saisissez est le nom qui s'affiche lors de la liste des agents disponibles. Une version de cette opération sera utilisée comme nom du fichier de l’agent, par exemple, si vous entrez « Expert en sécurité », le fichier de l’agent sera nommé security-expert.agent.md.

   Conseil

   Pour faciliter l’utilisation d’un custom agent code par programmation, il est recommandé de choisir un nom composé uniquement de lettres minuscules et de traits d’union.

2. Entrez une description qui indique l’expertise de cet agent et le moment où il doit être utilisé.

3. Entrez des instructions sur le comportement de l’agent, y compris les instructions spécifiques, les actions qu’il doit prendre ou les contraintes qu’il doit suivre.

4. Choisissez les outils auxquels vous souhaitez que votre custom agent ait accès.

   Par défaut, custom agents ont accès à tous les outils. Si vous limitez l’accès d’un agent, une tools spécification est ajoutée au fichier de l’agent.

5. Redémarrez l’interface en ligne de commande pour charger votre nouveau custom agent.

Utilisation d’un custom agent

Custom agents peut être utilisé de la manière suivante :

• Commande slash

  Entrez /agent en mode interactif et choisissez dans la liste des éléments disponibles custom agents. Entrez ensuite une invite qui sera transmise à l’agent sélectionné.

  Remarque

  Les agents par défaut de l’interface CLI ne sont pas inclus dans cette liste. Pour plus d’informations sur les agents par défaut, consultez À propos des agents personnalisés.

• Instruction explicite

  Demandez à Copilot d'utiliser un agent spécifique. Par exemple:

  Use the security-auditor agent on all files in the /src/app directory
  

• Par inférence

  Utilisez une commande qui déclenche l’utilisation d’un agent particulier en fonction de la description dans le fichier de l’agent. Par exemple:

  Check all TypeScript files in or under the src directory for potential security problems
  

  ou (où « seccheck » est défini comme un mot de déclencheur dans le profil de l’agent) :

  seccheck /src/app/validator.go
  

Copilot déduit automatiquement l’agent que vous souhaitez utiliser.

• Programmatiquement

  Spécifiez l’option custom agent que vous souhaitez utiliser avec l’option de ligne de commande. Par exemple:

  copilot --agent security-auditor --prompt "Check /src/app/validator.go"
  

  Là où security-auditor est le nom de fichier du profil custom agent, sans l’extension .agent.md. En règle générale, mais pas nécessairement, il s’agit de la même valeur que dans name le profil de l’agent.

Appliquer les instructions personnalisées de votre dépôt à un custom agent

Les fichiers d’instructions personnalisés, tels que .github/copilot-instructions.md, AGENTS.mdet CLAUDE.md- indiquent Copilot comment fonctionner dans votre référentiel. Pour plus d’informations, consultez « Ajout d’instructions personnalisées de référentiel pour GitHub Copilot ».

Lorsque Copilot exécute votre custom agent en tant que sous-agent — pour traiter une partie d’une tâche plus vaste — le sous-agent ne suit pas par défaut les instructions personnalisées de votre dépôt. Cela permet de garder le sous-agent concentré sur la tâche spécifique qu’il a donnée.

Si vous souhaitez qu’un sous-agent suive les conventions de votre référentiel( par exemple, un agent qui passe en revue ou modifie du code), ajoutez-y include-custom-instructions: true le frontmatter du fichier agent :

---
name: RepoAwareReviewer
description: Reviews a change against this repository's conventions
tools: ["*"]
include-custom-instructions: true
---

Review the change and flag anything that violates the repository's conventions.

Pour plus d’informations, notamment sur la façon dont ce paramètre interagit avec l’option --no-custom-instructions , consultez Référence de commande CLI pour GitHub Copilot.

Lectures complémentaires

• Comparaison des fonctionnalités de personnalisation GitHub Copilot CLI
• Configuration des agents personnalisés
• Référence de commande CLI pour GitHub Copilot
• Agents personnalisés : collection organisée d’exemples