Verwenden des Copilot-Cloud-Agenten auf GitHub

Starten Sie Copilot-Cloud-Agent Sitzungen direkt auf GitHub und verfeinern Sie die Ergebnisse anschließend, ohne Ihren Browser zu verlassen.

Wer kann dieses Feature verwenden?

Copilot-Cloud-Agent ist für alle kostenpflichtigen Copilot Pläne verfügbar.

Der Agent ist in allen Repositorys verfügbar, die auf GitHub gespeichert sind, mit Ausnahme von Repositorys, die im Besitz von verwaltete Benutzerkonten sind und wo er explizit deaktiviert wurde.
Sign up for Copilot

In diesem Artikel

Einführung

Sie können Copilot-Cloud-Agent Sitzungen an mehreren Stellen auf GitHub starten. Sobald eine Sitzung ausgeführt wird, können Sie den Fortschritt überwachen, ihn mit Nachverfolgungsaufforderungen steuern und die resultierende Pullanforderung durchlaufen – alles, ohne den Browser zu verlassen.

Weitere Informationen zu Copilot-Cloud-Agent findest du unter Informationen zu GitHub Copilot Cloud-Agent.

Starten einer Sitzung über die Registerkarte oder den Bereich "Agents"

Sie können Sitzungen über die Registerkarte "Agents" und den Bereich "Agents" starten. Der einzige Unterschied ist der Einstiegspunkt – sobald das Formular "Neuer Agent-Vorgang" angezeigt wird, sind die Schritte identisch.

  1. Öffnen des Agenten-Panels oder der Registerkarte:

    • Öffnen Sie die Registerkarte Agents in einem Repository.
    •           **Navigieren zur Seite „Agents“**: Wechsle zu [github.com/copilot/agents](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text). Alternativ kannst du zu dieser Seite navigieren, indem du das Panel „Agents“ öffnest und dann auf **View all** klickst.

    •           **Öffnen des Panels „Agents“**: Klicke auf der Navigationsleiste oben rechts auf GitHub auf <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-agent" aria-label="The Agents icon" role="img"><path d="M14.5 8.9v-.052A2.956 2.956 0 0 0 11.542 5.9a.815.815 0 0 1-.751-.501l-.145-.348A3.496 3.496 0 0 0 7.421 2.9h-.206a3.754 3.754 0 0 0-3.736 4.118l.011.121a.822.822 0 0 1-.619.879A1.81 1.81 0 0 0 1.5 9.773v.14c0 1.097.89 1.987 1.987 1.987H4.5a.75.75 0 0 1 0 1.5H3.487A3.487 3.487 0 0 1 0 9.913v-.14C0 8.449.785 7.274 1.963 6.75A5.253 5.253 0 0 1 7.215 1.4h.206a4.992 4.992 0 0 1 4.586 3.024A4.455 4.455 0 0 1 16 8.848V8.9a.75.75 0 0 1-1.5 0Z"></path><path d="m8.38 7.67 2.25 2.25a.749.749 0 0 1 0 1.061L8.38 13.23a.749.749 0 1 1-1.06-1.06l1.719-1.72L7.32 8.731A.75.75 0 0 1 8.38 7.67ZM15 13.45h-3a.75.75 0 0 1 0-1.5h3a.75.75 0 0 1 0 1.5Z"></path></svg>.

  2. Wählen Sie im Eingabeaufforderungsfeld mithilfe des Dropdownmenüs das Repository aus, in dem Copilot arbeiten soll.

  3. Gib einen Prompt ein, der deine Anfrage beschreibt. Sie können auch visuelle Eingaben wie Screenshots oder UI-Modelle hinzufügen, indem Sie ein Bild einfügen, ziehen oder hochladen. Unterstützte Dateien: image/png, image/jpeg, image/gif, image/webp.

    Beispiel: Implement a user friendly message for common errors.

    Wenn Sie Copilot zum Öffnen eines Pull-Requests, können Sie in Ihrem Prompt zum Beispiel Open a pull request to implement a user friendly message for common errors.

  4. Wählen Sie optional eine Basisverzweigung Änderungen von Copilot aus. Copilot erstellt basierend auf dieser Verzweigung eine neue Verzweigung.

  5. Optionalerweise können Sie auf klicken, um das Dropdownmenü des Agenten zu öffnen, wenn Sie einen Agenten oder ein Benutzerdefinierter Agent mit spezialisiertem Verhalten und Werkzeugen zuweisen möchten. Sie können ein vorhandenes Benutzerdefinierter Agent Aus ihrem Repository, Ihrer Organisation oder Ihrem Unternehmen auswählen. Sie können auch auf Agent erstellen klicken, um ein neues Agentprofil in Ihrem ausgewählten Repository und Branch zu erstellen. Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent.

    Hinweis

    Drittanbieter-Agents sind in allen kostenpflichtigen Copilot Plänen verfügbar.

  6. Optional können Sie das Dropdownmenü verwenden, um das zu verwendende Modell Copilot auszuwählen. Weitere Informationen findest du unter Ändern des KI-Modells für GitHub Copilot Cloud-Agent.

  7. Klicken Sie auf oder drücken Sie die EINGABETASTE.

Copilot startet eine neue Sitzung, die in der Liste unterhalb des Eingabeaufforderungsfelds angezeigt wird. Copilot arbeitet an der Aufgabe und überträgt Codeänderungen.

Sie können die Arbeit von Copilot nachverfolgen und mit einem Klick eine Pull-Request aus den Sitzungsprotokollen öffnen. Weitere Informationen findest du unter [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents).

Starten einer Sitzung über das Dashboard

Sie können Copilot im Dashboard über das Eingabefeld auffordern, mit der Arbeit zu beginnen. Das Dashboard ist Ihre personalisierte Übersicht über Ihre Aktivitäten auf GitHub, die angezeigt wird, wenn Sie https://github.com besuchen, während Sie eingeloggt sind.

  1. Navigieren Sie zum Dashboard unter https://github.com.

  2. Klicken Sie auf die Schaltfläche "Aufgabe".

  3. Wählen Sie im Eingabeaufforderungsfeld mithilfe des Dropdownmenüs das Repository aus, in dem Sie arbeiten möchten Copilot .

  4. Gib einen Prompt ein, der deine Anfrage beschreibt.

    Beispiel: Implement a user friendly message for common errors.

    Wenn Sie Copilot einen Pull-Request erstellen möchten, können Sie z. B. in Ihrer Aufforderung fragen. Open a pull request to implement a user friendly message for common errors.

  5. Wählen Sie optional einen Basiszweig für den Pull-Request von Copilot aus. Copilot erstellt basierend auf dieser Verzweigung eine neue Verzweigung.

  6. Optionalerweise können Sie auf klicken, um das Dropdownmenü des Agenten zu öffnen, wenn Sie einen Agenten oder ein Benutzerdefinierter Agent mit spezialisiertem Verhalten und Werkzeugen zuweisen möchten. Sie können ein vorhandenes Benutzerdefinierter Agent Aus ihrem Repository, Ihrer Organisation oder Ihrem Unternehmen auswählen. Sie können auch auf Agent erstellen klicken, um ein neues Agentprofil in Ihrem ausgewählten Repository und Branch zu erstellen. Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent.

    Hinweis

    Drittanbieter-Agents sind in allen kostenpflichtigen Copilot Plänen verfügbar.

  7. Klicken Sie auf Senden jetzt oder drücken Sie die Eingabetaste.

    Sie werden zur Registerkarte "Agents" weitergeleitet, und Copilot beginnt eine neue Sitzung, die in der Liste "Zuletzt verwendete Sitzungen" unterhalb des Eingabeaufforderungsfelds angezeigt wird. Copilot arbeitet an der Aufgabe und überträgt Codeänderungen.

    Hinweis

    Wenn Sie die neue Dashboard-Erfahrung in der Feature-Vorschau aktiviert haben, wird die neue Sitzung in "Agentsitzungen" unter dem Eingabefeld in Ihrem Dashboard angezeigt. Weitere Informationen findest du unter Persönliches Dashboard.

Ausgehend von Copilot Chat

  1. Öffnen Sie GitHub Copilot Gespräch auf GitHub.com.

  2. Geben Sie /task ein, um Copilot einen Pull-Request zu erstellen, und geben Sie Details an, was Sie von Copilot geändert haben möchten.

    Beispiel: /task Create a pull request to put backticks around file names and variables in output.

  3. Wählen Sie optional einen Basiszweig für den Pull-Request von Copilot aus. Copilot erstellt eine neue Verzweigung basierend auf dieser Verzweigung und verschiebt dann die Änderungen an eine Pullanforderung für diese Verzweigung.

  4. Optionalerweise können Sie auf klicken, um das Dropdownmenü des Agenten zu öffnen, wenn Sie einen Agenten oder ein Benutzerdefinierter Agent mit spezialisiertem Verhalten und Werkzeugen zuweisen möchten. Sie können ein vorhandenes Benutzerdefinierter Agent Aus ihrem Repository, Ihrer Organisation oder Ihrem Unternehmen auswählen. Sie können auch auf Agent erstellen klicken, um ein neues Agentprofil in Ihrem ausgewählten Repository und Branch zu erstellen. Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent.

    Hinweis

    Drittanbieter-Agents sind in allen kostenpflichtigen Copilot Plänen verfügbar.

  5. Klicken Sie auf oder drücken Sie die EINGABETASTE.

Copilot startet eine neue Sitzung, die in der Liste unterhalb des Eingabeaufforderungsfelds angezeigt wird. Copilot arbeitet an der Aufgabe und pusht Änderungen an der Pull-Anforderung und fügt Sie dann als Prüfer hinzu, wenn sie abgeschlossen ist, wodurch eine Benachrichtigung ausgelöst wird.

Zuweisen eines Problems zu Copilot

Sie können Copilot fragen, an einem Problem zu arbeiten, indem Sie das Problem Copilot zuweisen. Copilot beginnt mit der Arbeit an der Aufgabe, löst eine Pull-Anforderung aus und fordert dann eine Überprüfung von Ihnen an, wenn sie fertig ist.

Hinweis

Diese Funktion befindet sich in Öffentliche Vorschau und kann Änderungen unterliegen.

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Repositorynamen auf Issues.

    Screenshot der Hauptseite eines Repositorys. In der horizontalen Navigationsleiste ist eine Registerkarte mit der Bezeichnung „Issues“ dunkelorange umrandet.

  3. Öffnen Sie das Problem, dem Sie zuweisen Copilotmöchten.

  4. Klicke im Menü auf der rechten Seite auf Zugewiesene Personen.

    Screenshot der rechten Randleiste eines Issues. Eine Kopfzeile mit der Bezeichnung „Assignees“ ist dunkel-orange eingerahmt.

  5. Klicken Sie in der Liste der Zugewiesenen auf Copilot.

    Screenshot: Fenster „Assignees“ für ein Issue. Copilot ist in der Liste verfügbar.

    Es werden zusätzliche Optionen angezeigt.

    Ein Screenshot des Dialogfelds „Copilot zuweisen“ mit Optionen für das Ziel-Repository, Start-Branch, Benutzerdefinierter Agent und zusätzliche Anweisungen.

  6. Im Feld Optionale Eingabeaufforderung können Sie spezifische Anweisungen für Copilot hinzufügen. Fügen Sie Kontext, Einschränkungen oder bestimmte Anforderungen hinzu, die ihnen helfen Copilot , die Aufgabe zu verstehen und abzuschließen.

    Du kannst beispielsweise Anweisungen zu bestimmten zu verwendenden Codierungsmustern oder Frameworks, Testanforderungen, Codeformateinstellungen, Dateien oder Verzeichnissen einschließen, die geändert werden sollen oder nicht.

    Zusätzlich zu den hier angegebenen Details wird Copilot alle benutzerdefinierten Anweisungen verwenden, die für das Ziel-Repository konfiguriert wurden. Siehe Hinzufügen von benutzerdefinierten Repositoryanweisungen für GitHub Copilot.

  7. Sie können die Dropdownmenüs im Dialogfeld verwenden, um das Repository zu ändern, in dem Copilot arbeiten wird, und den Zweig, von dem es abzweigen wird.

    Alle Repositorys, in denen Sie mindestens Lesezugriff haben, werden im Dropdownmenü "Repository" angezeigt. Sie können jedoch nur ein Repository auswählen, wenn Sie Schreibzugriff darauf haben , und wenn Copilot-Cloud-Agent sie für dieses Repository aktiviert ist.

    Wenn Sie ein Repository in einer anderen Organisation als die Quellorganisation des Problems auswählen oder ein öffentliches Repository auswählen, wenn sich das Problem in einem privaten Repository befindet, wird eine Warnung angezeigt.

    Wenn Sie kein Repository angeben, wird Copilot im selben Repository wie das Issue arbeiten. Wenn Sie keinen Branch angeben, arbeitet Copilot aus dem Standard-Branch des ausgewählten Repositories.

    Tipp

    Wenn Sie ein Problem an Copilot zuweisen, werden ihm der Problemtitel, die Beschreibung, alle aktuellen Kommentare und alle zusätzlichen Anweisungen, die Sie angeben, gesendet. Nach der Zuweisung des Problems wird Copilot sich nicht bewußt sein und daher nicht auf weitere Kommentare reagieren, die dem Problem hinzugefügt werden. Wenn Sie weitere Informationen oder Änderungen an der ursprünglichen Anforderung haben, fügen Sie dies als Kommentar in der Pullanforderung hinzu, die Copilot ausgelöst wird.

  8. Optionalerweise können Sie auf klicken, um das Dropdownmenü des Agenten zu öffnen, wenn Sie einen Agenten oder ein Benutzerdefinierter Agent mit spezialisiertem Verhalten und Werkzeugen zuweisen möchten. Sie können ein vorhandenes Benutzerdefinierter Agent Aus ihrem Repository, Ihrer Organisation oder Ihrem Unternehmen auswählen. Sie können auch auf Agent erstellen klicken, um ein neues Agentprofil in Ihrem ausgewählten Repository und Branch zu erstellen. Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent.

    Hinweis

    Drittanbieter-Agents sind in allen kostenpflichtigen Copilot Plänen verfügbar.

  9. Optional können Sie das Dropdownmenü verwenden, um das zu verwendende Modell Copilot auszuwählen. Weitere Informationen findest du unter Ändern des KI-Modells für GitHub Copilot Cloud-Agent.

Sie können auch Aufgaben von anderen Stellen auf CopilotGitHub.com zuweisen:

  • Aus der Liste der Probleme auf der Seite "Probleme" eines Repositorys****.
  • Beim Anzeigen eines Problems in GitHubProjekte.

Initialisieren eines neuen Repositorys

Beim Erstellen eines neuen Repositorys können Sie Copilot bitten, das neue Repository zu initialisieren, indem Sie ein Eingabefeld ausfüllen.

  1. Wähle in der rechten oberen Ecke einer beliebigen Seite , und klicke dann auf Neues Repository.

    Screenshot eines GitHub-Dropdownmenüs mit Optionen zum Erstellen neuer Elemente. Das Menüelement „Neues Repository“ ist in dunklem Orange eingerahmt.

  2. Verwende das Dropdownmenü Besitzer, um das Besitzerkonto für das Repository auszuwählen.

    Screenshot des Besitzermenüs für ein neues GitHub-Repository. Das Menü zeigt zwei Optionen, octocat und github.

  3. Geben Sie im Feld "Eingabeaufforderung " eine Eingabeaufforderung ein, die beschreibt, was Sie erstellen möchten Copilot .

    Zum Beispiel Create a Rust CLI for converting CSV spreadsheets to Markdown1. Klicke auf Repository erstellen.

Copilot öffnet sofort einen Entwurfs-Pull-Request. Copilot arbeitet an der Aufgabe und pusht Änderungen an der Pull-Anforderung und fügt Sie dann als Prüfer hinzu, wenn sie abgeschlossen ist, wodurch eine Benachrichtigung ausgelöst wird.

Behebung einer fehlgeschlagenen GitHub Actions Workflow-Ausführung

Hinweis

Diese Funktion ist nur für Copilot Business- und Copilot Enterprise-Benutzer verfügbar.

Wenn ein GitHub Actions-Workflowlauf in einem Pull-Request-Branch fehlschlägt, können Sie Copilot bitten, den Fehler zu untersuchen und zu beheben.

  1. Navigieren Sie auf GitHub zur Auftragsseite der fehlgeschlagenen Workflow-Ausführung.

  2. Klicken Sie auf die Schaltfläche "Korrigieren mitCopilot".

Copilot wird eine neue Sitzung starten, die Ursache für den Fehler untersuchen und eine Fehlerbehebung in Ihren Branch übertragen.

Weiterarbeit an einem Pull Request

Sie können @copilot in einem Kommentar in jedem Pull Request erwähnen, um Copilot zu bitten, Änderungen vorzunehmen. Dies funktioniert bei Pull Requests, die von Copilot erstellt wurden, sowie bei Pull Requests, die von dir oder anderen erstellt wurden.

Copilot überträgt standardmäßig Commits direkt an den Pull-Request-Branch. Wenn Sie stattdessen eine separate Pullanforderung erstellen möchten, beschreiben Sie dies in Ihrem Kommentar. Sie können auch die Verzweigung auschecken und Änderungen selbst pushen.

Kommentare im Stapel überprüfen, anstatt sie einzeln zu übermitteln. Wählen Sie beim Übermitteln eines Pull-Request-Kommentars (kein Überprüfungs- oder Rezensionskommentar) über die GitHub Weboberfläche ein Modell mit dem Modell-Auswahlwerkzeug aus. Copilot verwendet das Modell standardmäßig aus der ursprünglichen Pullanforderung.

Copilot antwortet nur auf Kommentare von Personen, die Schreibzugriff auf das Repository haben.

Wenn Copilot eine neue Sitzung als Reaktion auf Ihren Kommentar startet, erscheint eine Augen-Emoji-Reaktion (👀) bei Ihrem Kommentar. In der Chronik der Pull-Anforderung wird ein Ereignis "Copilot hat die Arbeit aufgenommen" angezeigt.

Screenshot einer Zeitachse für einen Pull-Request mit einem Prüfungskommentar und einer Augen-Emoji-Reaktion sowie einem Zeitachsenereignis "Copilot hat die Arbeit begonnen".

Copilot merkt sich den Kontext aus früheren Sitzungen in derselben Pull-Anforderung, sodass Die Nachverfolgungsanforderungen schneller und zuverlässiger sind. Wenn die Pullanforderung von einem Benutzerdefinierter Agenterstellt wurde, wird die Erwähnung @copilot weiterhin mit demselben Agent verwendet.

Auflösen von Merge-Konflikten

Sie können Copilot auf zwei Arten bitten, Merge-Konflikte in einem Pull-Request zu lösen:

  • Verwenden der Schaltfläche "Fix mit Copilot": Wenn ein Pull-Request Zusammenführungskonflikte aufweist, klicken Sie auf die Schaltfläche "Korrigieren mit Copilot", die im Zusammenführungsfeld angezeigt wird.
  • Verwenden einer @copilot Erwähnung: Erwähnen Sie @copilot in einem Kommentar in der Pull-Anforderung, und bitten Sie ihn, die Konflikte zu beheben, z. B. "@copilot lösen Sie die Zusammenführungskonflikte in dieser PR."

Copilot analysiert die widersprüchlichen Änderungen, löst sie auf und überprüft, ob der Build, die Tests und der Linter noch bestehen. Anschließend wird Ihre Überprüfung angefordert, damit Sie die Lösung bestätigen können, bevor sie zusammengeführt wird.

Verwalten von GitHub Actions Workflowausführungen

Standardmäßig werden GitHub Actions Workflows nicht automatisch ausgeführt, wenn Copilot Änderungen an einen Pull-Request übertragen.

GitHub Actions Workflows können privilegiert sein und Zugriff auf vertrauliche Geheimnisse haben. Überprüfe die vorgeschlagenen Änderungen im Pull Request, und stelle sicher, dass dir die Ausführung deiner Workflows im Pull Request-Branch zusagt. Du solltest besonders auf vorgeschlagene Änderungen im .github/workflows/-Verzeichnis achten, die sich auf Workflowdateien auswirken.

Um die Ausführung von Workflows zu ermöglichen, klicken Sie im Zusammenführungsfeld der Pull-Anfrage auf die Schaltfläche GitHub Actions.

Screenshot des Zusammenführungsfelds bei einem Pull Request von Copilot mit der Schaltfläche „Workflows genehmigen und ausführen“.

Optional können Sie so konfigurieren Copilot-Cloud-Agent , dass GitHub Actions Workflows ohne menschliche Eingriffe ausgeführt werden können. Weitere Informationen finden Sie unter Konfigurieren von Einstellungen für GitHub Copilot Cloud-Agent.

Feedback zu der Arbeit von Copilot

Verwenden Sie die Feedbackschaltflächen für Copilotpull-Anforderungen und Kommentare, um die Ausgabe zu bewerten. Ihr Feedback trägt dazu bei, die Qualität zu verbessern Copilot.

  1. Klicken Sie auf einer Pullanforderung oder einem Kommentar auf Copilot die Daumen hoch (👍) oder die Daumen runter (👎) Taste.
  2. Wenn Sie auf die Schaltfläche "Daumen nach unten" klicken, wählen Sie optional einen Grund aus, und hinterlassen Sie einen Kommentar, und klicken Sie dann auf "Feedback senden".

Weiterführende Lektüre