{"meta":{"title":"Konfiguration von benutzerdefinierten Agents","intro":"Referenz zum Konfigurieren von custom agents.","product":"GitHub Copilot","breadcrumbs":[{"href":"/de/copilot","title":"GitHub Copilot"},{"href":"/de/copilot/reference","title":"Verweis"},{"href":"/de/copilot/reference/custom-agents-configuration","title":"Konfiguration von benutzerdefinierten Agents"}],"documentType":"article"},"body":"# Konfiguration von benutzerdefinierten Agents\n\nReferenz zum Konfigurieren von custom agents.\n\nDieser Referenzartikel enthält ausführliche Konfigurationsinformationen für custom agents. Allgemeine Informationen zum Erstellen custom agentsfinden Sie unter [Erstellen von benutzerdefinierten Agents für Copilot cloud agent](/de/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-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## YAML-Frontmattereigenschaften\n\nIn der folgenden Tabelle werden die Eigenschaften aufgelistet, die Sie für agent profiles in GitHub.com, Copilot CLI und den unterstützten IDEs konfigurieren können, es sei denn, es wird anders angegeben. Jedes umgebungsspezifische Verhalten wird in der Eigenschaftsbeschreibung angegeben. Der Name der Konfigurationsdatei (minus `.md` oder `.agent.md`) wird für die Deduplizierung zwischen Ebenen verwendet, sodass die Konfiguration auf der niedrigsten Ebene Vorrang hat.\n\n\n\n| Eigentum | Typ | Zweck |\n| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `name` | Schnur | Anzeigename für die custom agent. Wahlfrei. |\n| `description` | | |\n| **Erforderliche** Zeichenfolge | Beschreibung des Zwecks und der custom agentFunktionen | |\n| `target` | Schnur | Zielumgebung oder Kontext für die custom agent (`vscode` oder `github-copilot`). Wenn dies nicht festgelegt ist, werden standardmäßig beide Umgebungen verwendet. |\n| `tools` | Liste von Zeichenfolgen, Zeichenfolge | Liste der Toolnamen, die der custom agent verwenden kann. Unterstützt sowohl eine durch Trennzeichen getrennte Zeichenfolge als auch ein Yaml-Zeichenfolgenarray. Wenn nicht gesetzt, werden standardmäßig alle Tools verwendet. Siehe [Tools](#tools). |\n| `model` | Schnur | Modell, das verwendet werden soll, wenn dies custom agent ausgeführt wird. Wenn dies nicht festgelegt ist, erbt das Standardmodell. |\n| `disable-model-invocation` | boolean | Deaktiviert Copilot cloud agent von der automatischen Verwendung dieses custom agent basierend auf dem Aufgabenkontext. Wenn `true` muss der Agent manuell ausgewählt werden. Die Einstellung `disable-model-invocation: true` entspricht `infer: false`. Wenn beide festgelegt sind, hat `disable-model-invocation` Vorrang. Wenn dies nicht festgelegt ist, wird standardmäßig auf `false`. |\n| `user-invocable` | boolean | Steuert, ob dies custom agent von einem Benutzer ausgewählt werden kann. Wenn `false`, kann der Agent nicht manuell ausgewählt werden und es kann nur programmgesteuert darauf zugegriffen werden. Wenn dies nicht festgelegt ist, wird standardmäßig auf `true`. |\n| `infer` | boolean | |\n| \\*\\* | | |\n| Pensioniert | | |\n| \\*\\*. Verwenden Sie stattdessen `disable-model-invocation` und `user-invocable`. Ermöglicht es Copilot cloud agent, custom agent automatisch basierend auf dem Kontext der Aufgabe zu verwenden. Wenn `false` muss der Agent manuell ausgewählt werden. Wenn dies nicht festgelegt ist, wird standardmäßig auf `true`. | | |\n| `mcp-servers` | Objekt | Zusätzliche MCP-Server und -Tools, die von der custom agent verwendet werden sollten. |\n| **Wird in VS Code und anderen IDE custom agentsnicht verwendet.** | | |\n| `metadata` | Objekt, das aus einem Namen- und Wertpaar besteht, beide Zeichenfolgen | Lässt Anmerkungen für den Agent mit nützlichen Daten zu. |\n| **Wird in VS Code und anderen IDE custom agentsnicht verwendet.** | | |\n\n
\n\nDefinieren 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> \\[!NOTE]\n>\n> * Die `argument-hint`- und `handoffs`-Eigenschaften von VS Code und anderen IDE-custom agents werden derzeit nicht für Copilot cloud agent auf GitHub.com unterstützt. Sie werden ignoriert, um die Kompatibilität sicherzustellen.\n> * Weitere Informationen zur custom agent Dateistruktur in VS Code finden Sie unter [Custom agents in VS Code](https://code.visualstudio.com/docs/copilot/customization/custom-agents#_custom-agent-file-structure) in der VS Code Dokumentation.\n\n## Tools\n\nDie custom agent`tools` Eigenschaft steuert, welche Tools für Ihren Agent verfügbar sind, einschließlich der von MCP-Servern.\n\nIhr custom agent erhält Zugriff auf MCP-Servertools, die sowohl in den agent profile- als auch in den Repositoryeinstellungen konfiguriert wurden. Weitere Informationen zum Konfigurieren von gemeinsam genutzten Repository-MCP-Servern auf GitHub finden Sie unter [Konfigurieren von MCP-Servern für Ihr Repository](/de/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers).\n\nSie können `tools` mit den folgenden Vorgehensweisen konfigurieren:\n\n* **Alle verfügbaren Tools aktivieren**: Lassen Sie die `tools` Eigenschaft vollständig weg oder verwenden Sie `tools: [\"*\"]`, um alle verfügbaren Tools zu aktivieren. Dazu gehören alle MCP-Server-Tools, die innerhalb der agent profile- und/oder Repository-Einstellungen konfiguriert sind.\n* **Aktivieren Sie bestimmte Tools**: Stellen Sie eine Liste mit bestimmten Toolnamen oder Aliasen bereit (z. B `tools: [\"read\", \"edit\", \"search\"]`. ), um nur diese Tools zu aktivieren. Verfügbare Toolaliasen finden Sie unten unter [Toolaliasen](#tool-aliases) .\n * Beachten Sie, dass Sie, wenn Ihr Repository MCP-Server konfiguriert sind, festlegen können, dass nur bestimmte Tools von diesen Servern für Sie custom agent verfügbar sind. Toolnamen von bestimmten MCP-Servern können dem Servernamen gefolgt von einer `/`vorangestellt werden. Beispiel: `some-mcp-server/some-tool`.\n * Sie können auch alle Tools von einem bestimmten MCP-Server mithilfe von `some-mcp-server/*` explizit aktivieren.\n * Tools aus VS Code Erweiterungen können den Erweiterungsnamen als Proxy verwenden, z. B. `azure.some-extension/some-tool`.\n* **Alle Tools deaktivieren**: Verwenden Sie eine leere Liste (`tools: []`), um alle Tools für den Agent zu deaktivieren.\n\nAlle nicht erkannten Toolnamen werden ignoriert, wodurch produktspezifische Tools in einem agent profile angegeben werden können, ohne Probleme zu verursachen.\n\n### Tool-Aliasse\n\nDie folgenden Tool-Aliase sind für custom agents verfügbar. Bei allen Aliasen wird die Groß- und Kleinschreibung nicht berücksichtigt:\n\n\\| Primärer Alias | Kompatible Aliase |\nCloud agent Zuordnung | Zweck |\n\\| ------------- | -------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |\n\\| `execute` |\n`shell`, `Bash``powershell` | Shelltools: `bash` oder `powershell` | Führen Sie einen Befehl in der entsprechenden Shell für das Betriebssystem aus. |\n\\| `read` |\n`Read`, `NotebookRead` | `view` | Dateiinhalte lesen. |\n\\| `edit` |\n`Edit`\n`MultiEdit`\n`Write`\n`NotebookEdit`\n\\| Bearbeitungstools: z. B. `str_replace`, `str_replace_editor` | Dem LLM die Möglichkeit zur Bearbeitung bieten. Genaue Argumente können variieren. |\n\\| `search` |\n`Grep`, `Glob` | `search` | Suchen Sie nach Dateien oder Text in Dateien. |\n\\| `agent` |\n`custom-agent`, `Task` |\nCustom agent\" Werkzeuge | Ermöglicht das Aufrufen eines anderen custom agent, um eine Aufgabe auszuführen. |\n\\| `web` |\n`WebSearch`, `WebFetch` | Derzeit nicht anwendbar für cloud agent. | Ermöglicht das Abrufen von Inhalten aus URLs und durchführen einer Websuche |\n\\| `todo` | `TodoWrite` | Derzeit nicht anwendbar für cloud agent. | Erstellt und verwaltet strukturierte Aufgabenlisten. Wird heute in cloud agent nicht unterstützt, aber von VS Code. |\n\n### Toolnamen für einsatzbereite MCP-Server\n\nDie folgenden MCP-Server sind sofort einsatzbereit für Copilot cloud agent und können mithilfe von Namespacing referenziert werden.\n\n| MCP-Server-Name | Verfügbare Tools |\n| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `github` | Alle schreibgeschützten Tools sind standardmäßig verfügbar, aber das Token, das der Server erhält, ist auf den Bereich des Quell-Repositorys beschränkt. |\n| `github/*` enthält alle Elemente, oder Sie können `github/` referenzieren, wo `` ein Wert aus der MCP-Serverdokumentation ist. | |\n| `playwright` | Alle Playwright-Tools sind standardmäßig verfügbar, der Server ist jedoch nur für den Zugriff auf localhost konfiguriert. |\n| `playwright/*` enthält alle Elemente, oder Sie können `playwright/` referenzieren, wo `` ein Wert aus der MCP-Serverdokumentation ist. Standardmäßig ist das Token, auf das es Zugriff hat, auf das Quellcode-Repository festgelegt. | |\n\n## MCP-Serverkonfigurationsdetails\n\nDas folgende Beispiel agent profile zeigt einen Agenten mit einem MCP-Server und einem Secret. Darüber hinaus wurde nur ein Tool vom MCP-Server in der `tools` Eigenschaft im YAML-Frontmatter aktiviert:\n\n```text\n---\nname: my-custom-agent-with-mcp\ndescription: Custom agent description\ntools: ['tool-a', 'tool-b', 'custom-mcp/tool-1']\nmcp-servers:\n custom-mcp:\n type: 'local'\n command: 'some-command'\n args: ['--arg1', '--arg2']\n tools: [\"*\"]\n env:\n ENV_VAR_NAME: ${{ secrets.COPILOT_MCP_ENV_VAR_VALUE }}\n---\n\nPrompt with suggestions for behavior and output\n```\n\nDie Eigenschaft `mcp-servers` in einem agent profile ist eine YAML-Darstellung des JSON-Konfigurationsformats, das zum Konfigurieren von MCP-Servern für Repositorys auf GitHub verwendet wird.\n\nDie meisten Untereigenschaften sind identisch mit der JSON-Darstellung. In den folgenden Abschnitten werden Änderungen gegenüber der ursprünglichen Implementierung der MCP-Konfiguration in Repositories auf GitHub beschrieben, die für custom agents relevant sind. Weitere Informationen zum JSON-Konfigurationsformat finden Sie unter [Konfigurieren von MCP-Servern für Ihr Repository](/de/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#writing-a-json-configuration-for-mcp-servers).\n\n### MCP-Servertyp\n\nAus Kompatibilitätsgründen wird der von `stdio` Claude Code verwendete Typ und VS Code dem Typ von cloud agents `local` zugeordnet.\n\n### MCP-Serverumgebungsvariablen und geheime Schlüssel\n\n> \\[!NOTE]\n> Wenn Ihr MCP-Server geheime Schlüssel oder Umgebungsvariablen erfordert, müssen diese als geheime Agents oder Variablen auf Organisationsebene oder Repositoryebene konfiguriert werden. Weitere Informationen findest du unter [Konfigurieren von geheimen Schlüsseln und Variablen für Copilot Cloud-Agent](/de/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/configure-secrets-and-variables).\n\nCustom agent DIE MCP-Konfiguration unterstützt die gleichen Umgebungsvariablen und geheimen Ersatzfunktionen wie vorhandene MCP-Konfigurationen auf Repositoryebene. Ähnlich wie bei Konfigurationen auf Repository-Ebene können Geheimnisse und Variablen aus Agentengeheimnissen und -variablen für Copilot cloud agent bezogen werden, die entweder auf Organisations- oder Repository-Ebene konfiguriert sind. Die Syntax zum Verweisen auf diese Werte wurde erweitert, um allgemeine Muster zu unterstützen, die in GitHub Actions und Claude Code verwendet werden.\n\nSowohl die MCP-JSON-Konfiguration auf Repositoryebene als auch die custom agent YAML-Konfiguration unterstützen die folgenden Syntaxmuster:\n\n* `$COPILOT_MCP_ENV_VAR_VALUE` - Umgebungsvariable und Header\n* `${COPILOT_MCP_ENV_VAR_VALUE}` - Umgebungsvariable und Header (Claude Code-Syntax)\n* `${COPILOT_MCP_ENV_VAR_VALUE:-default}` - Umgebungsvariable und Header mit Standardeinstellung\n\nDie custom agent YAML-Konfiguration unterstützt die folgenden zusätzlichen Syntaxmuster:\n\n* `${{ secrets.COPILOT_MCP_ENV_VAR_VALUE }}` - Umgebungsvariable und Header\n* `${{ vars.COPILOT_MCP_ENV_VAR_VALUE }}` - Umgebungsvariable und Header\n\n## Beispielkonfigurationen agent profile\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## Verarbeitung von custom agents\n\n### Custom agents Namen\n\nBei Benennungskonflikten überschreibt die Konfiguration auf der niedrigsten Ebene Konfigurationen auf höherer Ebene. Dies bedeutet, dass ein Agent auf Repositoryebene Vorrang vor einem Agent auf Organisationsebene hat und der Agent auf Organisationsebene einen Agent auf Unternehmensebene außer Kraft setzen würde.\n\n### Versionsverwaltung\n\nCustom agent Die Versionierung basiert auf den Git-Commit-SHAs für die Datei agent profile. Auf diese Weise können Sie Verzweigungen oder Tags mit unterschiedlichen Versionen von custom agents nach Bedarf erstellen. Wenn Sie einer Aufgabe ein custom agent zuweisen, wird die custom agent mithilfe der neuesten Version des agent profile-Repositorys und der jeweiligen Verzweigung instanziiert. Wenn der Agent einen Pull-Request erstellt, verwenden Interaktionen innerhalb des Pull-Requests dieselbe Version der custom agent zur Konsistenz.\n\n### Werkzeugverarbeitung\n\nIn `tools` der Liste werden die Tools gefiltert, die dem Agent zur Verfügung gestellt werden – unabhängig davon, ob sie von MCP-Servern integriert oder stammen. Wenn Sie Tools in Ihrem agent profileDokument konfigurieren, hängt das Verhalten davon ab, was Sie angeben:\n\n* Wenn keine Tools angegeben sind, sind alle verfügbaren Tools aktiviert.\n* Eine leere Toolsliste (`tools: []`) deaktiviert alle Tools.\n* Eine bestimmte Liste (`tools: [...]`) aktiviert nur diese Tools.\n\n### MCP-Serverkonfigurationen\n\nFür MCP-Serverkonfigurationen gibt es eine bestimmte Verarbeitungsreihenfolge, die ein ordnungsgemäßes Überschreibungsverhalten gewährleistet: out-of-the-box MCP-Konfigurationen (wie die GitHub MCP) werden zuerst verarbeitet, gefolgt von der custom agent MCP-Konfiguration und schließlich MCP-Konfigurationen, die über Repositoryeinstellungen angegeben wurden. Auf diese Weise kann jede Ebene Einstellungen von der vorherigen Ebene entsprechend außer Kraft setzen.\n\n## Weiterführende Lektüre\n\n* [GitHub Copilot CLI](/de/copilot/how-tos/copilot-cli)\n* [GitHub Copilot CLI-Befehlsreferenz](/de/copilot/reference/copilot-cli-reference/cli-command-reference#custom-agents-reference)"}