Dokumentation

Hooks

Automatisierungen auf Organisationsebene, die auf Plattformereignisse mit von Ihnen verfassten Anweisungen reagieren.

Eine Automatisierung reagiert auf Vorgänge in Coroid. Sie wählen ein Ereignis aus, verfassen die Anweisungen in einfacher Sprache, und die Automatisierung wird ausgelöst, sobald das Ereignis eintritt.

Sie finden sie unter Einstellungen → Automatisierung → Automatisierungen.

Ereignisse, auf die reagiert werden kann

KategorieBeispiele
AufgabeErstellt, Status geändert, Phase geändert, abgeschlossen, fehlgeschlagen
AgentGestartet, Iteration, Tool aufgerufen, abgeschlossen, Fehler
RepositoryCommit gepusht, Branch erstellt, pull request geöffnet, pull request zusammengeführt
AnalyseAbhängigkeit gefunden, Sicherheitsproblem entdeckt, Analyse abgeschlossen
SynchronisationExterne Quelle aktualisiert
DeploymentGestartet, abgeschlossen, fehlgeschlagen

Standardmäßig nur lesend.

Automatisierungen analysieren und berichten. Sie können nachfolgende Arbeiten initiieren; sie ändern Ihren Code jedoch nicht direkt.

Diese Standardeinstellung macht ihre Nutzung sicher. Eine Automatisierung, die bei einem Ereignis den Code bearbeitet, greift zu einem Zeitpunkt zu, zu dem kaum Aufsicht vorhanden ist. Eine Automatisierung, die eine Aufgabe öffnet liefert dasselbe Ergebnis über den regulären Weg – Spezifikation, Planung, Überprüfung, Review, pull request.

Gute Anweisungen verfassen

Die Anweisungen für Automatisierungen werden von einem Modell verarbeitet, sodass sie wie Hinweise an einen Kollegen klingen – nicht wie Code. Die Qualitätsanforderungen entsprechen denen einer Spezifikation: beschreiben Sie, worauf zu achten ist, was von Bedeutung ist und was zu tun ist.

Seien Sie beim Fall „nichts tun“ spezifisch. Ohne diese Angabe würde eine Automatisierung jedes Mal etwas melden – und Automatisierungen, die ständig ausgelöst werden, werden von den Nutzern ignoriert.

Sicherheitsvorkehrungen

Es gibt drei Schutzmechanismen, weil ereignisgesteuerte Automatisierungen vorhersehbare Fehler aufweisen:

Auslösebeschränkungen. Pro Minute, Stunde und Tag konfigurierbar pro Automatisierung. Eine Automatisierung bei einem häufig auftretenden Ereignis könnte sonst während eines intensiven Merge-Vorgangs hunderte Male ausgelöst werden.

Kettentiefe. Automatisierungen können Ereignisse auslösen, die wiederum weitere Automatisierungen auslösen. Eine maximale Kettentiefe verhindert eine Endlosschleife.

Tool-Berechtigungen. Was eine Automatisierung erreichen darf, ist kontrolliert – lesender Zugriff, MCP-Aufrufe und das Erstellen von Aufgaben werden separat geregelt.

Berechtigungen

Die Verwaltung von Automatisierungen ist nur für Administratoren möglich; alle Mitglieder können Automatisierungen sowie ihren Ausführungsverlauf einsehen. Da eine Automatisierung organisationsweite Reichweite hat, ist diese Asymmetrie beabsichtigt.

Sie beobachten

Jede Automatisierung führt ein Versandprotokoll und Analysedaten. Überprüfen Sie das Protokoll nach der Aktivierung einer neuen Automatisierung – der Fehlerfall besteht nicht in einem Fehler, sondern darin, dass sie ständig ausgelöst wird, ohne dass jemand darauf reagiert.

Automatisierungen, Zeitpläne und Sentinel

MechanismusAusgelöst durch
AutomatisierungEin Plattformereignis
ZeitplanZeit
SentinelEine beobachtete Bedingung