Corgea Agent

Übersicht

Corgea Agent ist ein KI-gestützter Assistent, mit dem Sie Schwachstellen in Ihrer Codebasis verwalten können. Er bietet zwei zentrale Interaktionsmöglichkeiten:

Web-Chat-Oberfläche – Ein interaktiver Chat zum Untersuchen von Sicherheitsproblemen, Scans und Schwachstellendaten
Pull-Request-Kommentare – Automatisierte Antworten auf Befehle in PR-Kommentaren bei GitHub, GitLab, Azure DevOps und Bitbucket

Erste Schritte

Voraussetzungen

Bevor Sie Corgea Agent aktivieren, müssen folgende Voraussetzungen erfüllt sein:

Aktives Corgea-Konto mit einem entsprechenden Tarif
Mindestens eine konfigurierte Integration (GitHub, GitLab, Azure DevOps oder Bitbucket)
Webhook-Ereignisse korrekt für Ihr Repository konfiguriert

Erste Einrichtung

Corgea-Agent aktivieren

Öffnen Sie in Ihrem Corgea-Dashboard Einstellungen > Agent-Einstellungen und aktivieren Sie die Option “Corgea-Agent aktivieren”. Anschließend überwacht der Agent PR-Kommentare und steht im Chat zur Verfügung.

Agenteneinstellungen im Corgea-Dashboard

Berechtigungen überprüfen

Stellen Sie sicher, dass Ihre Corgea-Integration über die erforderlichen Berechtigungen verfügt:

Pull-Request-Kommentare lesen
Pull Requests kommentieren
Auf Repository-Inhalte zugreifen

Überprüfen Sie Ihre Integrationseinstellungen, um sicherzustellen, dass Webhooks aktiv sind.

Verbindung testen

Erstellen Sie einen Test-PR mit einem Sicherheitsproblem
Antworten Sie bei einer beliebigen Schwachstelle im PR mit hello, um die Reaktion des Agenten zu prüfen
Öffnen Sie den Web-Chat und stellen Sie eine Frage zu Ihren Scans

Web-Chat-Oberfläche

Zugriff auf den Chat

Öffnen Sie im Corgea-Dashboard den Bereich Chat, um den interaktiven KI-Assistenten zu verwenden.

Was Sie tun können

Corgea Agent kennt den Sicherheitsstatus Ihrer Systeme im Detail und unterstützt Sie bei folgenden Aufgaben:

Sicherheitsprobleme untersuchen

Detaillierte Informationen zu spezifischen Schwachstellen erhalten, Schweregrade verstehen und Vorschläge zur Behebung prüfen

Scans analysieren

Scan-Ergebnisse und Zusammenfassungen prüfen, Scans im Zeitverlauf vergleichen und die Scan-Abdeckung verstehen

Schwachstellendaten abfragen

Probleme nach Schweregrad, Projekt oder Typ auflisten und Blocking Rules sowie Richtlinienverstöße prüfen

Beispielabfragen

Example Chat Queries

"Show me all critical issues in my latest scan"
"What are the details for issue abc-123?"
"List all SQL injection vulnerabilities in project XYZ"
"Explain the security implications of CVE-2024-12345"
"What blocking rules are currently active?"

Beispiel für eine Chat-Sitzung mit dem Corgea-Agent

Formulieren Sie Ihre Abfragen möglichst konkret. Geben Sie Issue-IDs, Scan-IDs oder Projektnamen direkt an, um präzisere Antworten zu erhalten.

Interaktionen in Pull Requests

So funktioniert es

Wenn Corgea Sicherheitsprobleme in einem Pull Request erkennt, führt der Agent automatisch folgende Aktionen aus:

Veröffentlicht Kommentare zu den Schwachstellen
Überwacht den PR auf Entwicklerantworten
Leitet aus den Kommentaren die Absicht der Entwickler ab
Führt anhand der Befehle automatisierte Aktionen aus

Auslösen des Agenten

Der Agent reagiert auf Kommentare, die:

@Corgea ausdrücklich erwähnen
Direkt auf Corgeas Problemkommentar antworten
Erkennbare Aktionsbefehle enthalten
Auf Sicherheitsbefunde abzielen

Sie müssen @Corgea nicht verwenden, da der Agent auch auf Antworten zu seinen eigenen Kommentaren reagiert.

Unterstützte Aktionen

Als False Positive markieren

Kennzeichnen Sie einen gemeldeten Befund als tatsächlichen Fehlalarm.Beispielkommentare:

@Corgea false positive
This is not a real issue, it's a false positive
@Corgea this is safe code

Was passiert:

Problem wird als “False Positive” markiert
Der Befund blockiert den Pull Request nicht mehr
Feedback wird zur Analyse erfasst

Als akzeptiertes Risiko markieren

Eine echte Schwachstelle anerkennen, aber das Risiko ohne sofortige Behebung akzeptieren.Beispielkommentare:

@Corgea accept risk
We accept this risk for now
@Corgea low priority, won't fix
This is acceptable for our use case

Was passiert:

Status des Problems ändert sich zu “Akzeptiertes Risiko”
Problem blockiert PR nicht mehr
Die Risikoakzeptanz wird protokolliert

Als behoben markieren

Bestätigen, dass eine Schwachstelle behoben wurde.Beispielkommentare:

@Corgea fixed
Already fixed this in the latest commit
@Corgea this is resolved

Was passiert:

Status des Problems ändert sich zu “Behoben”
Problem erscheint nicht mehr in den aktiven Befunden
Die Bestätigung der Behebung wird protokolliert

Als Duplikat markieren

Ein Problem als Duplikat eines bestehenden Befunds kennzeichnen.Beispielkommentare:

@Corgea duplicate
This is a duplicate of issue XYZ
Same as #456

Was passiert:

Problem wird als Duplikat markiert
Wird mit dem ursprünglichen Issue verknüpft (falls angegeben)
Wird nicht mehr als aktiver Befund gezählt

Als in Arbeit markieren

Geben Sie an, dass die Behebung des Issues bereits läuft.Beispielkommentare:

@Corgea fix in progress
Working on this now
We're fixing this in the next commit

Was passiert:

Der Status des Problems ändert sich zu “Behebung in Bearbeitung”
Wird als aktiv in Bearbeitung geführt
Das Team kann den Fortschritt überwachen

Mehr Informationen anfordern

Bitten Sie Corgea um zusätzliche Details zu einer Schwachstelle.Beispielkommentare:

@Corgea explain this issue
What's the security impact here?
Can you provide more context?

Was passiert:

Der Agent gibt eine detaillierte Erklärung
Enthält Kontext zur Schwachstelle und Hinweise zur Behebung
Kann verwandte Ressourcen vorschlagen

Beispiele für Interaktionen in Kommentaren

False Positive
Akzeptiertes Risiko
Kontext anfordern

Szenario: Ein Entwickler hält den Befund für einen False Positive

PR Comment

This input is already sanitized in the middleware layer, false positive

Antwort des Agenten:

✅ Marked as False Positive
This issue has been marked as a false positive based on your feedback.
The issue will no longer block this PR.

Szenario: Risikoakzeptanz für Legacy-Code

PR Comment

This is legacy code we're deprecating next quarter. Accept the risk

Antwort des Agenten:

⚠️ Marked as Accepted Risk
This issue has been acknowledged as an accepted risk.
It will no longer block this PR, but will remain in your security dashboard for tracking.

Szenario: Ein Entwickler benötigt weitere Erläuterungen

PR Comment

Can you explain why this is considered an SQL injection vulnerability?

Antwort des Agenten:

[Detailed explanation of the SQL injection risk,
code examples, and suggested remediation approaches]

Feedback-Verlauf

Im Abschnitt Feedback-Verlauf sehen Sie alle Interaktionen über PR-Kommentare:

Alle über PR-Kommentare ausgeführten Aktionen anzeigen
Einen Eintrag öffnen und ursprünglichen Kommentar, KI-Begründung und Agentenantwort gemeinsam anzeigen
Nach Aktionstyp, Benutzer oder Zeitraum filtern
Nachverfolgen, wie Ihr Team mit Sicherheitsbefunden umgeht

Verfügbare Filter:

Aktionstyp (False Positive, akzeptiertes Risiko, behoben usw.)
Benutzer von GitHub, GitLab oder Azure DevOps
Zeitraum

Unterstützte Plattformen

Corgea Agent funktioniert nahtlos auf mehreren Entwicklungsplattformen:

GitHub
GitLab
Azure DevOps
Bitbucket

Pull-Request-Kommentare
Issue-Kommentare
Review-Threads

Erfordert: GitHub-App-Installation mit den entsprechenden Berechtigungen

Fehlerbehebung

Agent reagiert nicht auf PR-Kommentare

Überprüfung:

Ist der Agent in Einstellungen > Agent-Einstellungen aktiviert?
Sind Webhooks für Ihr Repository korrekt konfiguriert?
Haben Sie @Corgea erwähnt oder auf einen Agentenkommentar geantwortet?
Ist Ihre Integration aktiv und ordnungsgemäß authentifiziert?

Lösung:

Überprüfen Sie die Webhook-Zustellung in den Webhook-Einstellungen Ihrer Plattform
Überprüfen Sie den Integrationsstatus im Corgea-Dashboard
Erneut authentifizieren, falls erforderlich

Aktion nicht auf das Issue angewendet

Überprüfung:

Gibt Ihr Kommentar klar die beabsichtigte Aktion an?
Kommentieren Sie das richtige Issue?
Haben Sie die Berechtigung, Issues zu ändern?

Lösung:

Verwenden Sie eindeutige Befehle wie “@Corgea false positive”
Prüfen Sie im Feedback-Verlauf, wie Ihr Kommentar interpretiert wurde

Chat lädt nicht oder reagiert nicht

Überprüfung:

Browser-Konsole auf JavaScript-Fehler
Netzwerkverbindung
Kontoberechtigungen

Lösung:

Seite aktualisieren
Browser-Cache leeren
Support kontaktieren, falls das Problem weiterhin besteht

Best Practices

PR-Kommentare
Web-Chat

Eine Aktion pro Kommentar: Beschränken Sie jeden Kommentar auf eine einzelne Aktion

Kontext bereitstellen: Fügen Sie Begründungen hinzu, um dem Team zu helfen, Ihre Entscheidung zu verstehen

Feedback-Verlauf prüfen: Kontrollieren Sie regelmäßig, wie Ihre Anweisungen interpretiert werden

Datenschutz & Sicherheit

Alle Chat-Interaktionen sind auf die Daten Ihres Unternehmens beschränkt. Der Agent greift nur auf Informationen zu, für die Ihr Benutzerkonto Berechtigungen hat.

Aktionen aus PR-Kommentaren werden protokolliert und sind im Feedback-Verlauf nachvollziehbar
Agentenantworten geben niemals sensible Zugangsdaten oder interne Implementierungsdetails preis
Daten werden gemäß den Sicherheitsstandards von Corgea verarbeitet

Support

Brauchen Sie Hilfe mit dem Corgea Agent? Kontaktieren Sie uns unter support@corgea.com

Erste Schritte

Kernfunktionen

Integrationen

Werkzeuge & Hilfsprogramme

Versionshinweise

Vertrauen & Compliance

Authentifizierung

Übersicht

Erste Schritte

Voraussetzungen

Erste Einrichtung

Web-Chat-Oberfläche

Zugriff auf den Chat

Was Sie tun können

Sicherheitsprobleme untersuchen

Scans analysieren

Schwachstellendaten abfragen

Beispielabfragen

Interaktionen in Pull Requests

So funktioniert es

Auslösen des Agenten

Unterstützte Aktionen

Beispiele für Interaktionen in Kommentaren

Feedback-Verlauf

Unterstützte Plattformen

Fehlerbehebung

Best Practices

Datenschutz & Sicherheit

Support

​Übersicht

​Erste Schritte

​Voraussetzungen

​Erste Einrichtung

​Web-Chat-Oberfläche

​Zugriff auf den Chat

​Was Sie tun können

Sicherheitsprobleme untersuchen

Scans analysieren

Schwachstellendaten abfragen

​Beispielabfragen

​Interaktionen in Pull Requests

​So funktioniert es

​Auslösen des Agenten

​Unterstützte Aktionen

​Beispiele für Interaktionen in Kommentaren

​Feedback-Verlauf

​Unterstützte Plattformen

​Fehlerbehebung

​Best Practices

​Datenschutz & Sicherheit

​Support

Übersicht

Erste Schritte

Voraussetzungen

Erste Einrichtung

Web-Chat-Oberfläche

Zugriff auf den Chat

Was Sie tun können

Beispielabfragen

Interaktionen in Pull Requests

So funktioniert es

Auslösen des Agenten

Unterstützte Aktionen

Beispiele für Interaktionen in Kommentaren

Feedback-Verlauf

Unterstützte Plattformen

Fehlerbehebung

Best Practices

Datenschutz & Sicherheit

Support