Jede Automatisierung startet ohne expliziten Befehl von jemandem. Sie läuft nach einem Zeitplan oder bei bestimmten Ereignissen: Wenn ein pull request geöffnet wird, ein Issue erstellt wird oder ein Check oder Deployment fehlschlägt.
Jede Automatisierung ist in der Factory unter dem Reiter „Automatisierungen“ aufgelistet – inklusive des Auslösers und der ausgeführten Aktionen. Erstellen Sie eine neue Automatisierung in „Neue Aufgaben“: Wählen Sie „Automatisierung“ aus und definieren Sie anschließend wann sie ausgeführt wird und welche Aktionen sie ausführt – ganz in Ihren eigenen Worten.
- ZeitplanZeit
- Ereignisbasierte AutomatisierungEtwas tritt ein.
Eine gewöhnliche Aufgabe
Spezifikation, Plan, Erstellung, Überprüfung, Review. Nutzt einen Agenten-Slot; weisen Sie ihm eine niedrigere Priorität zu.
P2P3Ein pull request
Es kann sich nicht selbst zusammenführen oder in Ihren Basis-Branch committen.
Sie genehmigen
Zwei Arten von Auslösern
| Auslöser | Ausführungen | Beispiel |
|---|---|---|
| Ein Zeitplan | Alle paar Stunden oder täglich, wöchentlich oder monatlich | Fragen Sie Sentry stündlich nach neuen Fehlern und erstellen Sie für jeden einen entsprechenden Task. |
| Etwas passiert | Wenn GitHub oder Coroid das entsprechende Event sendet | Wenn ein Task fehlschlägt, wird die Ursache ermittelt und ein Task zur Behebung des Problems angelegt. |
Verwenden Sie einen Zeitplan, wenn der Auslöser tatsächlich zeitbasiert ist oder wenn das zu überwachende Element in einem anderen System liegt, das keine Coroid-Events sendet – wie etwa Sentry oder Jira. Der Zeitplan fragt dieses System über Ihre Verbindungen ab. MCP-Server und leitet die daraus resultierende Arbeit weiter. Siehe Zeitpläne.
Verwenden Sie einen Event-Auslöser, wenn Coroid zum Zeitpunkt des Ereignisses informiert werden kann. Dadurch wird weniger unnötige Arbeit geleistet als bei einem Zeitplan, der ständig nachfragt.
Events, die Sie in „Neue Aufgaben“ auswählen können
Von GitHub, das die GitHub App:
- Ein pull request wird geöffnet, aktualisiert oder zusammengeführt
- Ein Issue wird erstellt
- Ein Kommentar erwähnt Coroid; dies gilt nur, wenn der Autor Schreibrechte für das Repository besitzt
Von Coroid:
- Ein Task, ein Plan, eine Qualitätsprüfung, ein Deployment oder ein Deployment-Health-Check schlägt fehl
- Ein Deployment ist erfolgreich
- Ein Release wird zurückgerollt
Events aus eigenen Systemen erfordern ein Service-Konto, und Slack-, Telegram- sowie Jira-Events benötigen einen Filter: Ändern Sie den Event einer Automatisierung in ihrem Editor. Siehe Hooks.
Was die Automatisierung tut
Ein Agent folgt Ihren Anweisungen. Er kann den Projektcode lesen und Tasks erstellen, führt aber keine direkten Änderungen vor. Die von ihm erstellte Arbeit durchläuft denselben Prozess aus Spezifikation, Planung, Erstellung, Überprüfung und Rezension wie alle anderen Aufgaben und landet schließlich in einem pull request, den Sie genehmigen.
Nach einem Zeitplan kann eine Automatisierung stattdessen Ihre Browser-Tests gegen eine Testumgebung ausführen.
Die von Coroid für Sie erstellten feststehenden Automatisierungen sind Schalter in der Qualitätskontrolle – nicht etwas, das in „Neue Aufgaben“ erstellt wird:
- Pull Requests überprüfen. Die Qualitätskontrolle Pull Requests führt die Projektchecks bei jedem pull request (Coroid Qualitätskontrolle) aus und enthält dazu einen Coroid-Rezensionskommentar.
- Nachrichten und Issues in Anfragen umwandeln. Slack- und Telegram-Nachrichten, GitHub-Kommentare, die Coroid erwähnen, sowie neue Jira-Issues werden zu Anfragen, sobald deren Quelle in der Qualitätskontrolle unter „Vor Beginn der Arbeit“ aktiviert wird. Siehe Issue-Tracker für Jira.
- Fehler nachverfolgen. Ein fehlgeschlagener Task, ein fehlgeschlagenes Deployment und ein zurückgerolltes Release haben jeweils einen Schalter unter Wenn etwas kaputtgeht.
- Bestehende Schulden bereinigen. Ein Projekt Wöchentliche Schuldenbereinigung ist ein Schalter in seiner Zeile „Anti-Slopp“.
Eine von einem Schalter gesteuerte Automatisierung wird auf ihrer Seite in der Factory als solche gekennzeichnet – mit einem Link zum entsprechenden Schalter. Dort können Sie sie pausieren oder deaktivieren; ändern Sie ihre Anweisungen, wird sie zu Ihrer eigenen Automatisierung – nach Ihrer Bestätigung.
Früher erstellte Automatisierungen, die Anfragen generieren, laufen weiter und sind unter „Automatisierungen“ aufgelistet. Automatisierungen, die Pull Requests überprüften, wurden pausiert, als die Qualitätskontrolle die Coroid-Rezension übernahm.
Vorlagen in „Neue Aufgaben“
„Neue Aufgaben“ bot früher Vorlagen an. Ihre Funktionen wurden auf die oben genannten Schalter übertragen; die beiden Vorlagen, die Nachrichten an Slack sendeten, können nun in eigenen Worten formuliert werden – inklusive Angabe des Kanals. Sie werden über einen MCP-Server gesendet, den Sie in den Einstellungen unter „Verbindungen“ verknüpfen: Ein Zeitplan kann ihn nutzen, und eine Event-Automatisierung ebenfalls, sobald Sie in der Factory im Editor die Nutzung von MCP-Tools erlauben. Automatisierungen, die aus einer Vorlage erstellt wurden, laufen weiter wie bisher. Ein alter Link zu einer Vorlage öffnet den sie ersetzenden Schalter oder „Neue Aufgaben“.
Eine Automatisierung überwachen
Öffnen Sie eine Automatisierung in der Factory, um jeden Lauf zu sehen: wann sie ausgeführt wurde, was sie gekostet hat, welche Aufgaben sie erstellt hat und warum ein Lauf nicht abgeschlossen wurde. Von dort aus können Besitzer und Administratoren sie pausieren, testen, bearbeiten oder löschen. Alle Mitarbeiter des Unternehmens können Automatisierungen und ihre Läufe einsehen.
Automatisierungen nutzbar halten
Die von einer Automatisierung erstellte Arbeit konkurriert um dieselben Agenten-Slots wie alle anderen Aufgaben. Eine häufig ausgelöste Automatisierung kann unbemerkt Ihre Kapazitäten aufbrauchen.
- Weisen Sie ihr eine niedrigere Priorität als der von Menschen angeforderten Arbeit zu.
P2oderP3. - Machen Sie den Auslöser spezifischer. Die Meldung „Ein Prüfschritt ist fehlgeschlagen“ wird bei einem stark frequentierten Repository ständig ausgelöst. Die Meldung „Dieser Prüfschritt ist auf dem Basisbranch fehlgeschlagen“ erscheint erst, wenn tatsächlich ein Problem vorliegt.
- Sehen Sie sich das Ergebnis an. Wenn eine Automatisierung zwanzig Aufgaben erstellt und Sie nur zwei davon zusammenführen, entstehen damit nur unnötiger Aufwand und Rauschen – kein wertschöpfender Effekt.
Der zuverlässige Maßstab für eine Automatisierung ist, wie viel des von ihr erzeugten Arbeitsaufwands tatsächlich zusammengeführt wird – nicht die Häufigkeit ihrer Auslösung.
Sentinel
Frühere Versionen dieser Dokumentation beschrieben Sentinel, einen Überwachungsmechanismus, der auf bestimmte Bedingungen achtet. Es handelt sich dabei nicht um eine eigenständige Funktion. Eine Bedingung ist entweder ein Ereignis, auf das eine Automatisierung reagieren kann, oder etwas, das ein Zeitplan prüft.