KI-Analyst einrichten (Pro)

Der KI-Analyst ist eine Pro-Funktion: In einem geplanten Lauf liest ein Sprachmodell (LLM) die verdichteten Zugriffsmuster deines Shops und bewertet, welche Netz-Segmente gesperrt werden sollten. Dabei sieht es auch seine eigenen früheren Einschätzungen zum selben Netz und den kurzfristigen Anfrageverlauf — so erkennt es gleichmäßig langsame Dauer-Zugriffe zuverlässiger, die in einer Momentaufnahme unauffällig wirken. Du richtest ihn in der Plugin-Konfiguration auf der Karte LLM-Analyst · Pro ein und aktivierst ihn mit LLM-Analyst aktivieren (Standard: aus). Alle Änderungen auf dieser Karte wirken beim nächsten Lauf. Enthält dein Tarif den KI-Analysten nicht, ist die Karte gesperrt.

Lauf-Intervall: Der Standard-Takt ist stündlich — das begrenzt die Anbieterkosten deutlich. Für schnellere Reaktion senkst du das Intervall über die Standard-Aufgabenplanung von Shopware (Einstellungen → System → Geplante Aufgaben); ein selbst gewähltes Intervall bleibt bei Plugin-Updates erhalten. Kam dein Shop von einer älteren Version, bei der du das Intervall nie verändert hattest, übernimmt die Aktualisierung den neuen Standard automatisch.

Anbieter anbinden

• Anbieter — OpenAI-kompatibel (inklusive eines lokalen Ollama) oder Anthropic.
• Basis-URL des Endpunkts — z. B. https://api.openai.com/v1, http://localhost:11434/v1 für ein lokales Ollama oder https://api.anthropic.com.
• Modell — der Modellname deines Anbieters.
• API-Schlüssel — bei einem schlüssellosen lokalen Endpunkt (Ollama) optional, bei Anthropic erforderlich.

Mit Verbindung testen prüfst du direkt in der Konfiguration, ob URL, Schlüssel und Modell erreichbar sind. Ist der KI-Analyst nicht in deinem Tarif enthalten, meldet der Test, dass der LLM-Analyst nicht in deinem Tarif enthalten ist.

Steuerung und Grenzen

• Konfidenz-Schwellwert für automatische Anwendung (Standard 90): Funde mit dieser Konfidenz oder höher wendet das Plugin sofort an — als automatische Bereichssperre mit der eingestellten Sperrdauer. Funde darunter landen als Vorschlag auf der Übersicht und warten auf deine Entscheidung — ein Vorschlag bleibt 24 Stunden gültig und verschwindet danach aus der Übersicht. Stellst du 100 ein, wird nichts mehr automatisch gesperrt.
• Max. Netz-Aggregate pro Lauf (Standard 50): Begrenzt, wie viele Netz-Aggregate pro Lauf an deinen Anbieter gesendet werden — die Aggregate mit dem höchsten Anfragevolumen gehen vor, der Rest wird für diesen Lauf übersprungen. Das Protokoll hält das als LLM-Analyst: auf stärkste Netze begrenzt fest. Werte von 0 oder darunter fallen auf 50 zurück.
• Zeitlimit für Anfragen (Standard 120 Sekunden): Halte diesen Wert unter dem Zeitlimit deines PHP-/Message-Consumer-Prozesses, sonst wird der Lauf hart abgebrochen. Werte von 0 oder darunter fallen auf den Standard zurück.

Die Schutzstufe des Flotten-Schutzes erfasst den KI-Analysten nicht: Er handelt eigenständig nach seinem Konfidenz-Schwellwert, unabhängig von dieser Stufe.

Schutz vor zu breiten Sperren

Damit automatische Sperren keine echten Kunden treffen, gelten drei Schutzregeln:

• Bereiche, die auf deiner Freigabeliste stehen, werden grundsätzlich nie automatisch gesperrt.
• Bei aktiver Netzwerktyp-Unterscheidung (Standard) legt der Analyst automatische Bereichssperren nur für Rechenzentrums- und Hosting-Netze an — Verbraucher- und Mobilfunknetze werden nicht großflächig als /24 gesperrt. Übersprungene Sperren werden im Protokoll festgehalten.
• Ein Fund über dem Konfidenz-Schwellwert, bei dem keine einzige Signatur ausgelöst hat, wird verworfen und protokolliert („Sperre gehalten (keine Signatur)“), statt gesperrt oder vorgeschlagen zu werden.

Gibst du einen Vorschlag auf der Übersicht manuell frei, ist das deine bewusste Entscheidung: Die Sperre wird dann auch angelegt, wenn der Bereich nicht als Rechenzentrumsnetz erkannt ist — die Rückmeldung zeigt dir an, was gesperrt und was übersprungen wurde. Bereiche auf deiner Freigabeliste sperrt auch eine manuelle Freigabe nie. Lässt sich ein Vorschlag nicht mehr anwenden (etwa weil er älter als 24 Stunden ist), erscheint eine Fehlermeldung und die Liste aktualisiert sich. Die Freigabe von Vorschlägen steht nur in einem Tarif zur Verfügung, der die Funktion enthält.

Was im Protokoll steht

Das Protokoll zeigt, was der KI-Analyst getan hat: eine gesetzte Sperre (mit der Zuversicht des Urteils und dem Hinweis, ob scharf geschaltet oder nur beobachtet wurde), einen erstellten Vorschlag, eine durch eine Schutzregel verhinderte Sperre und die Begrenzung auf die stärksten Netze. Der Befehl php bin/console coe:bot-shield:config:doctor zählt außerdem, wie viele Funde oberhalb des Konfidenz-Schwellwerts von den Schutzregeln zurückgehalten wurden — getrennt nach „kein Rechenzentrumsnetz“ und „keine Signatur ausgelöst“ —, und wie viele Sperren der Analyst gesetzt hat. So siehst du ohne Datenbankzugriff, ob er überhaupt zum Sperren kommt.

Datenschutz

Der KI-Analyst übermittelt keine IP- und keine Netz-Adressen an deinen Anbieter. Er sendet nur pseudonymisierte Kürzel (z. B. net-…) zusammen mit dem Verhaltensprofil (Anfragehäufigkeit, User-Agent-Vielfalt, ausgelöste Signaturen, Status-Code-Verteilung, Zeitverlauf). Die Zuordnung eines Kürzels zur Adresse geschieht ausschließlich in deinem Shop — vorgeschlagene und automatische Sperren funktionieren unverändert. Je nach Rechtslage und Anbieter kann trotzdem ein Auftragsverarbeitungsvertrag (AV) erforderlich sein, weil Verhaltensdaten deiner Besucher übermittelt werden. Ein vollständig lokaler Betrieb mit Ollama vermeidet die Übermittlung an Dritte vollständig.

Benachrichtigungen bei neuen Vorschlägen

Sobald der Analyst einen neuen Vorschlag erstellt, löst das Plugin ein Ereignis aus, das du im Flow Builder mit einer Aktion verknüpfst — etwa einer E-Mail an dich. Lege dafür einen Flow mit dem Trigger botshield.finding.pending an; das Ereignis liefert Netz-Kennung, Konfidenz, Kategorie und Begründung des Vorschlags mit. Gibt es offene Vorschläge, aber keinen Flow auf dieses Ereignis, weist dich php bin/console coe:bot-shield:config:doctor darauf hin. Vorschläge der Clean-Flotten-Erkennung lösen das Ereignis nicht aus; du findest sie nur in der Übersicht.