FAQ
Le FAQ sono contenuti a domanda e risposta gestiti direttamente in Askme AI, pensati per le informazioni più richieste o per correggere in modo mirato una risposta poco precisa dell'agente.
Prerequisiti
- Una base di conoscenza già creata.
- Permesso di modifica delle basi di conoscenza.
Quando usare le FAQ
Le FAQ sono utili in due scenari principali: pubblicare in modo curato le domande più frequenti su un argomento, e trasformare in contenuto verificato una risposta dell'agente risultata incerta, con l'azione Aggiungi alle FAQ della revisione delle conversazioni (vedere Conversazioni e revisione).
La scheda FAQ
La scheda FAQ della base di conoscenza elenca le FAQ in una tabella con le colonne Domanda (con la risposta e il numero di varianti), Categoria, Stato e Visibile. La tabella si può cercare e filtrare per Domanda, Stato e Categoria. Un clic sulla riga apre la FAQ in modifica; il menu Azioni della riga contiene Modifica FAQ, la voce per mostrare o nascondere la FAQ nelle citazioni ed Elimina. Accanto alla tabella è sempre disponibile il pannello Importa in blocco.
Creare una FAQ
- Aprire la base di conoscenza e scegliere Aggiungi fonte > FAQ, oppure fare clic su Nuova FAQ nella scheda FAQ.
- Compilare i campi del dialog Nuova FAQ.
- Fare clic su Salva.
| Campo | Descrizione |
|---|---|
| Domanda | Obbligatorio, fino a 500 caratteri |
| Risposta | Obbligatorio, fino a 5.000 caratteri |
| Varianti della domanda | Formulazioni alternative con cui gli utenti potrebbero porre la stessa domanda; ogni variante si conferma con Invio o con la virgola |
| Categoria | Etichetta libera, usata anche come filtro nella tabella |
| Priorita | Bassa, Media o Alta (predefinita Media) |
| Stato editoriale | Bozza, Verificata o Obsoleta (predefinito Bozza) |
Stato editoriale
| Stato | Significato |
|---|---|
| Bozza | In lavorazione: la FAQ non viene usata nelle risposte |
| Verificata | Contenuto approvato: la FAQ viene recuperata e usata nelle risposte |
| Obsoleta | Non più valida: la FAQ resta in elenco ma non viene usata nelle risposte |
Solo le FAQ nello stato Verificata vengono recuperate dagli agenti. Una FAQ appena creata o importata è in Bozza: impostare Verificata quando il contenuto è pronto.
Importare FAQ in blocco
Il pannello Importa in blocco accetta un file CSV o JSON, trascinato nell'area oppure scelto con Scegli un file. I pulsanti Modello CSV e Modello JSON scaricano un file di esempio con le intestazioni attese: conviene partire da questi modelli.
| Formato | Contenuto importato |
|---|---|
| CSV | Domanda, risposta e categoria |
| JSON | Domanda, risposta e categoria, più priorità e varianti |
Le righe prive di domanda o di risposta vengono ignorate. Al termine un messaggio indica quante FAQ sono state importate. Le FAQ importate sono in stato Bozza e vanno portate a Verificata per essere usate nelle risposte.
Azioni su tutte le FAQ
Il menu Azioni su tutte le FAQ (icona con tre puntini accanto a Nuova FAQ) agisce su tutte le FAQ della base di conoscenza, comprese quelle non visibili nella pagina corrente della tabella:
| Voce | Effetto |
|---|---|
| Mostra tutte nelle citazioni | Rende tutte le FAQ visibili tra le fonti citate |
| Nascondi tutte dalle citazioni | Esclude tutte le FAQ dalle fonti citate, lasciandole disponibili per il recupero |
| Elimina tutte le FAQ | Elimina tutte le FAQ e i relativi frammenti indicizzati, dopo una conferma che ne riporta il numero. L'operazione non è reversibile |
Per la visibilità nelle citazioni vedere Visibilità nelle citazioni.
Le FAQ nelle risposte dell'agente
Ogni FAQ verificata genera un contenuto indicizzato al pari degli altri, recuperabile durante il processo RAG come qualunque altra fonte; a parità di pertinenza, la priorità impostata sulla FAQ ne influenza il peso nel recupero.
Problemi comuni
| Problema | Causa | Soluzione |
|---|---|---|
| L'agente non usa una FAQ appena creata o importata | La FAQ è in stato Bozza | Impostare lo stato su Verificata |
| L'importazione non importa alcuna FAQ | Il file non rispetta le intestazioni del modello, oppure le righe non hanno domanda o risposta | Scaricare di nuovo il modello e verificare le intestazioni |
| Priorità e varianti non vengono importate | Il file è in formato CSV | Usare il formato JSON |
| Domande simili non trovano la FAQ corretta | Mancano varianti della domanda che coprano quella formulazione | Aggiungere la variante mancante alla FAQ |
| Nessuna FAQ compare mai tra le fonti, anche a domanda identica | FAQ create prima della versione 2.1.0, indicizzate su un percorso che la ricerca non interrogava | Aprire e risalvare le FAQ interessate: il salvataggio le reindicizza e le rende recuperabili |