Overview
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 definieren Ihre Eingabeaufforderung einmal, wählen Ihre Trigger aus und entscheiden, welche Tools Copilot verwenden können soll. Copilot führt Ihre Automatisierung automatisch aus, wenn der automationAuslöser ausgelöst wird.
Sie können z. B. folgendes verwenden automations :
- Reproduzieren sie Fehler: Versuchen Sie, einen gemeldeten Fehler zu reproduzieren, wenn ein Problem geöffnet wird.
- Erfassen Sie Screenshots für die Überprüfung: Erfassen Sie Screenshots von Änderungen, und fügen Sie sie an einen Pull Request an, wenn er als bereit für die Überprüfung markiert ist.
- Untersuchen von Produktionsvorfällen: Beginnen Sie mit der Untersuchung eines Vorfalls, wenn Ihr Überwachungstool ihn erkennt.
Sie können auch automations erstellen und verwalten:
- Die Registerkarte Agents eines Repositorys auf GitHub
- Die Automations Registerkarte in GitHub Copilot app
- Das Agents-Fenster in VS Code
- Die REST-API
Wenn Sie ein automationObjekt erstellen, definieren Sie Folgendes:
- Ein Name zum Identifizieren des automation.
- Ein Typ, entweder persönlich oder gemeinsam genutzt, der bestimmt, wer automation sehen und bearbeiten kann, wer abgerechnet wird und wessen Identität verwendet wird. Siehe Persönlich und freigegeben automations.
- Eine Eingabeaufforderung , die die auszuführende Copilot Aufgabe beschreibt.
- Trigger, die bestimmen, wann automation ausgeführt wird.
- Die ToolsCopilot, die verwendet werden können, steuern, welche Aktionen sie in Ihrem Repository ausführen können.
- Optional werden das Modell und die BegründungsebeneCopilot verwendet.
- Optional AI creditsGrenzen, die steuern, wie viele AI credits die automation verbrauchen kann.
Sie können automations zu automation groups hinzufügen, die Kontext gemeinsam nutzen und sich basierend auf den Ergebnissen selbst Verbesserungen vorschlagen.
Anweisungen zum Erstellen und Verwalten automationsfinden Sie unter Erstellen von Automatisierungen mit Copilot Cloud-Agent.
Verfügbarkeit und Berechtigungen
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.
Jeder Benutzer, der Schreibzugriff auf ein Repository hat, kann automations in diesem Repository erstellen.
Sie können automations erstellen und verwalten von:
- Die Registerkarte Agents in einem Repository auf GitHub, im Bereich Automations.
- Die Automations Registerkarte in der GitHub Copilot app.
- Die Automations Registerkarte im Fenster Agents in VS Code.
Cloud automations in VS Code erfordern Version 1.144 oder höher und dass die Einstellung chat.automations.cloud.enabled aktiviert ist.
Persönlich und geteilt automations
Wenn Sie ein automation erstellen, wählen Sie dessen Typ aus, den Sie später nicht ändern können.
- Persönliche Agenten automations sind nützlich, um eigene Aufgaben zu automatisieren, z. B. das Vorbereiten Ihrer Updates für einen Standup.
- Geteilt automations Lassen Sie Ihr Team automations gemeinsam erstellen und verwalten, um Workflows für das gesamte Team zu automatisieren.
| Personal | Shared | |
|---|---|---|
| Wer kann die automationsehen | Nur Sie | Jeder mit Lesezugriff auf das Repository |
| Wer kann die Läufe von automation sehen? | Jeder mit Lesezugriff auf das Repository | Jeder mit Lesezugriff auf das Repository |
| Wer kann das automation | Nur Sie | Jeder mit Schreibzugriff auf das Repository |
| Wem wird AI credits in Rechnung gestellt? | Sie | Die Organisation oder der Benutzer, dem das Repository gehört |
| Identität, die für Aktionen verwendet wird für GitHub | Ihre Identität | Identität von Copilot |
Da ein freigegebenes automation zum Repository gehört und nicht zu der Person, die es erstellt hat, funktioniert es weiterhin, wenn diese Person das Team verlässt oder den Zugriff auf das Repository verliert.
Damit ein freigegebenes automation in einem organisationseigenen Repository ausgeführt werden kann, muss die Organisation die der Organisation in Rechnung gestellte Nutzung von Copilot cloud agent zulassen. Ein Administrator kann dies mit der Richtlinie „Verwendung von Copilot cloud agent-Elementen zulassen, die der Organisation in Rechnung gestellt werden“ aktivieren.
Auslöser
Ein automation wird ausgeführt, wenn einer seiner Trigger ausgelöst wird. Eine vielzahl von Triggern stehen zur Verfügung, darunter:
- Nach Zeitplan: Die automation wird in einem wiederkehrenden Intervall ausgeführt – stündlich, täglich oder wöchentlich.
- Wenn ein Issue erstellt wird: das automation wird jedes Mal ausgeführt, wenn ein Issue in dem Repository erstellt wird.
- Wenn eine Pull-Anforderung geöffnet wird: Die automation Wird jedes Mal ausgeführt, wenn eine Pullanforderung im Repository geöffnet wird.
- Wenn eine Pullanforderung synchronisiert wird: Die automation Ausführung erfolgt jedes Mal, wenn neue Commits an eine Pullanforderung im Repository übertragen werden.
Sie können optional Filter für ereignisbasierte Trigger konfigurieren, z. B.:
- Wenn ein Problem erstellt wird, fügen Sie einen Suchabfragefilter hinzu.
- Wenn eine Pullanforderung geöffnet wird und eine Pullanforderung synchronisiert wird, fügen Sie einen Suchabfragefilter und einen Filter für Dateien hinzu, die in der Pullanforderung geändert wurden.
Um das Risiko einer Prompt-Injection zu verringern, ignorieren Sie GitHub Ereignisse, automations die von Benutzern ausgelöst werden, die standardmäßig keinen Schreibzugriff auf das Repository haben. Dadurch wird verhindert, dass Copilot aufgrund nicht vertrauenswürdiger Benutzer Maßnahmen ergreift, z. B. wenn ein externer Mitwirkender ein Problem öffnet. Sie können sich dafür entscheiden, diese Ereignisse zuzulassen, falls erforderlich. Weitere Informationen finden Sie unter Sicherheit und Sicherheit.
Alle automations können über die API ausgelöst werden, sodass Sie automations mit externen Systemen und Tools verbinden können. Beim Starten einer automation api können Sie zusätzlichen Kontext einschließen, der an die Eingabeaufforderung übergeben wird.
Tools und Aktionen
Die Werkzeuge, die Sie beim Erstellen eines automation auswählen, bestimmen, was Copilot tun kann, wenn automation ausgeführt wird.
Sie können beispielsweise Copilot erlauben, Änderungen zu übertragen, Issue-Labels zu aktualisieren oder einen Pull-Request zu erstellen.
Sie können aus zwei Arten von Tools wählen:
-
GitHub Tools, mit denen Sie mit Ihrem Repository auf Copilot arbeiten können. Zum Beispiel ermöglichen GitHub Tools Copilot:
- Anhänge hochladen
- Ausblenden und Einblenden von Kommentaren und Rezensionen
- Hinzufügen und Entfernen von Reaktionen
- Lesen Sie Diskussionen und deren Kommentare und kommentieren Sie Diskussionen
-
Tools von MCP-Servern, die Copilot das Arbeiten mit externen Systemen ermöglichen. Ein automation Kann Tools von den MCP-Servern verwenden, die in den MCP-Einstellungen des Repositorys konfiguriert sind. Sie wählen aus, welche Tools der einzelnen Server automation verwenden kann. Siehe Konfigurieren von MCP-Servern für Ihr Repository.
Die Auswahl von Tools ist die wichtigste Methode, mit der Sie den Umfang eines automation steuern. Gewähren Sie nur die Berechtigungen, die für die Aufgabe erforderlich sind, damit Copilot keine Aktionen ausführen kann, die Sie nicht vorgesehen haben.
Sie können die Tools, die Sie aktivieren möchten, manuell auswählen, oder Sie können die Schaltfläche „Tools vorschlagen“ auf GitHub verwenden, damit Copilot basierend auf Ihrer Eingabeaufforderung Tools vorschlägt.
GitHub Tools können nur Maßnahmen im einzelnen Repository ausführen, auf das der automation beschränkt ist. Tools von MCP-Servern sind nicht auf dieses Repository allein beschränkt: Sie können auf alles zugreifen, was die Konfiguration und Anmeldeinformationen des Servers erlauben, was andere Repositorys und externe Systeme umfassen kann. Überprüfen Sie, auf was jeder MCP-Server zugreifen kann, bevor Sie seine Tools auswählen.
Vom Repository geerbte Konfiguration
Automations verwenden Sie die Copilot cloud agent Konfiguration für das Repository, auf das sie ausgerichtet sind, einschließlich:
- Benutzerdefinierte Anweisungen. Siehe Hinzufügen von benutzerdefinierten Repositoryanweisungen für GitHub Copilot.
- Agent-Fähigkeiten. Siehe Hinzufügen von Agent-Fähigkeiten für GitHub Copilot.
- Firewallregeln. Siehe Anpassen oder Deaktivieren der Firewall für GitHub Copilot.
- Geheime Schlüssel und Variablen. Siehe Konfigurieren von geheimen Schlüsseln und Variablen für Copilot Cloud-Agent.
Automations werden getrennt von den Inhalten Ihres Repositorys gespeichert. Sie werden nicht in Git eingecheckt, sodass sie nicht zusammen mit Ihrem Code versioniert oder über Pull Requests verwaltet werden.
Billing
Jedes Mal, wenn eine automation Ausführung erfolgt, startet sie eine Copilot cloud agent Sitzung, die GitHub AI Credits verwendet und GitHub Actions Minuten dauert.
Bei automation persönlicher AI credits Nutzung wird dem Benutzer, der das automation erstellt hat, die Nutzung in Rechnung gestellt.
Bei einer gemeinsamen Nutzung von automationAI credits wird die Nutzung der Organisation in Rechnung gestellt, die das Repository besitzt, oder dem Copilot-Abonnement des Repository-Besitzers, wenn ein persönliches Konto das Repository besitzt. Weitere Informationen findest du unter GitHub Copilot Lizenzen und Abrechnung für GitHub Actions.
GitHub Actions Minuten werden separat dem Repositorybesitzer in Rechnung gestellt.
Kosten mit AI credits Grenzwerten kontrollieren
Sie können Beschränkungen festlegen, wie viele AI credits ein automation verbrauchen kann. Auf diese Weise können Sie wiederkehrende Arbeiten automatisieren und gleichzeitig die Kontrolle über Ihre Nutzung behalten.
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.
Sie können Grenzwerte festlegen, wenn Sie ein automationObjekt erstellen oder aktualisieren. Siehe Erstellen von Automatisierungen mit Copilot Cloud-Agent.
Vorgeschlagene Verbesserungen
Automations kann Verbesserungen an ihren eigenen Tools, Triggern und Eingabeaufforderungen sowie an denen anderer automations vorschlagen.
Automations kann Verbesserungen vorschlagen, wenn beim Arbeiten Probleme auftreten, z. B. fehlende Tools.
Wenn Sie automations mit Copilot erstellen, kann automation groups Ihnen helfen, sich selbst verbessernde automations zu erstellen, in denen einige Copilot arbeiten und andere Ergebnisse bewerten und kontinuierlich Verbesserungen vorschlagen.
Wenn für ein automation ein Verbesserungsvorschlag vorliegt, erhalten Sie eine Benachrichtigung und sehen den Vorschlag beim Anzeigen der automation.
Sie sehen eine Beschreibung der vorgeschlagenen Verbesserung und die Änderungen, die auf die automation group angewendet werden sollen. Sie können entscheiden, ob Sie die vorgeschlagene Verbesserung anwenden oder verwerfen möchten.
Sicherheit und Schutz
Automations ausgeführt werden Copilot, ohne dass eine Person jede Aufgabe einzeln startet, sodass sie einige zusätzliche Risiken mit sich bringen. GitHub bietet integrierte Schutzmaßnahmen, um diese Risiken zu mindern.
- Namensnennung.
- Aktionen, die von einer freigegebenen automation an GitHub ausgeführt werden, werden Copilot zugeordnet. Wenn für Ihr Repository mindestens eine Genehmigung für Pull Requests erforderlich ist, ist standardmäßig eine zusätzliche Genehmigung für Pull Requests erforderlich, die von einer freigegebenen automation erstellt wurden. Administratoren können diese zusätzliche Anforderung in Regelsätzen, aber nicht in Verzweigungsschutzregeln deaktivieren.
- Aktionen, die von einem persönlichen automation Benutzer ausgeführt werden, werden dem Benutzer zugeordnet, der die automation erstellt hat. Wie bei Pull Requests, die ein Benutzer selbst erstellt, kann er diese Pull Requests nicht genehmigen. Dadurch bleiben die erwarteten Review-Kontrollen erhalten.
- Tools mit den geringsten Rechten. Sie legen genau fest, welche Tools ein automation verwenden kann, sodass Sie es auf genau die Aktionen beschränken können, die die Aufgabe erfordert.
- Nicht vertrauenswürdige Eingabe. Standardmäßig ignorieren automations Ereignisse, die von Benutzern ohne Schreibzugriff auf das Repository ausgelöst werden, um das Risiko von Prompt-Injection durch nicht vertrauenswürdige Benutzer zu verringern.
- Workflow läuft. Standardmäßig werden Workflows, wie bei allen Copilot cloud agent-Work, nicht für einen Pull Request ausgeführt, bis ein Benutzer mit Schreibzugriff sie genehmigt. Dadurch wird das Risiko verringert, dass ein von automation geöffneter Pull Request automatisch Workflows auslöst.
- Transparente Läufe. Die Copilot cloud agent sitzungen, die von jedem automation, persönlichen oder freigegebenen , gestartet wurden, sind für alle sichtbar, mit Lesezugriff auf das Repository. Jeder, der diese Sitzungen sehen kann, kann den Prompt, die Sitzungsprotokolle und alle Pull Requests oder sonstigen Änderungen sehen, die Copilot erstellt.
Weitere Informationen dazu, wie GitHub die Risiken von Copilot cloud agent mindert, finden Sie unter Risiken und Risikominderungen für GitHub Copilot Cloud-Agent.
Weiterführende Lektüre
- Erstellen von Automatisierungen mit Copilot Cloud-Agent
- GitHub Copilot auf GitHub.com und GitHub Mobile
- Informationen dazu, wie Sie Ihre Automatisierung als Code speichern, sie in Pull Requests überprüfen oder sie mit einem anderen Coding-Agent ausführen, finden Sie unter GitHub agentenbasierte Workflows