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 Links zur Dokumentation und die Steuerung der lokalen Wissensdatenbank.
Wann dieses Dokument zu verwenden ist
Lesen Sie dies, wenn Sie:
- 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 in der Admin-Browsersitzung 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(oderCmd + Enterauf macOS). - Die Antwort wird im Konversationsbereich angezeigt. Wenn die Antwort auf Dokumentationsseiten verweist, 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 mitgesendet, 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 sind 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.logangehä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 Instandhaltung. - Checkliste für Support-Informationen — Was vor der Kontaktaufnahme mit dem Support zu sammeln ist. - Vollständige Dokumentation — Das komplette 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, die der Assistent abgleichen kann.
- Zwischengespeicherte Dokumente —
cached / totalexterne Dokumentationsseiten, die lokal gespeichert sind. - Verwenden Sie die Schaltflächen: - KI-Wissensindex neu aufbauen — Reindexiert die lokale Wissensdatenbank aus der Quelle. - Dokumentations-Cache aktualisieren — Lädt die externen Dokumentationsseiten neu herunter. - Dokumentations-Cache leeren — Entfernt die zwischengespeicherte externe Dokumentation. Destruktiv.
Die FAQ verwenden
- Öffnen Sie
Quick Troubleshooting & FAQam unteren Bildschirmrand. - 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 | Vorausgefüllt aus dem aktuellen Benutzerprofil. |
| Ja | Vorausgefüllt aus dem aktuellen Benutzerprofil. | |
| 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). |
Steuerelemente für Wissen & Cache
| Steuerelement | Wirkung |
|---|---|
| KI-Wissensindex neu aufbauen | Erstellt den lokalen Wissensindex neu, der zur Untermauerung des Assistenten verwendet wird. |
| Dokumentations-Cache aktualisieren | Lädt den externen Dokumentations-Snapshot neu herunter. |
| Dokumentations-Cache leeren | Leert die zwischengespeicherte externe Dokumentation (der Assistent verlässt sich dann nur noch auf die lokale KB). |
Betriebshinweise
- Der KI-Assistent ruft über das Plugin einen verwalteten KI-Anbieter 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 eine WordPress-E-Mail an eine feste ADP-Supportadresse; dieses Ziel ist nicht auf der 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 diesen Wert ü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 Upstream-Fehler sind häufig.
- Das Kontaktformular meldet einen Fehler. Die WordPress-E-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 Datei ü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. - Der Neuaufbau des KI-Wissensindexes 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.