{"meta":{"title":"Erstellen von benutzerdefinierten Agenten für Copilot cloud agent in Ihrer IDE","intro":"Sie können spezielle Agenten mit maßgeschneiderter Expertise für bestimmte Entwicklungsaufgaben erstellen.","product":"GitHub Copilot","breadcrumbs":[{"href":"/de/copilot","title":"GitHub Copilot"},{"href":"/de/copilot/how-tos","title":"Vorgehensweisen"},{"href":"/de/copilot/how-tos/use-copilot-agents","title":"Copilot-Agents verwenden"},{"href":"/de/copilot/how-tos/use-copilot-agents/cloud-agent","title":"Cloud agent"},{"href":"/de/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents-in-your-ide","title":"Erstellen von benutzerdefinierten Agents in Ihrer IDE"}],"documentType":"article"},"body":"# Erstellen von benutzerdefinierten Agenten für Copilot cloud agent in Ihrer IDE\n\nSie können spezielle Agenten mit maßgeschneiderter Expertise für bestimmte Entwicklungsaufgaben erstellen.\n\nCustom agents ermöglicht es Ihnen, die Expertise von Copilot auf bestimmte Aufgaben zuzuschneiden. Eine konzeptionelle Übersicht über custom agents finden Sie unter [Informationen zu benutzerdefinierten Agents](/de/copilot/concepts/agents/cloud-agent/about-custom-agents).\n\n> \\[!NOTE]\n> Custom agents befinden sich in Öffentliche Vorschau für JetBrains IDEs, Eclipse und Xcode und können Änderungen unterliegen.\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n## Ein custom agent Profil erstellen\n\n1. Öffnen Sie das GitHub Copilot Chat Fenster in Eclipse.\n2. Klicken Sie in der Dropdownliste \"Agents\" unten in der Chatansicht auf **\"Agents konfigurieren...**\", und klicken Sie dann auf **\"Hinzufügen...\"**.\n3. Geben Sie einen Dateinamen für die custom agent. Dies ist der Standardname, der in der Dropdownliste \"Agents\" angezeigt wird.\n4. Konfigurieren Sie die agent profile neu erstellte `.agent.md` Datei im `.github/agents` Verzeichnis, einschließlich Beschreibung, Tools und Eingabeaufforderungen. Weitere Informationen dazu, was dies agent profile enthalten kann, finden Sie unter [Konfigurieren eines agent profile](#configuring-an-agent-profile).\n * Sie können die Schaltfläche \" **Tools konfigurieren...\"** im Editor verwenden, um das Dialogfeld \"Tools konfigurieren\" zu öffnen, in dem Sie verfügbare Tools anzeigen und auswählen können, einschließlich integrierter Tools und Tools von MCP-Servern. Klicken Sie auf **Übernehmen**, um die ausgewählten Tools zum agent profile hinzuzufügen.\n * Um festzulegen, welches KI-Modell der Agent verwendet, fügen Sie eine `model:` Eigenschaft hinzu, und wählen Sie ihr bevorzugtes Modell aus der Dropdownliste \"AutoVervollständigen\" aus.\n\nUm eine agent profileZu aktualisieren, wählen Sie **\"Agents konfigurieren\"** aus der Dropdownliste \"Agents\" aus, und wählen Sie dann den Agent aus, den Sie ändern möchten, und klicken Sie auf **\"Bearbeiten\"**.\n\n
\n\n\n\n\n\n\n\n\n\n## Konfigurieren einer agent profile\n\nEin agent profile ist eine Markdown-Datei mit einem YAML-Vorspann, der den Namen, die Beschreibung von custom agent, die verfügbaren Werkzeuge und die Konfigurationen des MCP-Servers angibt. Das Konfigurieren eines agent profile Elements umfasst das Definieren der Identität, Funktionen, Des Toolzugriffs und Verhaltensanweisungen des Agents.\n\nAusführliche Konfigurationsinformationen zu YAML-Eigenschaften, Werkzeugen, MCP-Serversetup, Werkzeugaliasen und wie custom agents verarbeitet werden, finden Sie unter [Konfiguration von benutzerdefinierten Agents](/de/copilot/reference/custom-agents-configuration).\n\nKonfigurieren Sie Ihr agent profile:\n\n1. Schreiben Sie optional eine `name` für Ihre custom agent. Wenn nicht festgelegt, wird der Name standardmäßig auf den Dateinamen (ohne das `.md`- oder `.agent.md`-Suffix) gesetzt.\n2. Schreiben Sie eine kurze `description` (erforderliche) Erläuterung, was Ihr Agent tut, und seine spezifischen Funktionen oder Domänenkenntnisse.\n3. Definieren Sie in der `tools` Eigenschaft, welche Tools der Agent verwenden kann. Dies ist eine Liste von Toolnamen oder Aliasen, einschließlich Tools von MCP-Servern, die in den Repository-Einstellungen oder dem agent profile konfiguriert sind (z. B. `tools: [\"read\", \"edit\", \"search\", \"some-mcp-server/tool-1\"]`). Wenn Sie diese Eigenschaft weglassen, hat der Agent Zugriff auf alle verfügbaren Tools. Siehe \"Tools\" in [Konfiguration von benutzerdefinierten Agents](/de/copilot/reference/custom-agents-configuration#tools).\n4. Optional können Sie in der `mcp-servers` Eigenschaft MCP-Server konfigurieren, die nur für diesen Agent verfügbar sind, um seine Funktionen zu erweitern. Weitere Informationen finden Sie unter \"MCP-Serverkonfigurationsdetails\" in [Konfiguration von benutzerdefinierten Agents](/de/copilot/reference/custom-agents-configuration#mcp-server-configuration-details).\n5. Wenn Sie das agent profile in VS Code, JetBrains IDEs, Eclipse oder Xcode erstellen und verwenden, können Sie auch die Eigenschaft `model` verwenden, um zu steuern, welches KI-Modell der Agent verwenden soll.\n6. Optional können Sie die Eigenschaft `target` entweder auf `vscode` oder `github-copilot` festlegen, wenn Sie den Agenten nur in einer bestimmten Umgebung verwenden möchten. Der Agent wird in beiden Umgebungen verfügbar sein, wenn Sie die Eigenschaft weglassen.\n7. Schreiben Sie die Eingabeaufforderung des Agenten. Definieren Sie das Verhalten, das Fachwissen und die Anweisungen des Agents im Markdown-Inhalt unter dem YAML-Frontmatter. Die Eingabeaufforderung kann maximal 30.000 Zeichen lang sein.\n\n## Beispiel: agent profiles\n\nDie folgenden Beispiele veranschaulichen, wie ein agent profile für die gewöhnlichen Aufgaben, Tests zu schreiben oder die Implementierung eines Projekts zu planen, aussehen könnte. Weitere Inspiration finden Sie in den [Custom agents](/de/copilot/tutorials/customization-library/custom-agents) Beispielen in der Anpassungsbibliothek. Sie finden auch spezifischere Beispiele in der [awesome-copilot](https://github.com/github/awesome-copilot/tree/main/agents) Community Collection.\n\n### Prüffachmann\n\nIn diesem Beispiel werden alle Tools aktiviert, indem die `tools` Eigenschaft weggelassen wird.\n\n```text copy\n---\nname: test-specialist\ndescription: Focuses on test coverage, quality, and testing best practices without modifying production code\n---\n\nYou are a testing specialist focused on improving code quality through comprehensive testing. Your responsibilities:\n\n- Analyze existing tests and identify coverage gaps\n- Write unit tests, integration tests, and end-to-end tests following best practices\n- Review test quality and suggest improvements for maintainability\n- Ensure tests are isolated, deterministic, and well-documented\n- Focus only on test files and avoid modifying production code unless specifically requested\n\nAlways include clear test descriptions and use appropriate testing patterns for the language and framework.\n```\n\n### Implementierungsplaner\n\nIn diesem Beispiel wird nur eine Teilmenge von Tools aktiviert.\n\n```text copy\n---\nname: implementation-planner\ndescription: Creates detailed implementation plans and technical specifications in markdown format\ntools: [\"read\", \"search\", \"edit\"]\n---\n\nYou are a technical planning specialist focused on creating comprehensive implementation plans. Your responsibilities:\n\n- Analyze requirements and break them down into actionable tasks\n- Create detailed technical specifications and architecture documentation\n- Generate implementation plans with clear steps, dependencies, and timelines\n- Document API designs, data models, and system interactions\n- Create markdown files with structured plans that development teams can follow\n\nAlways structure your plans with clear headings, task breakdowns, and acceptance criteria. Include considerations for testing, deployment, and potential risks. Focus on creating thorough documentation rather than implementing code.\n```\n\n## Verwenden von custom agents\n\nNachdem Sie eine custom agent erstellt haben, können Sie es überall verwenden, wo Copilot cloud agent verfügbar ist.\n\n* Wenn Sie Copilot cloud agent mit einer Aufgabe GitHub.com beauftragen, verwenden Sie das Dropdownmenü im Agents-Bereich oder auf der Registerkarte „Agents”, um den custom agent anstelle des standardmäßigen cloud agent auszuwählen.\n* Wenn Sie Copilot cloud agent einem Problem zuweisen, können Sie Ihre custom agent aus dem Dropdownmenü auswählen, um das Problem mit Ihrer speziellen Konfiguration zu bearbeiten.\n* Bei der Nutzung von GitHub Copilot CLI können Sie einen bestimmten custom agent durch den `/agent`-Schrägstrichbefehl einsetzen oder indem Sie auf den Agent in einem Prompt oder über ein Befehlszeilenargument verweisen. Weitere Informationen findest du unter [Verwenden von GitHub Copilot CLI](/de/copilot/how-tos/copilot-cli/use-copilot-cli/overview#use-custom-agents).\n\nWenn Copilot Pull-Anforderungen öffnet, gibt er an, welcher custom agent in der Pull-Anforderungsbeschreibung zum Abschließen der Arbeit verwendet wurde.\n\nWeitere Informationen zur Verwendung von Copilot cloud agent findest du unter [Sitzungen mit GitHub Copilot starten](/de/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions).\n\n### Verwendung von custom agents in Ihrer IDE\n\nSie können Ihre Benutzerdefinierte agent profiles auch direkt in unterstützten IDEs verwenden. Sie können im Chatfenster mithilfe des Agenten-Dropdown-Menüs wechseln, wodurch Sie Zugriff auf spezielle Konfigurationen für verschiedene Aufgaben wie Planung, Codebearbeitung oder Recherche erhalten.\n\nEinige Eigenschaften können zwischen den GitHub.com Umgebungen und IDE unterschiedlich funktionieren. Weitere Informationen zu unterstützten Eigenschaften finden Sie unter [Konfiguration von benutzerdefinierten Agents](/de/copilot/reference/custom-agents-configuration#yaml-frontmatter-properties).\n\nWeitere Informationen speziell zu custom agents in VS Code finden Sie in [Custom agents in VS Code](https://code.visualstudio.com/docs/copilot/customization/custom-agents) der VS Code Dokumentation.\n\n## Nächste Schritte\n\n* Ein praktisches Tutorial zum Erstellen Ihres ersten custom agent finden Sie unter [Ihr erster benutzerdefinierter Agent](/de/copilot/tutorials/customization-library/custom-agents/your-first-custom-agent).\n* Ausführliche Konfigurationsinformationen finden Sie unter [Konfiguration von benutzerdefinierten Agents](/de/copilot/reference/custom-agents-configuration).\n* Informationen zur Verwendung von Cloud-Agents, einschließlich Ihres custom agents, zum Erstellen von Pullanforderungen finden Sie unter [Sitzungen mit GitHub Copilot starten](/de/copilot/how-tos/use-copilot-agents/cloud-agent/create-a-pr)."}