{"meta":{"title":"Erstellen und Verwenden von benutzerdefinierten Agenten für GitHub Copilot CLI","intro":"Erstellen Sie spezialisierte Agenten mit maßgeschneiderter Expertise für spezifische Entwicklungsaufgaben.","product":"GitHub Copilot","breadcrumbs":[{"href":"/de/copilot","title":"GitHub Copilot"},{"href":"/de/copilot/how-tos","title":"Vorgehensweisen"},{"href":"/de/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/de/copilot/how-tos/copilot-cli/customize-copilot","title":"Das Copilot CLI anpassen"},{"href":"/de/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli","title":"Erstellen von benutzerdefinierten Agents"}],"documentType":"article"},"body":"# Erstellen und Verwenden von benutzerdefinierten Agenten für GitHub Copilot CLI\n\nErstellen Sie spezialisierte Agenten mit maßgeschneiderter Expertise für spezifische Entwicklungsaufgaben.\n\n## Einleitung\n\nCustom agents ermöglicht es Ihnen, die Expertise von Copilot auf bestimmte Aufgaben zuzuschneiden.\n\nWenn Sie Copilot dazu auffordern, eine Aufgabe auszuführen, kann es sich entscheiden, eine Ihrer custom agents zu nutzen, wenn Copilot feststellt, dass das Fachwissen des Agenten gut für die Aufgabe geeignet ist.\n\nDie von einem custom 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 custom agents 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.\n\nWeitere Informationen finden Sie unter [Informationen zu benutzerdefinierten Agents](/de/copilot/concepts/agents/copilot-cli/about-custom-agents).\n\n## Erstellen einer custom agent\n\nJede custom 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.\n\n1. Geben Sie `/agent`im interaktiven Modus ein.\n\n2. Wählen Sie \" **Neuen Agent erstellen\"** aus der Liste der Optionen aus.\n\n3. Wählen Sie zwischen den Optionen, ob Sie das custom agent im Repository oder im Heimverzeichnis erstellen möchten:\n\n   * **Project** (`.github/agents/`)\n\n   * **Benutzer** (`~/.copilot/agents/`)\n\n   > \\[!NOTE]\n   > Wenn Sie custom agents mit demselben Namen an beiden Speicherorten haben, wird die Datei in Ihrem Home-Verzeichnis anstelle der im Repository verwendet.\n\n4. Wählen Sie aus, ob Copilot die custom agent-Datei erstellen soll oder ob Sie sie selbst erstellen möchten.\n\n**Option 1: Verwenden Copilot**\n\nGeben Sie Details des Agents ein, den Sie erstellen möchten. Beschreiben Sie das Know-how des Agenten und wann der Agent verwendet werden soll.\nCopilot wird die von Ihnen eingegebene Beschreibung übernehmen und zum Schreiben eines Agentprofils für Sie verwenden.\n\nSie könnten beispielsweise eingeben:\n\n```text\nI 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.\n\nI will identify potential problems, such as code that:\n\n- Exposes secrets or credentials\n- Allows cross-site scripting\n- Allows SQL injection\n- Contains vulnerable dependencies\n- Allows authentication to be bypassed\n\nIf 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.\n```\n\nNach Copilot Abschluss des Generierens des ersten Agentprofils werden die folgenden Optionen angezeigt:\n\n* Weiter\n* Inhalt überprüfen\n* Noch mal versuchen\n* Beenden\n\nWenn 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.\n\nUm den Erstellungsprozess abzuschließen, wählen Sie **\"Weiter\"** aus.\n\n**Option 2: Manuelles Erstellen des Agentprofils**\n\nWenn 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.\n\n1. 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`.\n\n   > \\[!TIP]\n   > Für eine einfache Nutzung eines custom agent empfiehlt es sich, einen Namen auszuwählen, der nur aus Kleinbuchstaben und Bindestrichen besteht.\n\n2. Geben Sie eine Beschreibung ein, die angibt, welche Expertise dieser Agent hat und wann es verwendet werden soll.\n\n3. 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.\n\n4. Wählen Sie, auf welche Werkzeuge Ihr custom agent Zugriff haben sollte.\n\n   Standardmäßig haben Sie, custom agents, Zugriff auf alle Tools. Wenn Sie den Zugriff eines Agents einschränken, wird der Agentdatei eine `tools` Spezifikation hinzugefügt.\n\n5. Starten Sie die CLI neu, um das neue custom agentzu laden.\n\n## Verwenden eines custom agent\n\nCustom agents kann auf folgende Weise verwendet werden:\n\n* **Slash-Befehl**\n\n  Geben Sie `/agent` im interaktiven Modus ein, und wählen Sie aus der Liste der verfügbaren custom agents. Geben Sie dann eine Eingabeaufforderung ein, die an den ausgewählten Agent übergeben wird.\n\n  > \\[!NOTE]\n  > Die Standard-Agents der CLI sind in dieser Liste nicht enthalten. Weitere Informationen zu den Standard-Agents finden Sie unter [Informationen zu benutzerdefinierten Agents](/de/copilot/concepts/agents/copilot-cli/about-custom-agents#built-in-agents).\n\n* **Explizite Anweisung**\n\n  Weisen Sie Copilot an, einen bestimmten Agent zu verwenden. Beispiel:\n\n  ```copilot\n  Use the security-auditor agent on all files in the /src/app directory\n  ```\n\n* **Nach Rückschlüssen**\n\n  Verwenden Sie eine Eingabeaufforderung, die die Verwendung eines bestimmten Agents basierend auf der Beschreibung in der Agentdatei auslöst. Beispiel:\n\n  ```copilot\n  Check all TypeScript files in or under the src directory for potential security problems\n  ```\n\n  oder (wobei \"seccheck\" als Triggerwort im Agentprofil definiert ist):\n\n  ```copilot\n  seccheck /src/app/validator.go\n  ```\n\nCopilot leitet automatisch den Agent ab, den Sie verwenden möchten.\n\n* **Programmgesteuert**\n\n  Geben Sie custom agent an, das Sie mit der Befehlszeilenoption verwenden möchten. Beispiel:\n\n  ```shell\n  copilot --agent security-auditor --prompt \"Check /src/app/validator.go\"\n  ```\n\n  Dabei `security-auditor` handelt es sich um den Dateinamen des custom agent Profils, ohne die `.agent.md` Erweiterung. In der Regel entspricht dies jedoch nicht unbedingt dem `name` Wert im Agentprofil.\n\n## Weiterführende Lektüre\n\n* [Vergleich der GitHub Copilot CLI-Anpassungsmöglichkeiten](/de/copilot/concepts/agents/copilot-cli/comparing-cli-features)\n* [Konfiguration von benutzerdefinierten Agents](/de/copilot/reference/custom-agents-configuration)\n* [GitHub Copilot CLI-Befehlsreferenz](/de/copilot/reference/copilot-cli-reference/cli-command-reference#custom-agents-reference)\n* [Benutzerdefinierte Agents](/de/copilot/tutorials/customization-library/custom-agents) – eine kuratierte Sammlung von Beispielen"}