Erste Schritte mit GitHub Copilot Agentmodus

Mit dem GitHub Copilot-Agent-Modus 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 Agentmodus 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 Ask aus, um das Dropdownmenü für den 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.

Screenshot mit zusätzlichen Tools, die der Agentmodus verwendet.

4. Copilot fordert eine Bestätigung an, bevor Sie einen Terminalbefehl ausführen oder ein nicht integriertes Tool verwenden.

Screenshot, das die Befehle zur Agentgenehmigung zeigt.

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.

Screenshot einer Liste der vorgeschlagenen Bearbeitungen.

• Ü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 die spezifische Änderung in jedem Schritt überprüfen.

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

Tipp

Visual Studio enthält auch integrierte Agents wie @debug, @profiler, @test und @vs, die in bestimmte IDE-Features integriert werden. Sie können auch benutzerdefinierte Agents für Ihre Teamworkflows erstellen. Weitere Informationen finden Sie unter Use custom agents in GitHub Copilot.

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 auszuführen. Wenn beispielsweise eine Codebearbeitung zu Syntaxfehlern in der Datei führt, Copilot möglicherweise 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 es eine Bestätigung zum Ausführen des Tools an. 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.

Screenshot einer Toolbestätigungsanforderung.

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 ExtrasOptionen zurücksetzen. Erweitern Sie den Abschnitt All Settings>GitHub>Copilot>Tools.

Annehmen oder Verwerfen von Bearbeitungen

Copilot listet die bearbeiteten Dateien in der Liste Zutale Änderungen im Chatfenster auf.

Screenshot einer Liste der bearbeiteten Dateien.

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.

Bearbeitungen rückgängig machen

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.

Screenshot, der das Wiederherstellen von Bearbeitungen zeigt.

Derzeit unterstützt der Visual Studio Copilot-Agent keine schrittweise Rückgängig- oder Wiederholen-Funktion.

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.

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

Wenn die Planung aktiv ist, Copilot:

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

Diese Struktur hilft Copilot konsistent zu bleiben, ihren Plan dynamisch zu aktualisieren und Entwicklern Einen Einblick in ihre Aufgaben zu bieten.

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 des Plans aus und aktualisiert dabei beide Dateien.

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

Lagerung

Beide Dateien werden in gespeichert.

Tools, die in der Planung verwendet werden

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

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.

Diese Tools ermöglichen Copilot das inkrementelle Verwalten von mehrstufigen Workflows, die Verwaltung des Ausführungszustands und die Einhaltung der Benutzerabsicht.

Aktivieren und Verwalten von Planungstools

So aktivieren Sie die Planung:

1. Öffnen Sie den Bereich Tools>Options, und erweitern Sie den Abschnitt All settings>GitHub>Copilot>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:

Screenshot der Gruppe "Planungstools", in der alle Untertools im Agentmodus aktiviert sind.

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: Planing in Copilot Chat – Visual Studio Entwicklercommunity

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 Chatfenster von Copilot sehe ich den Modus "Fragen" und den Modus "Agent" nicht.

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 unter Help>About Visual Studio.

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

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

   Im Bereich Tools>Options erweitern Sie die All Settings>GitHub>Copilot>Copilot Chat Abschnitt, und überprüfen Sie, ob 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-Änderungen in Visual Studio passiert?

Der Agentmodus ist eine Weiterentwicklung von Copilot Edits, mit besseren Fähigkeiten, um Fehler zu beheben, Tools zu verwenden und Codeänderungen automatisch anzuwenden.

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

Der Agent-Modus in Visual Studio wird durch das Kennzeichen "Editor-Vorschaufunktionen" im GitHub Copilot-Dashboard für Administratoren gesteuert. Wenn der Administrator diese Einstellung deaktiviert, können Benutzer unter diesem Abonnement den Agentmodus in Visual Studio nicht verwenden.

Weitere Informationen finden Sie unter Managing policies and features for GitHub Copilot in your enterprise.

Verwandte Inhalte

• Use custom agents in GitHub Copilot
• GitHub Copilot Edits
• GitHub Copilot Kostenlos