Zum Hauptinhalt springen

Hilfe erhalten

Wenn etwas nicht wie erwartet funktioniert, bietet msg.ZenTestAI Ihnen Werkzeuge, um das Problem selbst zu untersuchen und den relevanten Kontext mit einem Klick an das Support-Team zu übermitteln. Diese Seite behandelt beides – den Self-Service-Triage-Prozess und den Support-Bundle-Workflow.

Kanäle​

Der offizielle Support-Kanal ist per E-Mail erreichbar:

Sie können auch das Feedback-Formular unten links in der Anwendung nutzen, um schnell eine Notiz direkt aus dem Produkt heraus zu senden. Das Feedback-Formular ist der schnellste Weg für kurze Beobachtungen; E-Mail ist der richtige Kanal für alles, was einen längeren Austausch oder Anhänge erfordert.

Bevor Sie den Support kontaktieren​

Überraschend viele Meldungen über „der Test ist kaputt“ stellen sich als veralteter Cache, mehrdeutige Schrittbeschreibung oder ein tatsächlicher Anwendungsfehler heraus. Bevor Sie ein Ticket eröffnen, gehen Sie die Checkliste zur Triage bei fehlgeschlagenen Ausführungen durch:

  1. Lesen Sie das Ergebnis und die Erklärung im Popover des fehlgeschlagenen Schritts.
  2. Überprüfen Sie den Reiter Warnungen, falls vorhanden.
  3. Öffnen Sie das Protokoll und scrollen Sie zum fehlgeschlagenen Schritt.
  4. Entscheiden Sie, ob das Problem Cache, Beschreibung, Selektor oder ein echter Anwendungsfehler ist.

Wenn Sie danach immer noch Hilfe benötigen, erstellen Sie ein Support-Bundle, wie unten beschrieben — dies verkürzt die Untersuchungszeit des Support-Teams erheblich und führt meist dazu, dass Sie eine Antwort eine Austauschrunde früher erhalten.

Unterstützungsinformationen sammeln​

Der empfohlene Weg, um Kontext mit einem Ticket zu senden, ist der Support-Bundle-Workflow:

  1. Öffnen Sie die Detailseite der fehlgeschlagenen Ausführung.
  2. Klicken Sie auf die Schaltfläche Protokoll in der Symbolleiste.
  3. Klicken Sie in der Symbolleiste des Protokoll-Popovers auf Support-Informationen sammeln (Symbol mit dem Käfer).
  4. Der Dialog fragt, welche Kategorien von zusätzlichen Daten erfasst werden sollen – siehe Kategorien zusätzlicher Daten unten. Wählen Sie das Relevante aus und bestätigen Sie.
  5. Die Plattform führt den Test im ausführlichen Modus (Verbose Mode) erneut aus. Dies kann einige Minuten dauern, insbesondere wenn Sie HTML-Inhalte oder Speicher-Snapshots ausgewählt haben.
  6. Wenn die ausführliche erneute Ausführung abgeschlossen ist (bestanden oder fehlgeschlagen), ersetzt die Schaltfläche Support-Informationen herunterladen die „Sammeln“-Schaltfläche in der Symbolleiste des Protokoll-Popovers. Klicken Sie darauf, um ein ZIP-Bundle herunterzuladen.
  7. Hängen Sie die ZIP-Datei an Ihre E-Mail an (oder laden Sie sie in Ihren gemeinsamen Support-Ordner hoch, falls die Dateigröße ein Problem darstellt).
tipp

Starten Sie die ausführliche erneute Ausführung so schnell wie möglich nach einem Fehler. Lange Verzögerungen zwischen dem ursprünglichen Fehler und der erneuten Ausführung verringern die Wahrscheinlichkeit, dass dasselbe Problem reproduzierbar ist. Anwendungsstatus, Testdaten und externe Abhängigkeiten verändern sich mit der Zeit.

hinweis

Die Schaltfläche Support-Informationen sammeln ist nur sichtbar, wenn für den Mandanten Detaillierte Serviceanfragen aktiviert sind und der Administrator Ihnen Zugriff gewährt hat. Wenn Sie diese nicht sehen, bitten Sie Ihren Mandanten-Administrator, dies unter Mandanteneinstellungen zu aktivieren.

Kategorien zusätzlicher Daten​

Wenn Sie eine ausführliche erneute Ausführung starten, können Sie vier Kategorien zusätzlicher Daten auswählen:

  • KI-Kommunikation — jeder Prompt, der an ein KI-Modell gesendet wurde, und jede empfangene Antwort. Fast immer nützlich — die meisten „Warum hat die KI das getan?“-Fragen werden durch das Lesen der tatsächlichen Prompt-Antwort-Paare beantwortet.
  • HTTP-Kommunikation — jede Netzwerkanfrage, die der Browser gestellt hat, mit Anfrage-URL, Methode, Headern, Status und Antwortkörper. Nützlich, wenn der Fehler eher anwendungsseitig als KI-seitig aussieht.
  • HTML-Inhalt — vollständige HTML-Snapshots der Seite bei jedem Schritt. Nützlich, wenn ein Element nicht gefunden wurde und Sie nachweisen möchten, ob es tatsächlich im DOM vorhanden war.
  • Speicher-Snapshot — Laufzeit-Speicherzustand des Runner-Prozesses. Nützlich zur Diagnose von exzessivem Speicherverbrauch oder Speicherlecks.

Die Auswahl weiterer Kategorien erzeugt ein größeres Bundle und eine längere Ausführungsdauer. Wenn Sie unsicher sind, ist KI-Kommunikation + HTML-Inhalt das nützlichste Paar für die tägliche Triage bei fehlgeschlagenen Schritten.

Was das Bundle enthält​

Ein Support-Bundle ist eine einzelne ZIP-Datei, die immer Folgendes enthält:

  • Die Testfalldefinition (aktuelle Version).
  • Das Testausführungsprotokoll mit allen aufgelösten Schrittbeschreibungen.
  • Die KI-Analyse (Ergebnis + Erklärung) jedes Schritts.
  • Alle Protokolle aus der ausführlichen erneuten Ausführung.

Je nach Mandantenrichtlinie und den Kategorien, die Sie beim Starten der erneuten Ausführung ausgewählt haben, enthält das Bundle zusätzlich:

  • Die Mandanteneinstellungen (bereinigt).
  • Die Konfiguration der Anwendung.
  • Die erfassten KI-Kommunikations-Protokolle.
  • Die erfassten HTTP (API)-Kommunikationsprotokolle.
  • Den erfassten HTML-Inhalt der getesteten Seite.
  • Den Speicher-Snapshot des Runners.

Was nicht im Bundle enthalten ist​

  • Geheimnisse. Passwörter, API-Schlüssel, OAuth-Token, Werte von Feldern, die in Ihren Testparametern explizit als geheim markiert sind — nichts davon ist enthalten. Die Plattform entfernt diese, bevor das Bundle erstellt wird.
  • Alles aus anderen Tests oder Ausführungen. Das Bundle ist auf die eine Ausführung beschränkt, von der aus Sie es gestartet haben.
  • Die ursprüngliche (nicht ausführliche) Ausführung. Nur die ausführliche erneute Ausführung wird erfasst.

Verschlüsselung und sensible Daten​

KI-Kommunikation und HTTP-Kommunikation können sensible Informationen über die getestete Anwendung enthalten — Seiteninhalte, Benutzerdaten, Geschäftsunterlagen —, auch wenn keine Geheimnisse enthalten sind. Diese beiden Protokolle werden daher mit msg-interner Public-Key-Verschlüsselung verschlüsselt, bevor sie in das Bundle geschrieben werden. Nur das msg-Support-Team kann diese entschlüsseln.

Das bedeutet:

  • Sie können ein Support-Bundle sicher an eine normale E-Mail anhängen, ohne befürchten zu müssen, dass Zwischensysteme die sensiblen Teile lesen könnten.
  • Sie selbst können die verschlüsselten Protokolldateien im Bundle nicht lesen — sie sind für den Support bestimmt.
  • Bundles können daher sicher archiviert oder intern zur Aufbewahrung geteilt werden, ohne Anwendungsdaten preiszugeben.

Was im Ticket selbst enthalten sein sollte​

Auch mit einem angehängten Support-Bundle hilft eine kurze schriftliche Beschreibung dem Support, das Ticket zuzuordnen und zu priorisieren:

  • Was wollten Sie tun? („Einen Test für die Bestellseite aufzeichnen.“)
  • Was ist passiert, was Sie nicht erwartet hatten? („Schritt 7 schlägt mit 'Element nicht gefunden' fehl, aber die Schaltfläche ist im Screenshot deutlich sichtbar.“)
  • Was haben Sie bereits versucht? („Cache für den Schritt geleert, die Beschreibung neu geschrieben, beides hat nicht geholfen.“)
  • Ein Link zur Ausführung. Kopieren Sie die URL der Detailseite; das Plattform-Team kann diese direkt öffnen und den Fehler reproduzieren.

Die ersten drei Punkte entsprechen grob „erwartet“, „tatsächlich“ und „versucht“ — dem universellen Trio jedes Fehlerberichts.

Häufige Themen, bei denen der Support helfen kann​

  • Verständnis eines Testfehlers — das Bundle + ein Ticket reicht dem Team meist aus, um zu erklären, ob es ein Cache-Problem, ein Prompt-Problem oder ein echter Anwendungsfehler war.
  • Bereitstellung eines neuen KI-Modells oder Anbieters — siehe KI-Modelle für die Liste der unterstützten Modelle; für alles, was nicht auf dieser Liste steht, kontaktieren Sie uns unter hello@zentest.ai.
  • Richtlinien auf Mandantenebene — Limits für parallele Ausführungen, Opt-in für detaillierte Serviceanfragen, BYOK-Schlüsselrotation, E-Mail-Benachrichtigungen.
  • Connectoren für externe Systeme — Jira XRay / Zephyr Token-Probleme, Status-Mapping funktioniert nicht wie erwartet, Synchronisationsfehler (siehe Externe Systeme).
  • Pipeline-Integration — die REST-API der Plattform für CI/CD-Nutzung (Pipeline-Integration).

Self-Service-Referenzen​

Viele „Support“-Fragen werden bereits in der Dokumentation beantwortet. Häufige Anlaufstellen: