Informationen zu benutzerdefinierten Agents

Custom agents Optimieren Sie Copilot mit einer auf Ihre Bedürfnisse zugeschnittenen Unterstützung.

In diesem Artikel

Informationen zum custom agents

Custom 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 custom agents mithilfe von Markdown-Dateien, die agent profiles 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.

agent profile definiert das Verhalten von custom agent. Wenn Sie dem Agent eine Aufgabe oder ein Problem zuweisen, instanziiert er die custom agent.

Agent profile-Format

Agent profiles sind Markdown-Dateien mit YAML-Frontmatter. In ihrer einfachsten Form enthalten sie:

  • Name (optional): Ein Anzeigename für das custom 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.

Agent profiles kann auch MCP-Serverkonfigurationen mit der mcp-servers Eigenschaft enthalten.

Beispiel: agent profile

In diesem Beispiel handelt es sich um ein einfaches agent profile, 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 custom agents konfigurieren können

Sie können auf verschiedenen Ebenen definieren agent profiles :

  • Repositoryebene: Erstellen Sie .github/agents/CUSTOM-AGENT-NAME.md in Ihrem Repository für projektspezifische Agents.
  • Organisationsebene: Erstellen Sie /agents/CUSTOM-AGENT-NAME.md im Organisations .github - oder .github-private Repository für eine breitere Verfügbarkeit innerhalb der Organisation.
  • Auf Enterprise-Ebene: Erstellen Sie /agents/CUSTOM-AGENT-NAME.md im .github-private-Repository einer Organisation, die ein Enterprise-Besitzer in den Enterprise-Einstellungen für die Verfügbarkeit in allen Repositorys des Enterprise festgelegt hat.

Weitere Informationen findest du unter Vorbereiten der Verwendung von benutzerdefinierten Agents in Ihrer Organisation und Vorbereitung der Verwendung benutzerdefinierter Agents in Ihrem Unternehmen.

Wo Sie custom agents nutzen können

Hinweis

Custom agents befinden sich in Öffentliche Vorschau für JetBrains IDEs, Eclipse und Xcode und können Änderungen unterliegen.

Nachdem Sie erstellt custom agentshaben, werden sie verfügbar für:

  • Copilot cloud agent auf GitHub.com: Registerkarte „Agents” und „Panel”, Problemzuweisung und Pull-Anforderungen
  • Copilot cloud agent in IDEs: Visual Studio Code, JetBrains IDEs, Eclipse und Xcode
  • GitHub Copilot CLI

Sie können agent profiles direkt in Visual Studio Code JetBrains IDEs, Eclipse und Xcode verwenden. Einige Eigenschaften funktionieren möglicherweise unterschiedlich oder werden zwischen Umgebungen ignoriert.

Weitere Informationen zur Verwendung von custom agents in Visual Studio Code finden Sie unter Custom agents in VS Code.

Nächste Schritte

So erstellen Sie Ihr eigenes custom agents: