Documentazione · Riferimento amministratore

Riferimento Support

Questo documento rappresenta un riferimento per la schermata Supporto del plugin ADP Car Market Hub (CMH Center → Support). Copre l'AI Support Assistant, il modulo di escalation dei contatti, i link alla documentazione e i controlli della knowledge base locale.

Quando utilizzare questo documento

Leggi questo documento se hai bisogno di:

Porre una domanda sul plugin e ottenere una risposta basata sulla knowledge base ufficiale.
Aprire un ticket di supporto strutturato quando l'assistente non riesce a risolvere il problema.
Trovare le sezioni della documentazione ufficiale e il repository completo della documentazione.
Gestire l'indice locale della conoscenza AI e la documentazione esterna memorizzata nella cache.
Consultare le risposte alle domande più comuni nelle FAQ integrate.

Panoramica

La schermata Supporto è l'hub di aiuto centrale. Una riga di schede di stato (KPI) nella parte superiore riassume l'installazione a colpo d'occhio, seguita dalle schede principali:

Schede di stato — Versione del plugin, Licenza (piano e stato operativo), Ultimo aggiornamento, Stato del supporto (Operativo, N errori recenti o Attenzione richiesta) e Knowledge Base (numero di voci indicizzate).
AI Support Assistant — interfaccia di chat supportata da un provider AI gestito, basata sulla knowledge base locale del plugin e (opzionalmente) sulla documentazione ufficiale memorizzata nella cache.
Escalation dei contatti — modulo di ticket strutturato che invia un'e-mail al team di supporto ADP, con allegato automatico opzionale della diagnostica.
Documentazione e risorse — link alle sezioni della documentazione ufficiale e al repository completo della documentazione.
Conoscenza e cache — contatori e pulsanti di manutenzione per la knowledge base AI locale e la cache della documentazione esterna.
Risoluzione rapida dei problemi e FAQ — brevi risposte curate per le domande più comuni.

Requisiti o prerequisiti

Un utente con la funzionalità di gestione del plugin.
Per l'AI Support Assistant e la cache della documentazione esterna: accesso HTTPS in uscita dal server web.
Per il modulo di contatto: una configurazione di posta WordPress funzionante (in genere un plugin SMTP o un relay di posta gestito dall'host).
Cookie e JavaScript abilitati nella sessione del browser dell'amministratore (l'assistente e il modulo si affidano ad AJAX).

Istruzioni passo dopo passo

Chiedere all'AI Support Assistant

Apri CMH Center → Support.
Nella scheda AI Support Assistant, digita la tua domanda con parole tue.
Fai clic su Chiedi all'AI o premi Ctrl + Enter (o Cmd + Enter su macOS).
La risposta viene visualizzata nel pannello della conversazione. Quando la risposta fa riferimento a pagine della documentazione, l'elenco delle fonti viene mostrato sotto di essa.

L'assistente preferisce le risposte provenienti dalla knowledge base locale e ricorre alla documentazione esterna memorizzata nella cache quando necessario. La scheda amministrativa attiva viene inviata come contesto in modo che la risposta possa essere orientata verso l'area su cui stai attualmente lavorando. L'assistente tenta di rispondere nella tua lingua amministrativa di WordPress; se scrivi in una lingua diversa, seguirà la lingua del tuo messaggio.

Aprire un ticket di supporto

Scorri fino a Escalation dei contatti.
Compila Nome, E-mail, Oggetto e Messaggio. Nome ed e-mail sono precompilati dal tuo profilo WordPress.
Scegli una Priorità (Low, Normal (predefinita), High, Urgent).
Lascia abilitata l'opzione Allega automaticamente la diagnostica di sistema se desideri che vengano allegati il registro del plugin e il file WordPress debug.log (ciascuno limitato a 2 MB).
Fai clic su Invia ticket. Un messaggio di stato conferma il risultato in linea.

Aprire la documentazione ufficiale

Utilizza la scheda Documentazione e risorse per aprire: - Iniziare — primi passi e configurazione iniziale. - Riferimento amministratore — riferimento per ciascuna schermata di amministrazione. - Risoluzione dei problemi e FAQ — risposte a problemi e domande comuni. - Guida del frontend — la ricerca, gli annunci e le pagine di dettaglio rivolte ai visitatori. - Operazioni e manutenzione — gestione quotidiana, importazioni e manutenzione. - Lista di controllo delle informazioni di supporto — cosa raccogliere prima di contattare il supporto. - Documentazione completa — il repository completo della documentazione.

Ogni link si apre in una nuova scheda del browser.

Gestire la knowledge base AI e la cache della documentazione

Nella scheda Conoscenza e cache, esamina i contatori: - Voci KB locali — numero di voci di conoscenza indicizzate localmente. - Coppie Q&A indicizzate — numero di coppie di domande e risposte con cui l'assistente può effettuare il confronto. - Documenti memorizzati nella cache — pagine di documentazione esterna cached / total memorizzate localmente.
Utilizza i pulsanti: - Ricostruisci indice di conoscenza AI — reindicizza la knowledge base locale a partire dai file sorgente. - Aggiorna cache documentazione — scarica nuovamente le pagine della documentazione esterna. - Svuota cache documentazione — rimuove la documentazione esterna memorizzata nella cache. Azione distruttiva.

Utilizzare le FAQ

Apri Quick Troubleshooting & FAQ nella parte inferiore dello schermo.
Fai clic su qualsiasi domanda per espandere la risposta. Le categorie vengono mostrate in fondo a ciascuna voce, se impostate.

Riferimento di configurazione

La schermata Supporto non memorizza una propria configurazione. Mostra lo stato di runtime e le azioni dirette.

Campi del modulo di contatto

Campo	Richiesto	Note
Nome	Sì	Precompilato dal profilo dell'utente corrente.
E-mail	Sì	Precompilato dal profilo dell'utente corrente.
Oggetto	Sì	Testo normale.
Priorità	No	Uno tra `Low`, `Normal`, `High`, `Urgent`. Il valore predefinito è `Normal`.
Messaggio	Sì	Testo normale.
Allega automaticamente la diagnostica di sistema	No	Attivo per impostazione predefinita. Allega il registro del plugin e WordPress `debug.log` (max 2 MB ciascuno).

Controlli di Conoscenza e cache

Controllo	Effetto
Ricostruisci indice di conoscenza AI	Ricrea l'indice di conoscenza locale utilizzato per basare le risposte dell'assistente.
Aggiorna cache documentazione	Scarica nuovamente lo snapshot della documentazione esterna.
Svuota cache documentazione	Svuota la documentazione esterna memorizzata nella cache (l'assistente si affiderà quindi solo alla KB locale).

Note operative

L'AI Assistant chiama un provider AI gestito tramite il plugin. Nessun dato grezzo del cliente finale viene inviato a meno che tu non lo digiti esplicitamente nella chat.
Il modulo di contatto invia il suo messaggio e l'eventuale diagnostica allegata a un indirizzo di supporto ADP fisso tramite posta WordPress; questa destinazione non è configurabile dal sito. La consegna dipende dalla configurazione di posta del tuo sito.
L'allegato di diagnostica ha lo scopo di aiutare a riprodurre rapidamente i problemi. Ciascun allegato è limitato a 2 MB. Se il registro supera questo limite, viene inclusa solo la parte più recente.
La knowledge base locale viene fornita con il plugin e viene ricostruita dai file sorgente. La cache della documentazione esterna viene recuperata dal repository ufficiale della documentazione e memorizzata localmente in modo da non interrogare GitHub per ogni domanda.
L'assistente consiglia sempre di aprire un ticket di supporto quando è incerto — considera questo comportamento come un segnale esplicito, non come un errore.

Risoluzione dei problemi

L'assistente restituisce un errore. Verificare l'accesso HTTPS in uscita dal server. Aprire la console del browser per un errore più specifico. Riprovare dopo un breve ritardo; gli errori temporanei a monte sono comuni.
Il modulo di contatto segnala un errore. WordPress non è configurato. Installare un plugin per l'invio di email transazionali (o far configurare l'SMTP dal proprio host) e inviare nuovamente.
L'allegato della diagnostica è mancante. I file di log non erano leggibili oppure ognuno di essi superava i 2 MB ed è stato saltato. Controllare il percorso dei file di log in Riferimento a sistema e aiuto.
Il contatore dei documenti memorizzati nella cache mostra 0 / N. La documentazione esterna non è stata ancora recuperata. Fare clic su Aggiorna cache della documentazione.
La ricostruzione dell'indice di conoscenza dell'IA segnala zero voci. Verificare che i file del plugin siano integri. Reinstallare il plugin se necessario.
I collegamenti alle risorse aprono la pagina errata. La cache potrebbe non essere aggiornata; fare clic su Aggiorna cache della documentazione e ricaricare la schermata.