Erstellen von Automatisierungen mit Copilot Cloud-Agent

Einleitung

Mit automations können Sie Copilot cloud agent so einrichten, dass es entweder nach einem Zeitplan, als Reaktion auf ein Ereignis in einem Repository oder über die API ausgelöst automatisch ausgeführt wird. Automations kann aktionen innerhalb des Repositorys ausführen, in dem sie konfiguriert sind, z. B. Öffnen einer Pullanforderung oder Beschriftung eines Problems.

Sie können automations auf der Registerkarte Agents eines Repositorys auf GitHub erstellen und verwalten.

Sie können automations auch erstellen und verwalten von:

• Die Automations Registerkarte auf der Registerkarte GitHub Copilot app
• Das Fenster Agents in VS Code
• Die REST-API

Eine Übersicht über automationsTrigger, Tools, Sichtbarkeit und Sicherheit finden Sie unter Copilot Automatisierungen.

Voraussetzungen

Damit automations in einem Repository verfügbar ist, müssen alle folgenden Bedingungen erfüllt sein:

• Das Repository muss privat oder intern sein. Automations sind in öffentlichen Repositorys nicht verfügbar.
• Copilot cloud agent muss für das Repository aktiviert sein. Wenn Sie über Copilot Business oder Copilot Enterprise verfügen, muss ein Administrator die Copilot cloud agent-Richtlinie aktivieren. Siehe Verwalten von GitHub Copilot in der Cloud für Ihr Unternehmen oder Ihre Organisation.
• Die Organisation muss im Repository sowohl Copilot cloud agent als auch automations zulassen (beide sind standardmäßig aktiviert). Siehe Verwalten von GitHub Copilot in der Cloud für Ihre Organisation.

Automations sind mit den GitHub Copilot Pro-, GitHub Copilot Pro+-, GitHub Copilot Max-, GitHub Copilot Business- und GitHub Copilot Enterprise-Plänen verfügbar.

Aktivieren der Cloud automations in VS Code

Um die Cloud automations aus VS Code zu verwenden, erfüllen Sie die oben aufgeführten Repositoryvoraussetzungen und führen Sie dann Folgendes aus:

1. Aktualisieren Sie auf VS Code 1.144 oder höher.
2. Aktivieren Sie chat.automations.cloud.enabled im Einstellungen-Editor.
3. Öffnen Sie das Fenster "Agents", und wählen Sie dann die Registerkarte Automations aus.

Anweisungen zur Erstellung und Verwaltung finden Sie in der Dokumentation unter Erstellen und Verwalten von AgentautomatisierungenVS Code.

Erstellen eines automation

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.
2. Klicken Sie unter Ihrem Repositorynamen auf "Agents".
3. Klicken Sie in der Randleiste auf Automations.
4. Klicken Sie auf Erstellen automation.
5. Klicken Sie auf Mit Agent erstellen, um mit Copilot zu arbeiten und Ihr automations zu erstellen, oder auf Manuell erstellen, um automations mit einem Formular einzurichten.

Erstellen eines automation mit Copilot

Nachdem Sie auf „Mit Agent erstellen“ geklickt haben, wird ein Chatfenster angezeigt und Copilot fragt, was Sie automatisieren möchten.

Sie können mit Copilot arbeiten, um Ihre automation zu entwerfen und dabei die Trigger, Tools und Eingabeaufforderungen einzurichten.

Copilot kann Ihnen sogar helfen, selbstverbessernde Gruppen von automations zu erstellen, die aus Ergebnissen lernen und sich selbst Verbesserungen vorschlagen.

Manuelles Erstellen eines automation

1. Geben Sie einen Namen für das automation.

2. Wählen Sie unter Typ die Art von automation, die Sie erstellen möchten:

   • Persönlich: Nur Sie können die automation sehen. AI credits werden Ihnen in Rechnung gestellt, und Aktionen, die auf GitHub ausgeführt werden, verwenden Ihre Identität.
   • Freigegeben: Jeder mit Zugriff auf das Repository kann automation sehen. AI credits der Organisation oder dem Benutzer in Rechnung gestellt werden, die bzw. der das Repository besitzt, und Aktionen, die auf GitHub ausgeführt werden, verwenden die Identität von Copilot.

   Sie können den Typ nach dem Erstellen der automation nicht mehr ändern. Siehe Copilot Automatisierungen.

3. Wählen Sie einen oder mehrere Trigger aus, die bestimmen, wann automation ausgeführt wird. Sie können optional Filter für Trigger konfigurieren, um zu steuern, wann sie ausgelöst werden.

   Bei Problemen und Pull-Request-Triggern können Sie Folgendes auswählen:

   • Welche Ressourcen GitHub können während der Ausführung aktualisiert werden? Wählen Sie im Dropdownmenü „Konfigurierte Tools können ändern“ die Option „Alles in diesem Repository“ aus, damit GitHubTools alle Ressourcen im Repository erstellen und aktualisieren können. Wählen Sie Nur dieses Issue aus, um die Schreibvorgänge dieser Tools auf das Issue oder den Pull Request, die bzw. der die Ausführung ausgelöst hat, sowie auf alle während der Ausführung erstellten Ressourcen zu beschränken. Diese Einstellung schränkt keine Tools von MCP-Servern ein, die auf Ressourcen zugreifen können, auf die ihre Serverkonfiguration und Anmeldeinformationen Zugriff gewähren. Je nach Repositorykonfiguration ist die Option "Alles in diesem Repository " möglicherweise nicht verfügbar.
   • Ob Aktivitäten von Copilot in der Cloud dies automation auslösen können: Wählen Sie im Dropdown Kann ausgelöst werden von****Allen außer Copilot in der Cloud aus, um Ereignisse zu ignorieren, die von Copilot, einschließlich automations, ausgelöst werden. Wählen Sie Anyone aus, um alle Ereignisse zu überwachen, einschließlich Ereignissen, die von Copilot ausgelöst werden.
   • Gibt an, ob Benutzer mit nur Lesezugriff auf das Repository folgendes automationauslösen können: Standardmäßig werden Aktivitäten von Benutzern, automations die keinen Schreibzugriff auf das Repository haben, ignoriert. Deaktivieren Sie das Kontrollkästchen Von Benutzern ohne Schreibzugriff auf dieses Repository ausgelöste Ereignisse ignorieren, um diese Ereignisse zu empfangen. Je nach Repositorykonfiguration ist die Option Von Benutzern ohne Schreibzugriff auf dieses Repository ausgelöste Ereignisse ignorieren möglicherweise im aktivierten Zustand gesperrt.

4. Beschreiben Sie im Prompt-Feld die Aufgabe, die Copilot jedes Mal ausführen soll, wenn automation ausgeführt wird.

   Beispiel: Label this issue as a bug, an enhancement, or other, based on its content.

5. Wählen Sie optional das Modell und die Reasoning-Stufe aus, die Copilot verwenden soll. Siehe Ändern des KI-Modells für GitHub Copilot Cloud-Agent.

6. Wählen Sie die ToolsCopilot aus, die verwendet werden können, wenn automation ausgeführt wird, z. B. Änderungen pushen, Issue-Labels aktualisieren oder einen Pull Request erstellen.

   Sie können GitHub Tools und Tools von allen MCP-Servern auswählen, die in den MCP-Einstellungen des Repositorys konfiguriert sind. Um die Tools eines externen Systems verfügbar zu machen, muss ein Repositoryadministrator zuerst dessen MCP-Server für das Repository konfigurieren. Siehe Konfigurieren von MCP-Servern für Ihr Repository.

   Wählen Sie nur die Tools aus, die die Aufgabe erfordert. Die Tools, die Sie auswählen, steuern, welche Aktionen Copilot in Ihrem Repository ausgeführt werden können. Optional können Sie die Schaltfläche " Tools vorschlagen " verwenden, um Copilot tools basierend auf Ihrer Aufforderung vorzuschlagen. Siehe Copilot Automatisierungen.

7. Legen Sie optional unter AI-Kreditlimits Grenzwerte dafür fest, wie viele AI credits der automation verbrauchen kann. Siehe „Grenzwerte festlegenAI credits“.

8. Speichern Sie die automation Datei, indem Sie auf " Automatisierung erstellen" klicken.

Festlegen von AI credits Grenzwerten

Jedes Mal, wenn eine automation ausgeführt wird, werden AI credits verbraucht, die Ihnen für einen persönlichen automation oder dem Repositorybesitzer für ein freigegebenes automation in Rechnung gestellt werden. Zum Steuern der Kosten können Sie Grenzwerte im Abschnitt AI-Kreditlimits festlegen, wenn Sie ein automation erstellen oder bearbeiten.

Sie können die folgenden optionalen Grenzwerte in AI credits festlegen. Lassen Sie ein Limit leer, wenn Sie es nicht festlegen möchten.

• Pro Ausführung: Stoppt eine Ausführung, sobald sie den Grenzwert erreicht. Das Minimum beträgt 30 AI credits.
• Täglich: Verhindert, dass neue Läufe gestartet werden, sobald der Grenzwert erreicht ist. Setzt jeden Tag um 00:00 UTC zurück.
• Wöchentlich: Verhindert, dass neue Läufe gestartet werden, sobald der Grenzwert erreicht ist. Setzt jeden Montag um 00:00 UTC zurück.
• Monatlich: Verhindert, dass neue Läufe gestartet werden, sobald der Grenzwert erreicht ist. Setzt am ersten Tag jedes Monats um 00:00 UTC zurück.

Die täglichen, wöchentlichen und monatlichen Grenzwerte halten einen bereits laufenden Durchlauf nicht an. Um die Kosten für jede einzelne Ausführung zu begrenzen, legen Sie einen Grenzwert pro Ausführung fest.

Um einen Grenzwert zu entfernen, bearbeiten Sie automation und löschen Sie den Wert.

Test eines automation

Sie können einen automation sofort ausführen, ohne auf den Auslöser zu warten, um zu überprüfen, ob es sich wie erwartet verhält.

1. Öffnen Sie das automation, das Sie testen möchten, im Bereich Automations.

2. Klicken Sie auf Ausführen.

3. Wählen Sie im Dropdownmenü Trigger den Trigger aus, den Sie simulieren möchten.

4. Wenn Sie den manuellen Auslöser ausgewählt haben, geben Sie optional "Kontext " ein, der im Prompt des Agents enthalten sein wird. Sie können dies verwenden, um das Auslösen der automation über die API zu simulieren.

   Wenn Sie einen anderen Auslöser ausgewählt haben, füllen Sie die Ressourcen-URL mit der relevanten Ressource aus, z. B. die URL des Issue, das geöffnet wurde, oder den erstellten Pull-Request-Kommentar.

5. Klicken Sie auf Jetzt ausführen.

Copilot startet eine Copilot cloud agent-Sitzung und führt den Prompt von automation mit den von dir ausgewählten Tools aus. Sie können die Sitzung öffnen, um den Fortschritt zu verfolgen und alle vorgenommenen Änderungen zu überprüfen.

Verwalten Sie Ihre Automations

Ihre persönlichen automations sind privat für Sie. Freigegebene automations sind für alle Personen mit Lesezugriff auf das Repository sichtbar, und jede Person mit Schreibzugriff kann sie bearbeiten.

Die aus jeder automation gestarteten Sitzungen sind für jeden sichtbar, der Lesezugriff auf das Repository hat.

Im Automations-Bereich eines Repositorys können Sie Folgendes tun:

• Zeigen Sie Ihre persönlichen automations und die freigegebenen automations des Repositorys, die von ihnen gestarteten Sitzungen und die verbrauchten AI credits an.
• Bearbeiten Sie einen automation, um seinen Namen, seinen Prompt, Trigger, Tools, Modell, Denkaufwand oder AI credits Grenzwerte zu ändern und den Überarbeitungsverlauf des automation nachzuverfolgen.
• Überprüfen Sie vorgeschlagene Verbesserungen an den Tools, Auslösern oder Eingabeaufforderungen eines automation, die von automation selbst oder anderen automations vorgeschlagen werden.
• Deaktivieren Sie automation, um seine Ausführung zu stoppen, oder aktivieren Sie es später wieder.
• Löschen Sie ein automation, das Sie nicht mehr benötigen.

Um alle Ihre automations über sämtliche Repositorys hinweg anzuzeigen und zur Verwaltung der einzelnen zu navigieren, verwenden Sie auf Benutzerebene die Ansicht Automations.

Weiterführende Lektüre

• Copilot Automatisierungen
• Sitzungen mit GitHub Copilot starten
• Risiken und Risikominderungen für GitHub Copilot Cloud-Agent