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

Créez des agents spécialisés avec une expertise personnalisée pour des tâches de développement spécifiques.

Dans cet article

Présentation

Agents personnalisés vous permettent de personnaliser l'expertise de Copilot pour des tâches spécifiques.

Lorsque vous invitez Copilot pour effectuer une tâche, il peut choisir d’utiliser l’un de vos agents personnalisés, si Copilot détermine que l’expertise de l’agent est adaptée à la tâche.

Le travail effectué par un assistant personnalisé est réalisé à l’aide d’un sous-agent, qui est un agent temporaire lancé pour accomplir 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 importantes, les parties du travail peuvent être déléguées à agents personnalisés, 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 assistant personnalisé

Chaque assistant personnalisé est défini par un fichier Markdown avec une extension .agent.md. 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 parmi les options pour créer le assistant personnalisé dans le référentiel ou dans votre répertoire personnel :

    •      **Projet** (`.github/agents/`)

    •      **Utilisateur** (`~/.config/copilot/agents/`)

    Remarque

    Si vous avez agents personnalisés portant 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 assistant personnalisé, 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 prendra la description que vous saisissez et l’utilisera pour rédiger 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 Copilot terminée la génération du profil d’agent initial, 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 assistant personnalisé de manière programmatique, il est recommandé de choisir des noms composés 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.

  5. Choisissez les outils auxquels votre assistant personnalisé doit avoir accès.

    Par défaut, agents personnalisés 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.

  6. Redémarrez le CLI pour charger votre nouveau assistant personnalisé.

Utilisation d’un assistant personnalisé

Agents personnalisés peuvent être utilisés des façons suivantes :

  •           **Commande slash**

    Saisissez /agent en mode interactif et choisissez dans la liste des agents personnalisés disponibles. 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 Utilisation de GitHub Copilot CLI.

  •         **Instruction explicite**

    Indiquez à 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 le assistant personnalisé que vous souhaitez utiliser avec l’option de ligne de commande. Par exemple:

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

    Où security-auditor correspond au nom de fichier du profil assistant personnalisé, 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.

Lectures complémentaires

  •         [AUTOTITLE](/copilot/concepts/agents/copilot-cli/comparing-cli-features)

  •         [AUTOTITLE](/copilot/reference/custom-agents-configuration)

  •         [AUTOTITLE](/copilot/tutorials/customization-library/custom-agents) : collection organisée d’exemples