> For the complete documentation index, see [llms.txt](https://smartypilot.gitbook.io/smartypilot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smartypilot.gitbook.io/smartypilot/product-q-and-a/storico-domande.md).

# Storico domande

Lo storico domande raccoglie tutte le domande inviate dai clienti tramite il widget Product Q\&A, con le relative risposte e informazioni aggiuntive. Puoi usare questa sezione per monitorare cosa chiedono i tuoi clienti e verificare la qualità delle risposte generate.

## Filtra domande

Nella card in cima alla pagina puoi restringere i risultati usando i seguenti filtri:

* **Ricerca testo**: cerca per parola chiave nel testo della domanda, della risposta o nel nome del prodotto.
* **Data inizio / Data fine**: mostra solo le domande ricevute in un determinato intervallo di date.

Dopo aver impostato i filtri, clicca su **Cerca**. Per azzerare i filtri e tornare alla lista completa, clicca sul pulsante con la **X**.

## La lista delle domande

La tabella mostra per ogni domanda:

* **Data**: giorno e ora in cui è stata inviata.
* **Prodotto**: il nome e il codice SKU del prodotto su cui è stata posta la domanda.
* **Utente**: indica se la domanda è stata inviata da un utente autenticato (con l'ID cliente) oppure da un visitatore anonimo.
* **Domanda**: il testo della domanda posta dal cliente.
* **Risposta**: un'anteprima della risposta generata dall'AI.
* **Esito**: indica se la risposta è stata generata correttamente (**OK**) oppure se si è verificato un errore (**ERR**).
* **Qualità**: un punteggio percentuale che indica la qualità stimata della risposta. I valori alti (verde) indicano risposte accurate, i valori bassi (rosso) segnalano possibili problemi.
* **Tempo**: il tempo impiegato dall'AI per generare la risposta.

Per aprire il dettaglio completo clicca sulla **data** o sul **testo della domanda**: sono le due celle che fanno da collegamento, le altre non sono cliccabili.

L'elenco è diviso in pagine da 25 domande; in cima trovi il totale delle domande che rientrano nei filtri impostati.

## Dettaglio di una domanda

La pagina di dettaglio mostra tutte le informazioni relative a una specifica interazione.

### Domanda e risposta

* **Domanda**: il testo completo della domanda del cliente.
* **Risposta AI**: la risposta generata dall'AI, formattata. Se si è verificato un errore, viene mostrato il messaggio di errore al posto della risposta.

### Informazioni sul prodotto

* **SKU** e **nome** del prodotto su cui è stata posta la domanda.
* **Product ID**: il riferimento interno del prodotto nel sistema.
* **Ha immagine**: indica se il prodotto aveva un'immagine disponibile al momento della domanda.

### Informazioni sull'utente

Indica se la domanda è arrivata da un utente autenticato (con il relativo ID cliente) o da un visitatore anonimo.

### Qualità della risposta

Per ogni risposta vengono calcolati automaticamente alcuni indicatori di qualità:

* **Score medio**: il punteggio complessivo che riassume la qualità della risposta.
* **Coerenza**: quanto la risposta è coerente con le informazioni del prodotto.
* **Rilevanza**: quanto la risposta è pertinente alla domanda posta.
* **Chiarezza**: quanto la risposta è comprensibile e ben formulata.
* **Allucinazione**: la percentuale stimata di informazioni potenzialmente non accurate o inventate nella risposta. Un valore basso (verde) è positivo; un valore alto (rosso) indica che la risposta potrebbe contenere errori.

### Commento valutazione AI

Quando la valutazione automatica produce anche una nota scritta, compare una card **Commento valutazione AI** che spiega a parole perché la risposta ha ottenuto quel punteggio. Se non c'è nessun commento, la card non viene mostrata.

### Performance

L'ultima card raccoglie i dati tecnici della singola risposta: il **tempo di risposta**, il **modello GPT** usato e il conteggio dei token (prompt, risposta e totale). Sono utili quando vuoi capire perché una risposta è stata più lenta o più costosa delle altre.

{% hint style="info" %}
Se noti risposte con punteggi di qualità bassi o un alto tasso di allucinazione su un determinato prodotto, considera di aggiungere delle [domande predefinite](/smartypilot/product-q-and-a/domande-predefinite.md) con risposte verificate manualmente, oppure di arricchire la scheda prodotto con informazioni più dettagliate e poi eseguire una nuova [sincronizzazione](/smartypilot/ricerca/sincro-prodotti.md).
{% endhint %}