Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent

Sie können spezielle Agenten mit maßgeschneiderter Expertise für bestimmte Entwicklungsaufgaben erstellen.

Wer kann dieses Feature verwenden?

Der Copilot-Cloud-Agent ist mit den Plänen für GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Business und GitHub Copilot Enterprise verfügbar. Der Agent ist in allen Repositorys verfügbar, die auf GitHub gespeichert sind, mit Ausnahme von Repositorys, die sich im Besitz von verwaltete Benutzerkonten befinden und für die er explizit deaktiviert wurde.
Sign up for Copilot

In diesem Artikel

          Benutzerdefinierte Agents ermöglicht es Ihnen, die Expertise von Copilot auf bestimmte Aufgaben zuzuschneiden. Eine konzeptionelle Übersicht über Benutzerdefinierte Agenten finden Sie unter [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents).

Hinweis

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

Erstellen eines Benutzerdefinierter Agent Profils in einem Repository auf GitHub

  1. Navigieren Sie zur Registerkarte "Agents" unter https://github.com/copilot/agents.

  2. Wählen Sie im Dropdownmenü im Eingabeaufforderungsfeld das Repository aus, in dem Sie das Benutzerdefinierter Agent Profil erstellen möchten.

    Hinweis

    Organisations- und Unternehmensbesitzer können Organisations- und Unternehmensebene Benutzerdefinierte Agenten in einem .github-private Repository erstellen, das in allen Repositorys innerhalb ihrer Organisation oder ihres Unternehmens verfügbar ist. Weitere Informationen findest du unter Vorbereitung der Verwendung benutzerdefinierter Agents in Ihrem Unternehmen und Vorbereiten der Verwendung von benutzerdefinierten Agents in Ihrer Organisation.

  3. Wählen Sie optional eine Verzweigung aus, in der Sie Agentprofil erstellen möchten. Der Standard ist die Hauptverzweigung.

  4. Klicken Sie , dann auf Agent erstellen. Dadurch wird ein Vorlagen-Agent-Profil namens my-agent.agent.md im Verzeichnis .github/agents Ihres Zielrepositorys geöffnet.

  5. Wenn Sie eine Organisation oder eine Unternehmensebene Benutzerdefinierter Agenterstellen, löschen Sie den .github/ Teil des Dateipfads, um Ihre Vorlage in das Stammverzeichnis agents zu verschieben.

  6. Bearbeiten Sie den Dateinamen (den text vor .agent.md), und wählen Sie einen eindeutigen, beschreibenden Namen aus, der den Zweck des Agents identifiziert. Beachten Sie, dass der Dateiname nur die folgenden Zeichen enthalten darf: ., -, , _, a-z, . A-Z``0-9

  7. Konfigurieren Sie das Agentprofil, einschließlich des Namens, der Beschreibung, der Tools und der Eingabeaufforderungen. Weitere Informationen dazu, was dies Agentprofil enthalten kann, finden Sie unter Konfigurieren eines Agentprofil.

  8. Commit die Datei in das Repository und füge sie in den Standard Branch ein. Gehen Sie zurück zur Registerkarte "Agents" und aktualisieren Sie die Seite bei Bedarf. Ihr Benutzerdefinierter Agent wird nun im Dropdown-Menü angezeigt, wenn Sie im Eingabefeld auf klicken.

Erstellen eines Benutzerdefinierter Agent Profils in Visual Studio Code

  1. Öffnen GitHub Copilot Gespräch in Visual Studio Code.
  2. Klicken Sie in der Dropdownliste "Agents" unten in der Chatansicht auf "Benutzerdefinierte Agents konfigurieren..." und dann auf " Neu erstellen" Benutzerdefinierter Agent.
  3. Wählen Sie den Speicherort aus, an dem die Agentprofil Erstellung erfolgen soll: * Arbeitsbereich: Erstellen Sie das Benutzerdefinierter Agent Profil im .github/agents Ordner Ihres Arbeitsbereichs, um es nur innerhalb dieses Arbeitsbereichs zu verwenden. * Benutzerprofil: Erstellen Sie das Benutzerdefinierter Agent Profil im aktuellen Benutzerprofilordner, um es in allen Arbeitsbereichen zu verwenden.
  4. Geben Sie einen Dateinamen für die Benutzerdefinierter Agent. Dies ist der Standardname, der in der Dropdownliste "Agents" angezeigt wird.
  5. Konfigurieren Sie die Agentprofil in der neu erstellten .agent.md Datei, einschließlich der Beschreibung, der Tools und der Aufforderungen. Weitere Informationen dazu, was dies Agentprofil enthalten kann, finden Sie unter Konfigurieren eines Agentprofil.
    • 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 OK, um die ausgewählten Tools zu Agentprofil hinzuzufügen.
    • 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.

Um eine AgentprofilZu aktualisieren, wählen Sie "Benutzerdefinierte Agents konfigurieren" aus der Dropdownliste "Agents" aus, und klicken Sie dann in der Liste auf einen Agent, um ihn zu ändern. Weitere Informationen zu Benutzerdefinierte Agenten in VS Code finden Sie unter Benutzerdefinierte Agents in VS Code.

Erstellen eines Benutzerdefinierter Agent Profils in JetBrains-IDEs

  1. Öffnen Sie das GitHub Copilot Gespräch Fenster in Ihrer JetBrains-IDE.
  2. Klicken Sie in der Dropdownliste "Agents" unten in der Chatansicht auf "Agents konfigurieren...", und klicken Sie dann im Einstellungsfenster unter "Chat-Agents" auf " Arbeitsbereich".
  3. Geben Sie einen Dateinamen für die Benutzerdefinierter Agent. Dies ist der Standardname, der in der Dropdownliste "Agents" angezeigt wird.
  4. Konfigurieren Sie die Agentprofil neu erstellte .agent.md Datei im .github/agents Verzeichnis, einschließlich Beschreibung, Tools und Eingabeaufforderungen. Weitere Informationen dazu, was dies Agentprofil enthalten kann, finden Sie unter Konfigurieren eines Agentprofil.
    • Sie können die Schaltfläche " Tools konfigurieren... " im Editor verwenden, um das Dialogfeld "Tools" 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 Agentprofil hinzuzufügen.
    • 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.

Um ein Agentprofil zu aktualisieren, wählen Sie Benutzerdefinierte Agenten konfigurieren aus dem Agenten-Dropdown, und klicken Sie anschließend auf neben dem Agenten, den Sie ändern möchten.

Erstellen eines Benutzerdefinierter Agent Profils in Eclipse

  1. Öffnen Sie das GitHub Copilot Gespräch Fenster in Eclipse.
  2. Klicken Sie in der Dropdownliste "Agents" unten in der Chatansicht auf "Agents konfigurieren...", und klicken Sie dann auf "Hinzufügen...".
  3. Geben Sie einen Dateinamen für die Benutzerdefinierter Agent. Dies ist der Standardname, der in der Dropdownliste "Agents" angezeigt wird.
  4. Konfigurieren Sie die Agentprofil im neu erstellten .agent.md-Datei im .github/agents-Verzeichnis, einschließlich der Beschreibung, der Tools und der Eingabeaufforderungen. Weitere Informationen dazu, was dies Agentprofil enthalten kann, finden Sie unter Konfigurieren eines Agentprofil.
    • 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 ausgewählte AgentprofilWerkzeuge hinzuzufügen.
    • 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.

Um eine AgentprofilZu 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".

Erstellen eines Benutzerdefinierter Agent Profils in Xcode

  1. Öffnen Sie das GitHub Copilot Gespräch Fenster in Xcode.
  2. Klicken Sie in der Dropdownliste "Agents" unten in der Chatansicht auf " Agent erstellen".
  3. Geben Sie einen Dateinamen für die Benutzerdefinierter Agent. Dies ist der Standardname, der in der Dropdownliste "Agents" angezeigt wird.
  4. Konfigurieren Sie die neu erstellte .agent.md Datei im .github/agents Verzeichnis, einschließlich der Beschreibung, Tools und Aufforderungen. Weitere Informationen dazu, was dies Agentprofil enthalten kann, finden Sie unter Konfigurieren eines Agentprofil.
    • Sie können die Schaltfläche ** "Agent anpassen" ** im Datei-Editor verwenden, um ein Dialogfeld zu öffnen, in dem Sie das KI-Modell für den Agenten auswählen, verfügbare Werkzeuge (einschließlich integrierter und MCP-Server-Tools) auswählen und die Eigenschaft handoffs für den Übergang zwischen Benutzerdefinierte Agenten konfigurieren können. Klicken Sie auf "Übernehmen" , um der AgentprofilOption ausgewählte Optionen hinzuzufügen.

Klicken Sie zum Aktualisieren eines Agentprofil im Dropdown-Menü „Agents“ auf das Bleistiftsymbol neben dem Agenten oder der Agentin, den oder die Sie ändern möchten.

Konfigurieren einer Agentprofil

Ein Agentprofil ist eine Markdown-Datei mit einem YAML-Vorspann, der den Namen, die Beschreibung von Benutzerdefinierter Agent, die verfügbaren Werkzeuge und die Konfigurationen des MCP-Servers angibt. Das Konfigurieren eines Agentprofil Elements umfasst das Definieren der Identität, Funktionen, Des Toolzugriffs und Verhaltensanweisungen des Agents.

Ausführliche Konfigurationsinformationen zu YAML-Eigenschaften, Werkzeugen, MCP-Serversetup, Werkzeugaliasen und wie Benutzerdefinierte Agenten verarbeitet werden, finden Sie unter Konfiguration von benutzerdefinierten Agents.

Konfigurieren Sie Ihr Agentprofil:

  1. Schreiben Sie optional eine name für Ihre Benutzerdefinierter Agent. Wenn nicht festgelegt, wird der Name standardmäßig auf den Dateinamen (ohne das .md- oder .agent.md-Suffix) gesetzt.
  2. Schreiben Sie eine kurze description (erforderliche) Erläuterung, was Ihr Agent tut, und seine spezifischen Funktionen oder Domänenkenntnisse.
  3. 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 Agentprofil konfiguriert sind (z. B. tools: ["read", "edit", "search", "some-mcp-server/tool-1"]). Wenn Sie diese Eigenschaft weglassen, hat der Agent access für alle verfügbaren Tools. Siehe "Tools" in Konfiguration von benutzerdefinierten Agents.
  4. 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.
  5. Wenn Sie das Agentprofil 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.
  6. Legen Sie optional die eigenschaft target entweder auf vscode oder github-copilot fest, wenn Sie den Agent nur in einer bestimmten Umgebung verwenden möchten. Der Agent wird in beiden Umgebungen verfügbar sein, wenn Sie die Eigenschaft nicht verwenden.
  7. 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.

Beispiel: Agentenprofile

Die folgenden Beispiele veranschaulichen, wie ein Agentprofil 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 Benutzerdefinierte Agents Beispielen in der Anpassungsbibliothek. Sie finden auch spezifischere Beispiele in der awesome-copilot Community Collection.

Prüffachmann

In diesem Beispiel werden alle Tools aktiviert, indem die tools Eigenschaft weggelassen wird.

Text
---
name: test-specialist
description: Focuses on test coverage, quality, and testing best practices without modifying production code
---

You are a testing specialist focused on improving code quality through comprehensive testing. Your responsibilities:

- Analyze existing tests and identify coverage gaps
- Write unit tests, integration tests, and end-to-end tests following best practices
- Review test quality and suggest improvements for maintainability
- Ensure tests are isolated, deterministic, and well-documented
- Focus only on test files and avoid modifying production code unless specifically requested

Always include clear test descriptions and use appropriate testing patterns for the language and framework.

Implementierungsplaner

In diesem Beispiel wird nur eine Teilmenge von Tools aktiviert.

Text
---
name: implementation-planner
description: Creates detailed implementation plans and technical specifications in markdown format
tools: ["read", "search", "edit"]
---

You are a technical planning specialist focused on creating comprehensive implementation plans. Your responsibilities:

- Analyze requirements and break them down into actionable tasks
- Create detailed technical specifications and architecture documentation
- Generate implementation plans with clear steps, dependencies, and timelines
- Document API designs, data models, and system interactions
- Create markdown files with structured plans that development teams can follow

Always 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.

Verwenden von Benutzerdefinierte Agenten

Nachdem Sie eine Benutzerdefinierter Agent erstellt haben, können Sie es überall verwenden, wo Copilot-Cloud-Agent verfügbar ist.

  • Wenn Sie Copilot-Cloud-Agent bei einer Aufgabe GitHub.comauffordern, verwenden Sie das Dropdownmenü im Agents-Bereich oder auf der Registerkarte "Agents", um Ihre Benutzerdefinierter Agent Anstelle des Standardmenüs Cloud-Agentauszuwählen.
  • Wenn Sie Copilot-Cloud-Agent einem Problem zuweisen, können Sie Ihre Benutzerdefinierter Agent aus dem Dropdownmenü auswählen, um das Problem mit Ihrer speziellen Konfiguration zu bearbeiten.
  • Bei der Nutzung von GitHub Copilot-CLI können Sie einen bestimmten Benutzerdefinierter Agent durch den /agent-Befehl einsetzen oder indem Sie auf den Agenten in einer Eingabeaufforderung oder über ein Befehlszeilenargument verweisen. Weitere Informationen finden Sie unter Verwenden von GitHub Copilot CLI.

Wenn Copilot Pull-Anfragen geöffnet werden, wird in der Beschreibung der Pull-Anfrage angegeben, welche Benutzerdefinierter Agent zum Abschließen der Arbeit verwendet wurde.

Weitere Informationen zur Verwendung von Copilot-Cloud-Agent findest du unter Bitten GitHub Copilot, eine Pull-Anforderung zu erstellen.

Verwendung von Benutzerdefinierte Agenten in Ihrer IDE

Sie können Ihre Benutzerdefinierte Agentenprofile auch direkt in unterstützten IDEs verwenden, einschließlich Visual Studio CodeJetBrains-IDEs, Eclipse und Xcode. 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.

Beachten Sie, dass einige Eigenschaften möglicherweise unterschiedlich funktionieren oder zwischen den GitHub.com Umgebungen und IDE ignoriert werden. Weitere Informationen zu unterstützten Eigenschaften finden Sie unter Konfiguration von benutzerdefinierten Agents.

Weitere Informationen speziell zu Benutzerdefinierte Agenten in VS Code finden Sie in Benutzerdefinierte Agents in VS Code der VS Code Dokumentation.

Nächste Schritte