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.
-
En mode interactif, entrez
/agent. -
Sélectionnez Créer un agent dans la liste des options.
-
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.
-
-
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.
-
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.
-
Entrez une description qui indique l’expertise de cet agent et le moment où il doit être utilisé.
-
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.
-
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
toolsspécification est ajoutée au fichier de l’agent. -
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
/agenten 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 problemsou (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-auditorest 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 dansnamele profil de l’agent.