Dokumentation · Admin-Referenz

Support-Referenz

Dieses Dokument ist eine Referenz für den Support-Bildschirm des ADP Car Market Hub-Plugins (Car Market Hub → Support). Es behandelt den KI-Support-Assistenten, das Kontakt-Eskalationsformular, die Dokumentationslinks und die Steuerung der lokalen Wissensdatenbank.

Wann dieses Dokument zu verwenden ist

Lesen Sie dies, wenn Sie Folgendes tun müssen:

Eine Frage zum Plugin stellen und eine Antwort erhalten möchten, die auf der offiziellen Wissensdatenbank basiert.
Ein strukturiertes Support-Ticket eröffnen möchten, wenn der Assistent das Problem nicht lösen kann.
Die offiziellen Dokumentationsabschnitte und das vollständige Dokumentations-Repository finden möchten.
Den lokalen KI-Wissensindex und die zwischengespeicherte externe Dokumentation verwalten möchten.
Antworten auf die am häufigsten gestellten Fragen in den integrierten FAQ nachschlagen möchten.

Übersicht

Der Support-Bildschirm ist die zentrale Anlaufstelle für Hilfe. Eine Reihe von Status- (KPI-) Karten am oberen Rand fasst die Installation auf einen Blick zusammen, gefolgt von den Hauptkarten:

Statuskarten — Plugin-Version, Lizenz (Tarif und Betriebsstatus), Zuletzt aktualisiert, Support-Status (Betriebsbereit, N kürzliche Fehler oder Aufmerksamkeit erforderlich) und Wissensdatenbank (Anzahl der indexierten Einträge).
KI-Support-Assistent — Chat-Schnittstelle, die von einem verwalteten KI-Anbieter unterstützt wird und auf der lokalen Plugin-Wissensdatenbank sowie (optional) der zwischengespeicherten offiziellen Dokumentation basiert.
Kontakt-Eskalation — Strukturiertes Ticket-Formular, das eine E-Mail an das ADP-Support-Team sendet, mit optionalem automatischen Anhang der Systemdiagnose.
Dokumentation & Ressourcen — Links zu den offiziellen Dokumentationsabschnitten und dem vollständigen Dokumentations-Repository.
Wissen & Cache — Zähler und Wartungsschaltflächen für die lokale KI-Wissensdatenbank und den externen Dokumentations-Cache.
Schnelle Fehlerbehebung & FAQ — Kurze, kuratierte Antworten auf die am häufigsten gestellten Fragen.

Anforderungen oder Voraussetzungen

Ein Benutzer mit der Berechtigung zur Verwaltung des Plugins.
Für den KI-Support-Assistenten und den externen Dokumentations-Cache: ausgehender HTTPS-Zugriff vom Webserver.
Für das Kontaktformular: eine funktionierende WordPress-E-Mail-Konfiguration (normalerweise ein SMTP-Plugin oder ein vom Hoster verwalteter Mail-Relay).
Cookies und JavaScript im Admin-Browser aktiviert (der Assistent und das Formular basieren auf AJAX).

Schritt-für-Schritt-Anleitung

Den KI-Support-Assistenten fragen

Öffnen Sie Car Market Hub → Support.
Geben Sie in der Karte KI-Support-Assistent Ihre Frage in eigenen Worten ein.
Klicken Sie auf KI fragen oder drücken Sie Ctrl + Enter (oder Cmd + Enter auf macOS).
Die Antwort wird im Konversationsbereich angezeigt. Wenn sich die Antwort auf Dokumentationsseiten bezieht, wird die Quellenliste darunter angezeigt.

Der Assistent bevorzugt Antworten aus der lokalen Wissensdatenbank und greift bei Bedarf auf die zwischengespeicherte externe Dokumentation zurück. Der aktive Admin-Tab wird als Kontext gesendet, sodass die Antwort auf den Bereich ausgerichtet werden kann, in dem Sie gerade arbeiten. Der Assistent versucht, in Ihrer WordPress-Admin-Sprache zu antworten; wenn Sie in einer anderen Sprache schreiben, folgt er der Sprache Ihrer Nachricht.

Ein Support-Ticket eröffnen

Scrollen Sie zu Kontakt-Eskalation.
Füllen Sie Name, E-Mail, Betreff und Nachricht aus. Name und E-Mail-Adresse werden automatisch aus Ihrem WordPress-Profil vorausgefüllt.
Wählen Sie eine Priorität (Low, Normal (Standard), High, Urgent).
Lassen Sie Systemdiagnose automatisch anhängen aktiviert, wenn das Plugin-Protokoll und die WordPress-debug.log angehängt werden sollen (jeweils auf 2 MB begrenzt).
Klicken Sie auf Ticket senden. Eine Statusmeldung bestätigt das Ergebnis direkt im Formular.

Offizielle Dokumentation öffnen

Verwenden Sie die Karte Dokumentation & Ressourcen, um Folgendes zu öffnen: - Erste Schritte — Erste Schritte und Erstkonfiguration. - Admin-Referenz — Referenz für jeden Admin-Bildschirm. - Fehlerbehebung & FAQ — Antworten auf häufige Probleme und Fragen. - Frontend-Handbuch — Die für Besucher sichtbaren Such-, Listen- und Detailseiten. - Betrieb & Wartung — Täglicher Betrieb, Importe und Pflege. - Checkliste für Support-Informationen — Was Sie vor der Kontaktaufnahme mit dem Support sammeln sollten. - Vollständige Dokumentation — Das vollständige Dokumentations-Repository.

Jeder Link öffnet sich in einem neuen Browser-Tab.

KI-Wissensdatenbank und Dokumentations-Cache pflegen

Überprüfen Sie in der Karte Wissen & Cache die Zähler: - Lokale KB-Einträge — Anzahl der lokal indexierten Wissenseinträge. - Indexierte Q&A-Paare — Anzahl der Q&A-Paare, mit denen der Assistent abgeglichen werden kann. - Zwischengespeicherte Dokumente — cached / total lokal gespeicherte externe Dokumentationsseiten.
Verwenden Sie die Schaltflächen: - KI-Wissensindex neu aufbauen — Baut den lokalen Wissensindex aus den Quelldateien neu auf. - Dokumentations-Cache aktualisieren — Lädt die externen Dokumentationsseiten erneut herunter. - Dokumentations-Cache löschen — Entfernt die zwischengespeicherte externe Dokumentation. Unwiderruflich.

Die FAQ verwenden

Öffnen Sie Quick Troubleshooting & FAQ am unteren Rand des Bildschirms.
Klicken Sie auf eine beliebige Frage, um die Antwort auszuklappen. Kategorien werden, sofern festgelegt, am Ende jedes Eintrags angezeigt.

Konfigurationsreferenz

Der Support-Bildschirm speichert keine eigene Konfiguration. Er zeigt den Laufzeitstatus an und bietet direkte Aktionen.

Kontaktformular-Felder

Feld	Erforderlich	Hinweise
Name	Ja	Aus dem aktuellen Benutzerprofil vorausgefüllt.
E-Mail	Ja	Aus dem aktuellen Benutzerprofil vorausgefüllt.
Betreff	Ja	Klartext.
Priorität	Nein	Eine von `Low`, `Normal`, `High`, `Urgent`. Standardmäßig `Normal`.
Nachricht	Ja	Klartext.
Systemdiagnose automatisch anhängen	Nein	Standardmäßig aktiviert. Hängt das Plugin-Protokoll und WordPress `debug.log` an (jeweils max. 2 MB).

Steuerung für Wissen & Cache

Steuerelement	Wirkung
KI-Wissensindex neu aufbauen	Erstellt den lokalen Wissensindex neu, der zur Fundierung des Assistenten verwendet wird.
Dokumentations-Cache aktualisieren	Lädt den Snapshot der externen Dokumentation neu herunter.
Dokumentations-Cache löschen	Leert die zwischengespeicherte externe Dokumentation (der Assistent verlässt sich dann nur noch auf die lokale KB).

Betriebshinweise

Der KI-Assistent ruft einen verwalteten KI-Anbieter über das Plugin auf. Es werden keine Rohdaten von Endkunden gesendet, es sei denn, Sie geben diese explizit in den Chat ein.
Das Kontaktformular sendet seine Nachricht und alle angehängten Diagnosedaten über WordPress-Mail an eine feste ADP-Supportadresse; dieser Empfänger ist nicht über die Website konfigurierbar. Die Zustellung hängt von der E-Mail-Konfiguration Ihrer Website ab.
Der Systemdiagnose-Anhang soll helfen, Probleme schnell zu reproduzieren. Jeder Anhang ist auf 2 MB begrenzt. Wenn Ihr Protokoll diese Größe überschreitet, wird nur der jüngste Teil angehängt.
Die lokale Wissensdatenbank wird mit dem Plugin ausgeliefert und aus Quelldateien neu aufgebaut. Der externe Dokumentations-Cache wird aus dem offiziellen Dokumentations-Repository abgerufen und lokal gespeichert, damit GitHub nicht bei jeder Frage abgefragt werden muss.
Der Assistent empfiehlt immer, ein Support-Ticket zu eröffnen, wenn er unsicher ist — betrachten Sie dies als explizites Signal, nicht als Fehler.

Fehlerbehebung

Der Assistent gibt einen Fehler zurück. Überprüfen Sie den ausgehenden HTTPS-Zugriff vom Server. Öffnen Sie die Browser-Konsole für eine spezifischere Fehlermeldung. Versuchen Sie es nach einer kurzen Verzögerung erneut; vorübergehende Fehler beim Upstream-Anbieter sind häufig.
Das Kontaktformular meldet einen Fehler. WordPress-Mail ist nicht konfiguriert. Installieren Sie ein Plugin für transaktionale E-Mails (oder lassen Sie Ihren Hoster SMTP konfigurieren) und senden Sie das Formular erneut ab.
Der Systemdiagnose-Anhang fehlt. Entweder waren die Protokolldateien nicht lesbar oder jede einzelne überschritt 2 MB und wurde übersprungen. Überprüfen Sie den Pfad der Protokolldatei unter System- und Hilfe-Referenz.
Der Zähler für zwischengespeicherte Dokumente zeigt 0 / N. Die externe Dokumentation wurde noch nicht abgerufen. Klicken Sie auf Dokumentations-Cache aktualisieren.
KI-Wissensindex neu aufbauen meldet null Einträge. Überprüfen Sie, ob die Plugin-Dateien intakt sind. Installieren Sie das Plugin bei Bedarf neu.
Ressourcen-Links öffnen die falsche Seite. Der Cache ist möglicherweise veraltet; klicken Sie auf Dokumentations-Cache aktualisieren und laden Sie den Bildschirm neu.