KI-Agent zur Analyse von CI/CD-Fehlern in n8n

Automatisierte Analyse fehlgeschlagener CI/CD-Pipelines mit einem KI-Agenten

KI-Agenten beschleunigen die Root-Cause-Analyse bei fehlgeschlagenen Jobs in CI/CD-Pipelines erheblich. Ein auf n8n basierendes System reagiert auf Fehler bei Build-Events, sammelt Logs, Pipeline-Konfigurationen und erstellt einen Bericht mit wahrscheinlichen Ursachen und Lösungsschritten. Die Analyse dauert etwa 30 Sekunden und verbraucht einige tausend Token.

Vorbereitung der Architektur

Definieren Sie vor der Implementierung Schlüsselparameter:

• Auslösende Events: Fehlgeschlagene Jobs in GitLab CI/CD.
• Datenquellen: Repositories, vollständige Logs, Agenten-Ressourcenmetriken, Verfügbarkeit der Endpunkte.
• Analyse: Klassifizierung nach Job-Typ (Build, Tests, Deploy).
• Berichtsformat: Prägnanter Text für den Chat mit Fakten, Ursachen und Aktionen.

Bei Builds prüfen Sie Abhängigkeiten, Code und Ressourcen. Bei Tests suchen Sie nach Fehlern im Code und in Test-Suites. Bei Deploys überprüfen Sie Manifeste und Plattformstatus. Häufige Fehlerquellen sind Pipeline-Probleme, Agenten-Dienste und Initialisierungsfehler.

Verarbeitungsfluss für Events

Ein Webhook von GitLab löst n8n aus. Ein Filter lässt nur fehlgeschlagene Events durch. Die Datensammlung umfasst die letzten 50 Zeilen der Logs, .gitlab-ci.yml und Pipeline-/Job-Details.

Daten werden in ein JSON-Array formatiert:

[
  {"job_log": "Letzte 50 Zeilen des fehlgeschlagenen Jobs"},
  {"data": "Inhalt .gitlab-ci.yml"},
  {"pipeline": {}},
  {"failed_job": {}}
]

Der KI-Agent analysiert mithilfe eines System-Prompts und MCP-Tools. Es gibt kein Gedächtnis – jedes Event ist unabhängig.

Agenten-Tools

• Gitlab-mcp: Job-Details, Code-Änderungen.
• Grafana-mcp: Agenten-Metriken, Deploy-Logs.
• Http-request: Endpoint-Verifizierung.

MCP-Server arbeiten im Remote-Modus, Transport via Streaming-HTTP. Für Nicht-Remote-Setups verwenden Sie mcpgateway.

Implementierung in n8n

Konfigurieren Sie den Webhook mit X-Gitlab-Token. In GitLab: Stellen Sie Pipeline-Events auf die Webhook-URL ein. Ein 'If'-Node filtert Erfolgszustände heraus. Anfragen an die GitLab-API verwenden einen Read-Only-Token. Ein Merge-Node kombiniert die Daten.

Der Agent erhält einen Prompt mit Eingabeformat, Tools, Untersuchungsanweisungen und Ausgabeformat. Empfohlene Modelle sind die neuesten Versionen mit MCP-Unterstützung.

Letzter Schritt: Senden Sie den Bericht an einen Slack-Channel oder Thread.

Diagnosebeispiele

Gradle Dependency Resolution:

Der Agent unterscheidet dies von Kompilierungsproblemen: Artifact nicht veröffentlicht, Credentials im Docker-Kontext fehlen. Schritte: Repository prüfen, Credentials, Mirrors.

Terraform Plan Error:

Nicht unterstütztes Argument in HCL. Ursachen: falsche Ressource, DigitalOcean Provider-Version, veraltetes Schema. Schritte: Provider aktualisieren, Dokumentation prüfen, validieren.

Wichtige Erkenntnisse

• 30-Sekunden-Analyse eliminiert Routinearbeit.
• Verwenden Sie Read-Only-Zugriff für Sicherheit.
• Aktuelle Modelle gewährleisten genaue MCP-Performance.
• Testen Sie an echten Workflows.
• Skalieren Sie auf Repository-Gruppen.

— Editorial Team