Smart Document Access
In questa sezione
Smart Document Access è il modulo aggiuntivo di Algho dove caricare e gestire la documentazione da fornire agli assistenti per rispondere agli utenti finali.
Il modulo è accessibile direttamente da Algho, selezionando Moduli e poi SDA 2.0.
Gestione documenti
La sezione “Gestione documenti” permette di creare e gestire Cartelle e Sottocartelle oltre a caricare e gestire la documentazione.
La documentazione è accessibile selezionando “Gestione documenti” nel menù di sinistra.
Creare una cartella
Per creare una nuova cartella, selezionare l’apposita opzione “Aggiungi” e assegnare un nome alla cartella.
Creare una sottocartella
Per creare una nuova sottocartella, selezionare l’apposita opzione “Aggiungi”.
Assegnare un nome alla sottocartella e selezionare la lingua dei documenti che verranno caricati all’interno.
È possibile specificare la durata di validità dei link che vengono forniti agli utenti finali durante l’interazione con un assistente.
Le opzioni “Metadati” e “Abilita estrazione immagini” possono essere abilitate in seguito.
Gestione della sottocartella
Facendo doppio click sulla sottocartella si accede al suo interno.
In ogni sottocartella è possibile applicare i seguenti filtri:
- Stato, ovvero se il documento è indicizzato, in indicizzazione oppure in errore;
- Ordinamento, ovvero per data di creazione, modifica, nome, numero di pagine, dimensione e stato;
- Direzione ordinamento, ovvero se crescente o decrescente;
È inoltre possibile effettuare ricerche testuali rispetto a:
- nome del file
- URL sorgente (vedi anche Smart Document Crawler)
Caricare dei documenti
Per caricare uno o più documenti selezionare l’apposita opzione “Carica file”.
È possibile caricare documenti in formato .pdf, .doc, .docx, .xlsx
Selezionare “Sfoglia” per visualizzare il file del proprio dispositivo. È possibile caricare anche più di un file contemporaneamente.
Caricando più di un file contemporaneamente, le opzioni aggiuntive non saranno disponibili in fase di caricamento. Saranno comunque accessibili una volta completata l’indicizzazione.
È possibile indicare inoltre:
- Nome del file
- Versione
- URL di riferimento
- Descrizione
L’URL di riferimento è la pagina a cui verranno portati gli utenti che selezionano il documento dall’elenco delle sorgenti usate da un assistente per generare la sua risposta.
Una volta caricato, il file risulterà “Salvato”. Passerà poi in stato di “Indicizzazione in corso” per finire in “Indicizzazione terminata”.
Salvato > Indicizzazione in corso > Indicizzazione terminata
Gestire i documenti
Per ogni documento è possibile eseguire le seguenti operazioni:
- Modifica
- Sostituzione
- Eliminazione
Per modificare un documento, selezionare il documento e cliccare su “Modifica”.
Le opzioni selezionabili sono le stesse presenti al momento del caricamento di un file.
Per sostituire l’attuale file con uno nuovo, è sufficiente selezionare “Sfoglia” e caricare il nuovo file.
Il vecchio file passerà allo stato “In eliminazione” e varrà definitivamente eliminato quando il nuovo file avrà completato l’indicizzazione.
Per eliminare un documento, selezionare il documento e cliccare su “Elimina selezionati”.
È possibile selezionare più di un documento per l’eliminazione. Per farlo, selezionare l’opzione “Selezione multipla” e scegliere tutti i documenti. Una volta scelti, selezionare “Elimina selezionati”.
Visualizzare un documento
Selezionando l’opzione “Apri debug” è possibile visualizzare come il sistema ha indicizzato il documento selezionato.
Nella visualizzazione aperta, ogni riquadro colorato corrisponde ad un paragrafo, ovvero un pezzo del documento che rappresenta una informazione raggruppata.
Collegare un assistente alla documentazione
Per collegare un assistente alla documentazione di Smart Document Access è necessario accedere alle “Impostazioni assistente” (vedi Impostazioni assistente) e poi alla sezione “SDA”.
Prima di proseguire, è utile comprendere come l’assistente interroga Smart Document Access.
Ricerca e risposta
Quando un utente pone una domanda ad un assistente collegato a Smart Document Access, viene effettuata una ricerca all’interno della documentazione e poi viene generata una risposta.
La fase di ricerca può avvenire in 3 modalità: ibrida (consigliata), vettoriale e semantica. Lo scopo della ricerca è identificare i paragrafi più rilevanti rispetto alla domanda dell’utente.
Una volta identificati i paragrafi, questi vengono utilizzati dall’AI per generare una risposta, seguendo le istruzioni del prompt inserito; l’AI utilizzerà anche il contesto della conversazione per rispondere al meglio.
Collegare le sottocartelle
Ad ogni assistente è possibile collegare una o più sottocartelle, a patto che queste facciano parte della stessa cartella.
Impostazioni di ricerca
Selezionando l’opzione “Acronimi” si possono inserire delle associazioni di parole per aiutare Smart Document Access in fase di ricerca.
Inserendo ad esempio “fissare” e “prendere” come acronimi di “prenotare”:
- Domanda utente: “Come posso prendere un appuntamento?”
- Domanda usata per la ricerca: “Come posso prendere o prenotare un appuntamento?”
L’opzione “Numero paragrafi per documento” consente di stabilire il numero massimo di paragrafi che possono essere selezionati per ogni documento.
Un numero di paragrafi basso può velocizzare i tempi di risposta ma può compromettere la rilevanza della risposta. Un numero di paragrafi più alto può migliorare la qualità della risposta ma può comportare tempi di risposta più lunghi.
Il “Tipo ricerca” permette di selezionare il tipo di ricerca che Smart Document Access effettuerà:
- Vettoriale: converte domande e intent in rappresentazioni matematiche chiamate vettori. La somiglianza tra una domanda e un intent viene determinata calcolando la distanza tra i loro vettori: quanto più sono vicini, tanto più la risposta è considerata rilevante.
- Semantica: analizza le informazioni semantiche contenute nella domanda dell'utente e negli intent definiti, restituendo la risposta più pertinente. Si basa sulla comprensione del significato delle parole e delle frasi, privilegiando il contesto e le relazioni linguistiche.
- Ibrida (consigliata): integra la ricerca semantica e quella vettoriale, combinandone i punti di forza per fornire risposte più precise e complete.
Generazione della risposta
Attivando l’opzione “Utilizza AI Gen per generare le risposte” viene abilitato l’editor del prompt di risposta.
All’interno del prompt possono essere inserite le istruzioni che l’AI userà per generare la risposta alla domanda dell’utente.
Non è necessario inserire istruzioni su come effettuare la ricerca, perchè queste non sono personalizzabili.
Token e numero di parole
Usando lo slider “Numero massimo di token in input per AI Gen” è possibile stabilire il numero di token da usare in input per l’AI.
Un valore più alto corrisponde a maggiori informazioni inviate all’AI Generativa, che può generare risposte più precise, ma può comportare tempi di risposta più lunghi.
Usando lo slider “Lunghezza risposta generata” è possibile stabilire (indicativamente) il numero massimo di parole per la risposta generata.
Il numero di parole è un parametro indicativo di cui l’AI terrà conto ma che potrebbe non rispettare alla lettera.
Opzioni documentazione
In questa sezione e possibile impostare l’utilizzo e la visualizzazione della documentazione.
L’opzione “Non visualizzare l’opzione ‘Mostra documenti’ dopo la risposta” disabiliterà l’opzione per gli utenti di visualizzare i documenti utilizzati per generare la risposta.
Se l’opzione è disattivata, l’interazione in chat sarà la seguente:
Se l’opzione è attiva, l’interazione in chat sarà la seguente:
L’opzione “Utilizza soltanto la documentazione più rilevante per generare la risposta” indica all’AI di riportare in “Mostra documenti” solo i paragrafi più rilevanti usati per generare la risposta.
Attivare questa opzione può comportare tempi di risposta più lunghi.
L’opzione “Impostazioni avanzate per l’anteprima dei documenti” permette di stabilire con più precisione quali documenti possono essere mostrati nell’elenco “Mostra documenti”.
Questa opzione e “Non visualizzare l’opzione ‘Mostra documenti’ dopo la risposta” sono mutualmente esclusive.
È possibile dunque scegliere di non mostrare i documenti provenienti da “Smart Document Crawler” oppure i documenti “Standard”, ovvero i documenti caricati manualmente.
Opzioni aggiuntive
In questa sezione è possibile stabilire le funzioni aggiuntive da attivare o disattivare dopo la risposta generata.
L’opzione “Nascondi la documentazione usata per generare la risposta se è presente un link” nasconderà l’opzione “Mostra documenti” se la risposta contiene un link come allegato multimediale.
L’opzione “Impostazioni avanzate per la visualizzazione dei link” permette di stabilire con più precisione quali documenti possono essere mostrati nell’elenco “Mostra documenti” in base alla tipologia di sorgente del documento.
L’opzione “Disabilita la navigazione automatica per i link inseriti nella risposta” permette di disattivare la navigazione automatica se la risposta generata presenta un link come elemento multimediale (vedi Intent per maggiori informazioni sulla navigazione automatica).
Avvio di Form e Intent
Le ultime due opzioni permettono di impostare l’avvio di un form oppure di un intent dopo la risposta generata.
Le due opzioni sono mutualmente esclusive.
“Avvia form stabilito da AI Gen” consente di collegare uno più form e indicare tramite prompt le condizioni in cui devono essere avviati.
“Avvia intent dopo ogni risposta generata” consente di stabilire un intent che deve essere avviato dopo ogni risposta generata.
