Erste Schritte mit dem GitHub Copilot-Agentmodus

Mit dem GitHub Copilot-Agentmodus in Visual Studio können Sie eine natürliche Sprache verwenden, um eine allgemeine Aufgabe anzugeben. KI erstellt einen Plan, erstellt Codebearbeitungen, führt Terminalbefehle aus, ruft Tools auf und wendet Änderungen auf Ihrer Codebasis an. Es überwacht Ergebnisse wie Buildergebnisse, Komponententestfehler oder Toolausgaben und wiederholt die Vorgänge bei Bedarf.

Im Gegensatz zum Fragenmodus wird der Agentmodus nach einer einzelnen Antwort nicht beendet. Sie wird weiterhin ausgeführt und optimiert, bis Sie das Ziel in Ihrer Eingabeaufforderung erreichen oder mehr Eingaben erforderlich sind.

Prerequisites

Sie benötigen Visual Studio 2022, Version 17.14 oder höher.

Verwenden des Agentmodus

Im Agent-Modus arbeitet Copilot autonom und bestimmt den relevanten Kontext für Ihre Eingabeaufforderung.

Gehen Sie folgendermaßen vor, um loszulegen:

1. Öffnen Sie das Fenster "Copilot-Chat", wählen Sie "Fragen " aus, um das Dropdownmenü "Modus" zu erweitern, und wählen Sie dann "Agent" aus.

   

2. Geben Sie Ihre Eingabeaufforderung ein, und wählen Sie dann "Senden" aus, oder wählen Sie die EINGABETASTE aus, um sie zu übermitteln. Sie können eine allgemeine Anforderung angeben, und Sie müssen nicht angeben, an welchen Dateien sie arbeiten sollen.

3. Der Agentmodus ruft möglicherweise mehrere Tools auf, um verschiedene Aufgaben auszuführen. Wählen Sie optional das Symbol "Extras " aus, um zu konfigurieren, welche zusätzlichen Tools der Agent für die Reaktion auf Ihre Anforderung verwenden kann.

   

4. Copilot fordert eine Bestätigung an, bevor ein Terminalbefehl ausgeführt wird oder ein nicht integriertes Tool verwendet wird.

   

5. Copilot erkennt automatisch Probleme in Codebearbeitungen oder Terminalbefehlen und führt dann Maßnahmen aus. Der Vorgang wird wiederholt, bis die Probleme behoben werden.

6. Während Copilot Ihre Anforderung verarbeitet, werden die vorgeschlagenen Codebearbeitungen direkt im Editor gestreamt. Überprüfen Sie die vorgeschlagenen Bearbeitungen, und führen Sie eine der folgenden Aktionen aus:

   • Behalten oder verwerfen Sie die vorgeschlagenen Änderungen als Ganzes in den Gesamtänderungen im Chatfenster.

     

   • Überprüfen Sie einzelne Datei-Diffs, und wenden Sie sie selektiv an.

7. Wenn Sie einzelne Codeänderungen überprüfen möchten, die der Agent vorgenommen hat, können Sie eine der folgenden Aktionen ausführen:

   • Überprüfen Sie die spezifische Änderung bei jedem Schritt.

     

   • Überprüfen Sie die kumulativen Änderungen ab dem letzten Zeitpunkt, zu dem Änderungen beibehalten oder rückgängig gemacht wurden.

     

8. Fahren Sie mit dem Durchlaufen der Codeänderungen fort, um die Bearbeitungen zu verfeinern oder weitere Features zu implementieren.

Verstehen von Agentenmodus-Tools

Der Agentmodus kann die folgenden Tools verwenden, um auf eine Anforderung zu reagieren:

• Integrierte Tools
• Model Context Protocol (MCP) Tools

Um die im Agentmodus verfügbaren Werkzeuge anzuzeigen und zu verwalten, wählen Sie im Chatfenster das Symbol Extras aus.

Basierend auf dem Ergebnis eines Tools kann Copilot andere Tools aufrufen, um die gesamtanforderung zu erfüllen. Wenn beispielsweise eine Codebearbeitung zu Syntaxfehlern in der Datei führt, kann Copilot einen anderen Ansatz untersuchen und verschiedene Codeänderungen vorschlagen.

Zusätzliche Tools, die Sie hinzufügen, indem Sie MCP-Server ausführen, sind nicht automatisch aktiviert. Die Kontrollkästchen sind standardmäßig deaktiviert, und Sie müssen sie aktivieren, um die Tools zu aktivieren.

Verwalten von Toolgenehmigungen

Wenn Copilot ein Tool aufruft, fordert er die Bestätigung an, das Tool auszuführen. Der Grund dafür ist, dass Tools möglicherweise lokal auf Ihrem Computer ausgeführt werden und Aktionen ausführen, die Dateien oder Daten ändern.

Verwenden Sie im Chatfenster nach einem Toolaufruf die Dropdownoptionen "Zulassen ", um das spezifische Tool für die aktuelle Sitzung oder Lösung oder alle zukünftigen Aufrufe automatisch zu bestätigen.

Sie können die Bestätigungsoptionen für Werkzeuge im Bereich Extras>Optionen zurücksetzen. Erweitern Sie den Abschnitt "All Settings>GitHub>Copilot>Tools ".

Annehmen oder Verwerfen von Bearbeitungen

Copilot listet die bearbeiteten Dateien in der Liste " Gesamtänderungen " im Chatfenster auf.

Wählen Sie jede Datei aus, um Änderungen einzeln zu überprüfen. Sie können Bearbeitungen, die an jedem Codeabschnitt vorgenommen wurden, beibehalten oder rückgängig machen.

Wählen Sie alternativ in der Liste "Gesamtänderungen" die Option "Beibehalten" oder "Rückgängig" für alle Änderungen aus, die seit der letzten Auswahl von "Beibehalten" oder "Rückgängig" vorgenommen wurden.

Wiederherstellen von Bearbeitungen

Wenn Sie Codebearbeitungen anfordern, möchten Sie möglicherweise einige Änderungen wiederherstellen. Um den Vorgang wiederherzustellen, wählen Sie " Wiederherstellen " neben dem Prüfpunkt vor der Eingabeaufforderung aus, die änderungen enthält, die Sie nicht benötigen.

Der Visual Studio Copilot-Agent unterstützt derzeit kein schrittweises Rückgängigmachen oder Wiederholen.

Unterbrechen einer Agentmodusanforderung

Um eine laufende Anforderung zu unterbrechen, können Sie sie abbrechen. Durch das Abbrechen einer Anforderung werden alle ausgeführten Tools und Terminalbefehle beendet.

Um einen Build zu beenden, wählen Sie "Erstellen " auf der oberen Symbolleiste und dann " Abbrechen" aus. Alternativ die Tastenkombination STRG+UMBRUCH verwenden.

Planen im Agentmodus (Vorschau)

Hinweis

Die Planung ist in der öffentlichen Vorschau mit Visual Studio 2022, Version 17.14, verfügbar. Dieses Feature befindet sich in der aktiven Entwicklung und kann basierend auf Benutzerfeedback weiterentwickelt werden.

Die Planung im Agentmodus ermöglicht Es Copilot, komplexe oder mehrstufige Anforderungen in strukturierte, nachverfolgbare Aufgaben vor der Ausführung aufzuteilen.

Wenn die Planung aktiv ist, ist Copilot aktiv:

• Erstellt einen vom Benutzer zugänglichen Markdownplan , der Ziele und Fortschritt umschreibt.
• Verwaltet einen internen JSON-Plan (plan-{sessionId}.json), der als LLM-lesbares Scratchpad zur Schrittverfolgung, Begründung und Koordination dient.

Diese Struktur hilft Copilot dabei, konsistent zu bleiben, seinen Plan dynamisch zu aktualisieren und Entwicklern Einen Einblick in ihre Aufgaben zu verschaffen.

Funktionsweise

Anforderungsanalyse

Wenn ein Vorgang mehrere Schritte erfordert, wechselt Copilot in den Planungsmodus.

Erstellung des Plans

• Markdown-Plan: Beschreibt den Vorgang, die Schritte und den Fortschritt in einem lesbaren Format.
• JSON-Plan: Ein strukturiertes, LLM-lesbares Format, das denselben Plan in maschinenparsierbarer Form erfasst. Diese JSON-Datei ermöglicht es Copilot, den Plan konsistent zu aktualisieren und zu interpretieren.

Ausführung und Iteration

Copilot führt jeden Schritt im Plan aus, wobei beide Dateien aktualisiert werden, sobald sie fortgesetzt wird.

• Der Markdownplan wird im Editor sichtbar aktualisiert.
• Der JSON-Plan entwickelt sich hinter den Kulissen, indem Copilot Schritte verfeinert, neu anordnet oder anpasst.

Lagerung

Beide Dateien werden in C:\Users\username\AppData\Local\Temp\VisualStudio\copilot-vsgespeichert.

Tools, die in der Planung verwendet werden

Wenn Sie die Planung aktivieren, wird ein dedizierter Satz interner Tools aktiv. Diese Tools koordinieren, wie Copilot Pläne während der Ausführung erstellt, aktualisiert und finalisiert.

Tool	Description
plan	Generiert den ursprünglichen strukturierten Plan aus der Benutzeranforderung.
adapt_plan	Optimiert oder passt den Plan basierend auf dem neuen Kontext oder Feedback an.
update_plan_progress	Aktualisiert den Status des Schrittabschlusses und synchronisiert den Planstatus.
record_observation	Erfasst Laufzeitergebnisse oder Einblicke, die sich auf die nächsten Aktionen auswirken.
`finish_plan`	Schließt den Plan ab, sobald alle Schritte abgeschlossen sind.

Mit diesen Tools kann Copilot mehrstufige Workflows inkrementell verwalten, den Ausführungszustand beibehalten und mit der Benutzerabsicht in Einklang bleiben.

Aktivieren und Verwalten von Planungstools

So aktivieren Sie die Planung:

1. Öffnen Sie den Bereich "ExtrasOptionen", und erweitern Sie den Abschnitt "Alle Einstellungen", "GitHub", "Copilot Chat".

2. Aktivieren Sie das Kontrollkästchen Planung aktivieren .

Nachdem Sie die Planung aktiviert haben, werden die Planungstools in der Liste "Extras " im Chatfenster angezeigt:

Sie können das Planungstool, das direkt in der Liste "Extras" im Chatfenster festgelegt ist, selektiv deaktivieren. Wenn Sie Planungstools deaktivieren müssen, empfehlen wir, alle zu deaktivieren, nicht nur eines. Änderungen gelten sofort für Ihre aktuelle Chatsitzung.

Tipp

Wenn Sie einzelne Tools deaktivieren, können Sie mit verschiedenen Planungsverhaltensweisen experimentieren oder bestimmte Schritte während der Entwicklung debuggen.

Einschränkungen

• Pläne werden vorübergehend gespeichert und gelöscht, wenn die Sitzung beendet wird, es sei denn, sie werden manuell gespeichert.
• Aufgrund der strukturierten Zustandsnachverfolgung besteht eine leichte Latenzüberlast.
• Einige spezialisierte Agents unterstützen die Planung möglicherweise noch nicht.

Feedback senden

Wir verbessern aktiv die Planung im Agentmodus. Teilen Sie Ihr Feedback, melden Sie Probleme, oder schlagen Sie hier Verbesserungen vor: Planen in Copilot Chat – Visual Studio Developer Community

Häufig gestellte Fragen

Welche Sichtbarkeit hat der Agentmodus in meine Dateien?

Der Agentmodus kann nur bearbeiten:

• Lokale Dateien, die Teil der Lösung sind.
• Lokale Dateien, die sich im geöffneten Lösungsverzeichnis oder seinen Unterverzeichnissen befinden.

Der Agentmodus kann nicht auf Dateien und Verzeichnisse zugreifen, die über den Dateiausschluss ausgeschlossen sind.

Für Terminalbefehle verfügt der Agentmodus über die gleichen Berechtigungen wie der ausgeführte Visual Studio-Prozess und ist nicht auf die vorherigen Einschränkungen beschränkt. Überprüfen Sie die vorgeschlagenen Terminalbefehle sorgfältig, bevor Sie sie ausführen.

Im Fenster "Copilot-Chat" wird der Fragemodus und der Agentmodus nicht angezeigt.

Führen Sie die folgenden Schritte zur Problembehandlung in der angegebenen Reihenfolge aus:

1. Stellen Sie sicher, dass Sie Visual Studio 17.14 oder höher verwenden.

   • Überprüfen Sie die Version in der Hilfe>zu Visual Studio.

   • Wenn Sie Version 17.14 oder höher nicht verwenden, öffnen Sie das Visual Studio-Installationsprogramm, und aktualisieren Sie Den Build.

2. Vergewissern Sie sich, dass der Agent-Modus in der Chatbereichsoption aktiviert ist.

   Erweitern Sie im Bereich "Extras>Optionen" den Abschnitt "Alle Einstellungen>, GitHub>Copilot>Chat", und vergewissern Sie sich, dass die Option ausgewählt ist.

3. Versuchen Sie, Visual Studio neu zu starten.

Wann sollte ich den Fragemodus im Vergleich zum Agentmodus verwenden?

• Der Fragemodus ist hervorragend, wenn Sie 100% Vertrauen haben möchten, dass keine Codebearbeitungen vorgenommen werden, es sei denn, Sie wählen explizit "Anwenden" aus, oder kopieren Sie den Code selbst.
• Der Agentmodus kann dieselben konzeptionellen Fragen verarbeiten und Codebeispiele generieren, ohne sie anzuwenden, zusammen mit den Agent-Funktionen des Bearbeitungscodes.
• Wenn Sie MCP-Funktionen verwenden möchten, müssen Sie den Agentmodus ausgewählt haben.

Was ist mit Copilot Edits in Visual Studio passiert?

Der Agentmodus ist eine Weiterentwicklung von Copilot Edits, mit einer verbesserten Fähigkeit, Fehler zu iterieren, Tools zu verwenden und Codeänderungen automatisch anzuwenden.

Wie kann ich als Administrator die Verwendung des Agentmodus für Visual Studio-Benutzer steuern?

Der Agentmodus in Visual Studio unterliegt dem Editor-Vorschaufeature-Flag im GitHub Copilot-Dashboard für Administratoren. Wenn der Administrator diese Einstellung deaktiviert, können Benutzer unter diesem Abonnement den Agentmodus in Visual Studio nicht verwenden.

Weitere Informationen finden Sie unter Verwalten von Richtlinien und Features für GitHub Copilot in Ihrem Unternehmen.

Verwandte Inhalte

• GitHub Copilot Edits
• GitHub Copilot Kostenlos