Skip to main content

Aufrufen von benutzerdefinierten Agents

Verwenden Sie benutzerdefinierte Agents, Fähigkeiten und MCP-Server, um deren Funktionen in Copilot CLI zu erweitern.

Wer kann dieses Feature verwenden?

GitHub Copilot CLI ist mit allen Copilot Tarifen verfügbar. Wenn Sie Copilot von einer Organisation erhalten, muss die Copilot CLI-Richtlinie in den Einstellungen der Organisation aktiviert sein.

custom agents verwenden

A custom agent ist eine spezielle Version von Copilot. Custom agents Helfen Sie bei der Copilot Behandlung eindeutiger Workflows, bestimmter Codierungskonventionen und fachspezifischer Anwendungsfälle.

Copilot CLI enthält eine Standardgruppe von custom agents für allgemeine Aufgaben.

AgentDescription
ErkundenFührt eine schnelle Analyse des Code-Repositories durch, sodass Sie Fragen zu Ihrem Code stellen können, ohne zum Hauptkontext beizutragen.
AufgabeFührt Befehle wie zum Beispiel Tests und Builds aus und liefert bei Erfolg kurze Zusammenfassungen und bei Fehlern die vollständige Ausgabe.
Allgemeiner ZweckBehandelt komplexe, mehrstufige Aufgaben, die das vollständige Toolset und eine qualitativ hochwertige Argumentation erfordern, die in einem separaten Kontext ausgeführt wird, damit Ihre Hauptkommunikation klar fokussiert bleibt.
CodeüberprüfungÜberprüft Änderungen mit dem Fokus auf das Hervorheben nur echter Probleme, um Rauschen zu minimieren.

Das von der CLI verwendete KI-Modell kann sich entscheiden, eine Aufgabe an einen untergeordneten Subagentprozess zu delegieren, der mit einem custom agent mit spezifischem Fachwissen arbeitet, wenn dies zu einer effektiveren Fertigstellung der Arbeit führen würde. Das Modell kann sich ebenso dafür entscheiden, die Arbeit direkt im Hauptagent zu verarbeiten.

Sie können Ihr eigenes custom agents mithilfe von Markdown-Dateien definieren, die agent profiles genannt werden. Diese geben an, welche Expertise der Agent haben soll, welche Werkzeuge er verwenden kann und enthalten alle spezifischen Anweisungen für seine Reaktionen.

Sie können auf Benutzer-, Repository-, Organisations- oder Unternehmensebene definieren custom agents :

TypLocationGeltungsbereich
Benutzerebene custom agentlokales ~/.copilot/agents VerzeichnisAlle Projekte
Repository-Ebene custom agent
.github/agents Verzeichnis in Ihren lokalen und Remote-RepositoriesAktuelles Projekt
Organisationsebene custom agent
/agents-Verzeichnis im .github- oder .github-private-Repository der OrganisationAlle Projekte innerhalb der Organisation
Unternehmensebene custom agent
/agents-Verzeichnis im .github-private-Repository einer Organisation, die in Unternehmensumgebungen festgelegt ist. Weitere Informationen findest du unter Vorbereitung der Verwendung benutzerdefinierter Agents in Ihrem Unternehmen.Alle Projekte unter dem Unternehmenskonto

Im Falle von Namenskonflikten (bei denen Agents denselben Dateinamen teilen), überschreibt ein Agent auf Benutzerebene einen Agent auf Repositoryebene, einen Agent auf Repositoryebene überschreibt einen Agent auf Organisationsebene und ein Agent auf Organisationsebene überschreibt einen Agent auf Unternehmensebene.

Custom agents kann auf drei Arten verwendet werden:

  • Verwendung des Slash-Befehls in der interaktiven Benutzeroberfläche der CLI zur Auswahl aus der Liste der verfügbaren custom agents:

    /agent
    
  • Direktes Aufrufen von custom agent in einem Prompt:

    Use the refactoring agent to refactor this code block
    

Copilot leitet automatisch den Agent ab, den Sie verwenden möchten.

  • Geben Sie das custom agent an, das Sie mit der Befehlszeilenoption verwenden möchten. Beispiel:

    copilot --agent=refactor-agent --prompt "Refactor this code block"
    

Weitere Informationen findest du unter Erstellen von benutzerdefinierten Agents für Copilot cloud agent.

Verwenden von Fähigkeiten

Sie können Fähigkeiten erstellen, um die Fähigkeit Copilot zu verbessern, spezielle Aufgaben mit Anweisungen, Skripts und Ressourcen auszuführen.

Weitere Informationen findest du unter Hinzufügen von Agent-Fähigkeiten für GitHub Copilot CLI.

Hinzufügen eines MCP-Servers

Copilot CLI ist bereits mit dem GitHub MCP-Server konfiguriert. Dieser MCP-Server ermöglicht Ihnen, mit Ressourcen auf GitHub.com zu interagieren, sodass Sie Pull-Requests aus der CLI zusammenführen können.

Um die in Copilot CLI verfügbaren Funktionen zu erweitern, können Sie weitere MCP-Server hinzufügen.

  1. Verwende den folgenden Schrägstrichbefehl:

    /mcp add
    
  2. Gib die Details für den MCP-Server ein, den du hinzufügen möchtest, und verwende die TABULATORTASTE, um zwischen Feldern zu wechseln.

  3. Drücke Strg+S, um die Details zu speichern.

Die Details deiner konfigurierten MCP-Server werden in der Datei mcp-config.json gespeichert, die sich standardmäßig im Verzeichnis ~/.copilot befindet. Dieser Speicherort kann durch Festlegen der Umgebungsvariablen COPILOT_HOME geändert werden. Informationen zur JSON-Struktur einer Serverdefinition findest du unter Konfigurieren von MCP-Servern für Ihr Repository.

Ausführlichere Informationen zum Hinzufügen und Verwalten von MCP-Servern finden Copilot CLISie unter Hinzufügen von MCP-Servern für GitHub Copilot CLI.

Nächste Schritte

Um zu erfahren, wie Sie das Verhalten von Agenten während der Aufgabenausführung führen und verfeinern, um die Arbeit im Plan zu halten, lesen Sie Steuern von Agenten in GitHub Copilot CLI.