Riferimento Supporto

Questo documento rappresenta il riferimento per la schermata Supporto del plugin ADP Car Market Hub (Car Market Hub → Support). Copre l'AI Support Assistant, il modulo di contatto per l'escalation, i collegamenti 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.
• Cercare 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.
• Contatto per escalation — modulo di ticket strutturato che invia un'e-mail al team di supporto ADP, con allegato facoltativo dei diagnostici di sistema automatici.
• Documentazione e risorse — collegamenti 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 capacità 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

1. Apri Car Market Hub → Support.
2. Nella scheda AI Support Assistant, digita la tua domanda con parole tue.
3. Fai clic su Chiedi all'AI o premi Ctrl + Enter (o Cmd + Enter su macOS).
4. 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 di amministrazione 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 lingua di amministrazione di WordPress; se scrivi in una lingua diversa, seguirà la lingua del tuo messaggio.

Aprire un ticket di supporto

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

Aprire la documentazione ufficiale

1. 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 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 collegamento si apre in una nuova scheda del browser.

Gestire la knowledge base AI e la cache della documentazione

1. 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.
2. Utilizza i pulsanti: - Ricostruisci indice di conoscenza AI — reindicizza la knowledge base locale dalla 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

1. Apri Quick Troubleshooting & FAQ nella parte inferiore della schermata.
2. Fai clic su qualsiasi domanda per espandere la risposta. Le categorie sono mostrate in fondo a ciascuna voce, se impostate.

Riferimento di configurazione

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

Campi del modulo di contatto

Controlli di Conoscenza e cache

Note operative

• L'AI Assistant chiama un provider AI gestito tramite il plugin. Nessun dato grezzo del cliente finale viene inviato a meno che non venga digitato esplicitamente nella chat.
• Il modulo di contatto invia il suo messaggio e gli eventuali diagnostici allegati a un indirizzo di supporto ADP fisso tramite posta WordPress; questa destinazione non è configurabile dal sito. La consegna dipende dalla configurazione della posta del tuo sito.
• L'allegato diagnostico 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 che GitHub non venga interrogato per ogni domanda.
• L'assistente consiglia sempre di aprire un ticket di supporto quando è incerto: trattalo come un segnale esplicito, non come un fallimento.

Risoluzione dei problemi

• L'assistente restituisce un errore. Conferma l'accesso HTTPS in uscita dal server. Apri la console del browser per un errore più specifico. Riprova dopo un breve ritardo; gli errori temporanei a monte sono comuni.
• Il modulo di contatto segnala un errore. La posta WordPress non è configurata. Installa un plugin per la posta transazionale (o chiedi al tuo host di configurare l'SMTP) e invia nuovamente.
• L'allegato diagnostico è mancante. I file di registro non erano leggibili oppure ciascuno di essi superava i 2 MB ed è stato saltato. Controlla il percorso del file di registro su Riferimento a sistema e aiuto.
• Il contatore dei documenti memorizzati nella cache mostra 0 / N. La documentazione esterna non è stata ancora recuperata. Fai clic su Aggiorna cache documentazione.
• La ricostruzione dell'indice di conoscenza AI segnala zero voci. Verifica che i file del plugin siano integri. Se necessario, reinstalla il plugin.
• I collegamenti alle risorse aprono la pagina errata. La cache potrebbe essere obsoleta; fai clic su Aggiorna cache documentazione e ricarica la schermata.

Documenti correlati

• Riferimento a sistema e aiuto
• Riferimento Logs
• Riferimento strumenti
• Riferimento impostazioni