Informationen zum Benutzerdefinierte Agenten
Benutzerdefinierte Agents sind spezielle Versionen des Copilot Agents, die Sie auf Ihre einzigartigen Workflows, Codierungskonventionen und Anwendungsfälle anpassen können. Sie verhalten sich wie maßgeschneiderte Teamkollegen, die Ihren Standards entsprechen, die richtigen Tools verwenden und teamspezifische Methoden implementieren. Sie definieren diese Agents einmal, anstatt wiederholt dieselben Anweisungen und Denselben Kontext bereitzustellen.
Sie definieren Benutzerdefinierte Agenten mithilfe von Markdown-Dateien, die Agentenprofile genannt werden. Diese Dateien geben Eingabeaufforderungen, Tools und MCP-Server an. Auf diese Weise können Sie Ihre Konventionen, Frameworks und gewünschten Ergebnisse direkt in Copilotcodieren.
Agentprofil definiert das Verhalten von Benutzerdefinierter Agent. Wenn Sie dem Agent eine Aufgabe oder ein Problem zuweisen, instanziiert er die Benutzerdefinierter Agent.
Agentprofil-Format
Agentenprofile sind Markdown-Dateien mit YAML-Frontmatter. In ihrer einfachsten Form enthalten sie:
* Name (optional): Ein Anzeigename für das Benutzerdefinierter Agent. Wenn der Dateiname des Agents weggelassen wird, wird dieser als Bezeichner und Standardanzeigename verwendet. * Beschreibung: Erläutert den Zweck und die Funktionen des Agenten. * Eingabeaufforderung: Benutzerdefinierte Anweisungen, die das Verhalten und die Expertise des Agents definieren. * Tools (optional): Bestimmte Tools, auf die der Agent zugreifen kann. Standardmäßig können Agents auf alle verfügbaren Tools zugreifen, einschließlich integrierter Tools und MCP-Servertools.
Agentenprofile kann auch MCP-Serverkonfigurationen mit der `mcp-servers` Eigenschaft enthalten.
Beispiel: Agentprofil
In diesem Beispiel handelt es sich um ein einfaches Agentprofil, bei dem Name, Beschreibung und Aufforderung konfiguriert sind.
---
name: readme-creator
description: Agent specializing in creating and improving README files
---
You are a documentation specialist focused on README files. Your scope is limited to README files or other related documentation files only - do not modify or analyze code files.
Focus on the following instructions:
- Create and update README.md files with clear project descriptions
- Structure README sections logically: overview, installation, usage, contributing
- Write scannable content with proper headings and formatting
- Add appropriate badges, links, and navigation elements
- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository
- Make links descriptive and add alt text to images
Wo Sie Benutzerdefinierte Agenten
konfigurieren können
Sie können auf verschiedenen Ebenen definieren Agentenprofile :
-
**Repositoryebene**: Erstellen Sie `.github/agents/CUSTOM-AGENT-NAME.md` in Ihrem Repository für projektspezifische Agents. -
**Organisations- oder Unternehmensebene**: Erstellen Sie `/agents/CUSTOM-AGENT-NAME.md` in einem `.github-private`-Repository für eine breitere Verfügbarkeit.
Weitere Informationen findest du unter Vorbereiten der Verwendung von benutzerdefinierten Agents in Ihrer Organisation und Vorbereitung der Verwendung benutzerdefinierter Agents in Ihrem Unternehmen.
Where you can use Benutzerdefinierte Agenten
Hinweis
Benutzerdefinierte Agents befinden sich in öffentliche Vorschau für JetBrains IDEs, Eclipse und Xcode und können Änderungen unterliegen.
Once you create Benutzerdefinierte Agenten, they become available to:
- Copilot cloud agent on GitHub.com: The agents tab and panel, issue assignment, and pull requests
- Copilot cloud agent in IDEs: Visual Studio Code, JetBrains IDEs, Eclipse, and Xcode
- GitHub Copilot CLI
You can use Agentenprofile directly in Visual Studio Code, JetBrains IDEs, Eclipse, and Xcode. Some properties may function differently or be ignored between environments.
For more information on using Benutzerdefinierte Agenten in Visual Studio Code, see Benutzerdefinierte Agents in VS Code.
Next steps
To create your own Benutzerdefinierte Agenten, see: