Erstellen und Verwenden von benutzerdefinierten Agenten für GitHub Copilot-CLI

Einleitung

          Benutzerdefinierte Agents ermöglicht es Ihnen, die Expertise von Copilot auf bestimmte Aufgaben zuzuschneiden.

Wenn Sie Copilot dazu auffordern, eine Aufgabe auszuführen, kann es sich entscheiden, eine Ihrer Benutzerdefinierte Agenten zu nutzen, wenn Copilot feststellt, dass das Fachwissen des Agenten gut für die Aufgabe geeignet ist.

Die von einem Benutzerdefinierter Agent ausgeführte Arbeit wird von einem Subagenten durchgeführt, bei dem es sich um einen temporären Agenten handelt, der die Aufgabe ausführt. Der Subagent verfügt über ein eigenes Kontextfenster, das durch Informationen aufgefüllt werden kann, die für den Hauptagenten nicht relevant sind. Auf diese Weise können insbesondere bei größeren Aufgaben Teile der Arbeit auf Benutzerdefinierte Agenten ausgelagert werden, ohne das Kontextfenster des Haupt-Agents zu überladen. Der Hauptagent kann sich dann auf die Planung und Koordination auf höherer Ebene konzentrieren.

Weitere Informationen finden Sie unter Informationen zu benutzerdefinierten Agents.

Erstellen eines Benutzerdefinierter Agent

Jede Benutzerdefinierter Agent wird durch eine Markdown-Datei mit einer .agent.md Erweiterung definiert. Sie können diese Dateien selbst erstellen oder sie aus der CLI hinzufügen, wie in den folgenden Schritten beschrieben.

1. Geben Sie /agentim interaktiven Modus ein.

2. Wählen Sie " Neuen Agent erstellen" aus der Liste der Optionen aus.

3. Wählen Sie zwischen den Optionen, ob Sie das Benutzerdefinierter Agent im Repository oder im Heimverzeichnis erstellen möchten:

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

   •      **Benutzer** (`~/.copilot/agents/`)
     

   Hinweis

   Wenn Sie Benutzerdefinierte Agenten mit demselben Namen an beiden Speicherorten haben, wird die Datei in Ihrem Home-Verzeichnis anstelle der im Repository verwendet.

4. Wählen Sie aus, ob Copilot die Benutzerdefinierter Agent-Datei erstellen soll oder ob Sie sie selbst erstellen möchten.

          **Option 1: Verwenden Copilot**
   

   Geben Sie Details des Agents ein, den Sie erstellen möchten. Beschreiben Sie das Know-how des Agenten und wann der Agent verwendet werden soll. Copilot wird die von Ihnen eingegebene Beschreibung übernehmen und zum Schreiben eines Agentprofils für Sie verwenden.

   Sie könnten beispielsweise eingeben:

   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.
   

   Nach Copilot Abschluss des Generierens des ersten Agentprofils werden die folgenden Optionen angezeigt:

   • Weiter
   • Inhalt überprüfen
   • Noch mal versuchen
   • Beenden

   Wenn Sie den Inhalt überprüfen möchten, wird die Agentdatei in Ihrem Standard-Editor geöffnet. Sie können ggf. Änderungen überprüfen und vornehmen, bevor Sie den Agenterstellungsprozess in der CLI fortsetzen.

   Um den Erstellungsprozess abzuschließen, wählen Sie "Weiter" aus.

          **Option 2: Manuelles Erstellen des Agentprofils**
   

   Wenn Sie sich dafür entscheiden, die Agentdatei selbst zu erstellen, werden Sie durch eine Reihe von Eingabeaufforderungen geführt, um die erforderlichen Informationen auszufüllen, um das Agentprofil zu erstellen.

   1. Geben Sie einen Namen für den Agent ein. Der eingegebene Name ist der Name, der angezeigt wird, wenn Sie die verfügbaren Agents auflisten. Eine Version davon wird als Name der Agentdatei verwendet, z. B. wenn Sie "Sicherheitsexperte" eingeben, wird die Agentdatei benannt security-expert.agent.md.

      Tipp

      Für eine einfache Nutzung eines Benutzerdefinierter Agent empfiehlt es sich, einen Namen auszuwählen, der nur aus Kleinbuchstaben und Bindestrichen besteht.

   2. Geben Sie eine Beschreibung ein, die angibt, welche Expertise dieser Agent hat und wann es verwendet werden soll.

   3. Geben Sie Anweisungen für das Verhalten des Agents ein, einschließlich aller spezifischen Richtlinien, Aktionen, die er ergreifen sollte, oder Einschränkungen, die er befolgen sollte.

5. Wählen Sie, auf welche Werkzeuge Ihr Benutzerdefinierter Agent Zugriff haben sollte.

   Standardmäßig haben Sie, Benutzerdefinierte Agenten, Zugriff auf alle Tools. Wenn Sie den Zugriff eines Agents einschränken, wird der Agentdatei eine tools Spezifikation hinzugefügt.

6. Starten Sie die CLI neu, um das neue Benutzerdefinierter Agentzu laden.

Verwenden eines Benutzerdefinierter Agent

          Benutzerdefinierte Agents kann auf folgende Weise verwendet werden:

* Slash-Befehl

Geben Sie /agent im interaktiven Modus ein, und wählen Sie aus der Liste der verfügbaren Benutzerdefinierte Agenten. Geben Sie dann eine Eingabeaufforderung ein, die an den ausgewählten Agent übergeben wird.

•         **Explizite Anweisung**
  

  Weisen Sie Copilot an, einen bestimmten Agent zu verwenden. Beispiel:

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

•         **Nach Rückschlüssen**
  

  Verwenden Sie eine Eingabeaufforderung, die die Verwendung eines bestimmten Agents basierend auf der Beschreibung in der Agentdatei auslöst. Beispiel:

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

  oder (wobei "seccheck" als Triggerwort im Agentprofil definiert ist):

  seccheck /src/app/validator.go
  

          Copilot leitet automatisch den Agent ab, den Sie verwenden möchten.
  

•         **Programmgesteuert**
  

  Geben Sie Benutzerdefinierter Agent an, das Sie mit der Befehlszeilenoption verwenden möchten. Beispiel:

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

  Dabei security-auditor handelt es sich um den Dateinamen des Benutzerdefinierter Agent Profils, ohne die .agent.md Erweiterung. In der Regel entspricht dies jedoch nicht unbedingt dem name Wert im Agentprofil.

Weiterführende Lektüre

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

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

•         [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-command-reference#custom-agents-reference)
  

•         [AUTOTITLE](/copilot/tutorials/customization-library/custom-agents) – eine kuratierte Sammlung von Beispielen