Erstellen und verwenden von kundenspezifischen Agenten für GitHub Copilot-CLI

Einleitung

Benutzerdefinierte Agents ermöglichen Ihnen das Anpassen des Fachwissens von Copilot für bestimmte Aufgaben.

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

Die von einem Benutzerdefinierter Agent ausgeführte Arbeit wird von einem Subagent durchgeführt. Dieser temporäre Agent wird erstellt, um die Aufgabe zu erledigen. 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 Teile der Arbeit, insbesondere größere Aufgaben, an Benutzerdefinierte Agenten ausgelagert werden, ohne das Kontextfenster des Hauptagents 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 Markdowndatei 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 eine Option zum Erstellen von Benutzerdefinierter Agent im Repository oder im Startverzeichnis:

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

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

   Hinweis

   Wenn Sie Benutzerdefinierte Agenten mit demselben Namen an beiden Speicherorten haben, wird der Name in Ihrem Startverzeichnis anstelle dessen im Repository verwendet.

4. Wählen Sie, ob Sie Copilot abrufen möchten, um die Datei Benutzerdefinierter Agent zu erstellen, oder ob Sie die Datei selbst erstellen möchten.

          **Option 1: Copilot verwenden**
   

   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 nimmt die Beschreibung, die Sie eingeben, und nutzt sie, um ein Agentenprofil für Sie zu erstellen.

   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.
   

   Nachdem Copilot das Erstellen des ersten Agentprofils abgeschlossen hat, 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

      Um die Verwendung eines Benutzerdefinierter Agent programmgesteuert zu vereinfachen, 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 Tools Ihre Benutzerdefinierter Agent zugreifen kann.

   Standardmäßig haben 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 Ihren neuen Benutzerdefinierter Agent zu laden.

Verwenden eines Benutzerdefinierter Agent

Benutzerdefinierte Agents kann auf die folgenden Arten verwendet werden:

•         **Slash-Befehl**
  

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

  Hinweis

  Die Standard-Agents der CLI sind in dieser Liste nicht enthalten. Weitere Informationen zu den Standard-Agents finden Sie unter Verwenden der GitHub Copilot-CLI.

•         **Explizite Anweisung**
  

  Fordern Sie Copilot auf, einen bestimmten Agenten 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 ermittelt automatisch den Agent, den Sie verwenden möchten.

•         **Programmgesteuert**
  

  Geben Sie den Benutzerdefinierter Agent an, den Sie mit der Kommandozeile verwenden möchten. Beispiel:

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

  Bei security-auditor handelt es sich um den Dateinamen des Benutzerdefinierter Agent-Profils ohne .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/tutorials/customization-library/custom-agents) – eine kuratierte Sammlung von Beispielen