Aggiungi file e pagine web alla base di conoscenza di Olvio

La base di conoscenza di Olvio contiene documenti e pagine web con informazioni che non si trovano nelle tue pagine prodotto, come una sezione FAQ, una guida alle taglie, istruzioni per la cura, condizioni di garanzia o schede tecniche. L'IA li usa nelle chat delle pagine prodotto e, nei piani Growth e Scale, nelle conversazioni di Olvio Advisor.

Li gestisci nella pagina Configurazione IA, nelle sezioni File di conoscenza e Pagine web esterne. Entrambe le sezioni sono disponibili in tutti i piani, e il tuo piano stabilisce quanti file e quante pagine puoi aggiungere. Queste due sezioni non usano la barra di salvataggio della pagina: un file viene salvato quando clicchi su Salva nella base di conoscenza, e una pagina web viene salvata quando Olvio l'ha letta.

Nelle chat delle pagine prodotto, Olvio legge già le pagine, gli articoli del blog e le informative del tuo negozio: consulta Come Olvio legge le pagine, gli articoli del blog e le informative del tuo negozio. Le conversazioni di Olvio Advisor non li usano, quindi nei piani Growth e Scale aggiungi in Pagine web esterne ogni pagina del negozio di cui l'Advisor ha bisogno. Una pagina aggiunta lì viene inviata anche con ogni messaggio delle chat delle pagine prodotto e, essendo la tua voce più recente, può escludere file e pagine più vecchi da quelli che l'IA usa (vedi Come Olvio usa i tuoi file e le tue pagine più sotto), quindi aggiungi solo le pagine di cui l'Advisor ha bisogno. Le note su un singolo prodotto vanno nel metacampo custom.olvio_knowledge di quel prodotto: consulta Aggiungi note specifiche per prodotto con il metafield custom.olvio_knowledge.

Carica un file di conoscenza

I file di conoscenza accettano file PDF, DOCX, TXT, MD e CSV, fino a 50 MB ciascuno. Olvio ignora gli altri tipi di file: se ne trascini o selezioni uno, ad esempio un foglio di calcolo Excel o un vecchio file Word (.doc), non si apre nessuna finestra di revisione. Prima di aggiungerli, salva i fogli di calcolo in formato CSV e i vecchi file Word in formato DOCX o PDF.

Nell'admin di Olvio, apri Configurazione IA.
In File di conoscenza, clicca su Aggiungi file e scegli un file, oppure trascina un file nell'area di caricamento.
Olvio estrae il testo nel tuo browser e mostra Lettura di seguito dal nome del file. Poi si apre una finestra intitolata Revisione: seguito dal nome del file.
Controlla il testo e modificalo se necessario. Viene salvato solo il testo in questa finestra.
Clicca su Salva nella base di conoscenza. Il messaggio File caricato conferma il caricamento e il file compare nell'elenco. Per interrompere senza salvare, clicca su Annulla.

Olvio non carica il file originale: invia e conserva solo il nome del file e il testo della finestra di revisione, e l'IA può vederli entrambi.

I file si aggiungono uno alla volta. Se ne trascini o selezioni più di uno, Olvio apre il primo e mostra un messaggio; aggiungi gli altri dopo averlo salvato o annullato.

Controlla il testo estratto

Gli avvisi sull'estrazione compaiono in cima alla finestra di revisione, sotto Attenzione:

File senza testo. Se Olvio non trova testo in un file, la casella di testo resta vuota e Salva nella base di conoscenza non è disponibile. Per un PDF, il messaggio indica che il PDF sembra scansionato o composto solo da immagini: un PDF scansionato non ha testo selezionabile, quindi esegui prima il riconoscimento del testo (OCR) oppure incolla tu stesso il testo nella casella. Se solo alcune pagine sono scansionate, Olvio le salta senza avvisare, quindi verifica che la casella di testo contenga tutte le pagine che ti servono. Per gli altri file, come un documento Word che contiene solo immagini, il messaggio è No readable text was extracted… Verifica che il documento contenga testo e non immagini di testo, oppure incolla tu stesso il testo nella casella.
File che Olvio non riesce a leggere. Se un PDF o un DOCX è danneggiato o protetto, oppure se il tuo browser non riesce a caricare il lettore PDF o DOCX di Olvio (ad esempio su una rete o con un'estensione del browser che lo blocca), la casella di testo resta vuota, Salva nella base di conoscenza non è disponibile e il messaggio Attenzione inizia con Couldn't read seguito dal nome del file e dal motivo. Se il file chiede una password quando lo apri, salvane una copia senza password e aggiungi quella copia. Se il file si apre normalmente sul tuo computer senza password, disattiva le estensioni del browser che potrebbero bloccare il lettore, oppure passa a un altro browser o a un'altra rete. Poi riapri l'admin di Olvio in una nuova scheda del browser e aggiungi di nuovo il file: aggiungerlo di nuovo nella pagina già aperta può mostrare lo stesso messaggio. Se continua a non funzionare, o se il file non si apre normalmente, salvalo di nuovo da un'altra app, oppure copia il suo testo in un file TXT, e aggiungilo di nuovo.
Documenti Word. Un file DOCX può mostrare anche alcune brevi note sulla conversione. Verifica che il testo nella casella sia corretto; se lo è, puoi salvare.
Righe ripetute. Nei PDF di più pagine, Olvio rimuove le righe brevi che si ripetono su molte pagine, come intestazioni e piè di pagina, e ti indica quante ne ha tolte. Verifica che non sia stato rimosso nulla di cui hai bisogno.
Documenti lunghi. Ogni file può contenere fino a 900 KB di testo. Il contatore sotto il testo mostra la dimensione attuale, ad esempio 85.3 KB / 900 KB (max per file). Se un documento è più lungo, Olvio conserva i primi 900 KB e ti avvisa.

Per i file CSV, Olvio trasforma ogni riga in una riga di tabella e divide le colonne a ogni virgola, comprese le virgole all'interno di testo tra virgolette. Se alcune celle contengono virgole, controlla quelle righe nella finestra di revisione.

Olvio legge i file TXT, MD e CSV come testo UTF-8. Se le lettere accentate non vengono visualizzate correttamente nella finestra di revisione, clicca su Annulla, salva di nuovo il file con codifica UTF-8 (in Excel, scegli CSV UTF-8 (delimitato da virgole)), poi aggiungilo di nuovo.

Aggiungi una pagina web esterna

In Configurazione IA, vai su Pagine web esterne e incolla l'indirizzo completo della pagina, ad esempio https://example.com/faq.
Clicca su Aggiungi. Il pulsante mostra un indicatore di caricamento mentre Olvio legge la pagina.
Quando la pagina è stata letta, vedi Pagina aggiunta alla base di conoscenza e la pagina compare nell'elenco.

Olvio conserva tutto il testo della pagina, compresi menu e piè di pagina, quindi scegli pagine incentrate sulle informazioni di cui gli acquirenti hanno bisogno.

Se la pagina non può essere letta, non viene salvato nulla e vedi Impossibile recuperare questa pagina: seguito dal motivo. L'indirizzo resta nel campo, così puoi correggerlo. Olvio può leggere una pagina quando:

L'indirizzo inizia con https:// e usa un nome di dominio pubblico. Gli indirizzi IP, localhost e gli indirizzi con un numero di porta (come :8080) vengono rifiutati con URL non valido. Usa un indirizzo https:// pubblico completo.
La pagina è pubblica. Olvio non può accedere a un sito con un account, quindi vede solo ciò che vede un visitatore che non ha effettuato l'accesso. Se a quell'indirizzo quel visitatore riceve una pagina di accesso, di password o dei cookie, Olvio può salvare il testo di quella pagina al suo posto, senza errori, e mostrarla come Recuperata. Per verificarlo, apri l'indirizzo in una finestra di navigazione privata.
L'indirizzo punta a una pagina web o a un file di testo semplice. Gli altri file, come un PDF collegato da un sito web, non vengono letti e compare Unsupported content type: scarica il file e caricalo invece in File di conoscenza.
Il testo si trova nella pagina stessa. Olvio non esegue gli script della pagina, quindi una pagina che costruisce il proprio contenuto con JavaScript può non essere letta e mostrare No readable text found…, oppure fornire a Olvio solo una parte del suo testo.
Il sito accetta visitatori automatizzati. Alcuni siti bloccano i visitatori automatizzati, quindi la lettura della pagina può non riuscire con un errore HTTP come HTTP 403, o con No readable text found…, anche se la pagina si apre nel tuo browser. In questo caso, copia il testo della pagina in un file TXT e caricalo in File di conoscenza.
La pagina si carica entro 10 secondi e non supera i 3 MB. Altrimenti vedi Timed out after 10 s, Network error while reading… o Page too large (max 3 MB).
Se l'indirizzo reindirizza, l'indirizzo finale deve rispettare le stesse regole. Altrimenti vedi Redirected to a blocked address.

Un motivo come HTTP 404 è l'errore restituito dal sito web: apri l'indirizzo nel browser per verificare che sia corretto. Network error significa che Olvio non è riuscito a connettersi al sito: controlla l'indirizzo e riprova. Ogni indirizzo può essere aggiunto una sola volta; se lo aggiungi di nuovo, vedi Questo URL è già nella tua base di conoscenza.

Mantieni aggiornate le pagine web

Ogni pagina compare nell'elenco con il suo dominio e percorso, come example.com/faq, e un badge di stato:

Recuperata: Olvio ha il testo della pagina. La riga sotto mostra Aggiornata il con la data e l'ora in cui Olvio ha letto la pagina l'ultima volta.
Errore: l'ultimo tentativo di leggere la pagina non è riuscito. La riga sotto mostra Ultimo tentativo il con la data e l'ora, seguite dal motivo. Olvio continua a usare il testo letto in precedenza.

Per controllare subito una pagina, clicca sulla sua icona di aggiornamento. Vedi Pagina aggiornata se il contenuto è cambiato, oppure Già aggiornata se non è cambiato. Se Olvio non riesce a leggere la pagina, vedi Impossibile aggiornare: seguito dal motivo, e il contenuto precedente resta in uso.

Olvio aggiorna anche automaticamente le tue pagine, di norma ogni notte, e sostituisce il testo salvato solo quando la pagina è cambiata. Un aggiornamento automatico non riuscito mostra lo stesso badge Errore e mantiene il testo precedente.

Aggiorna o rimuovi file e pagine

Non puoi visualizzare né modificare il testo di un file dopo averlo salvato. Per aggiornare un documento, eliminalo e carica la nuova versione. Per cambiare l'indirizzo di una pagina web, elimina la pagina e aggiungi il nuovo indirizzo.

Per rimuovere un file o una pagina web, clicca sull'icona del cestino accanto. Viene eliminato subito, senza passaggio di conferma, e vedi File rimosso.

Limiti dei piani

Il tuo piano stabilisce quanti file di conoscenza e quante pagine web esterne puoi aggiungere. I due limiti sono separati: le pagine web non contano nel limite dei file e i file non contano nel limite delle pagine web. Questi limiti indicano quante voci puoi salvare, non quante ne usa l'IA: nelle conversazioni usa solo i tuoi file e le tue pagine più recenti, contati insieme (vedi la sezione successiva).

Piano	File di conoscenza	Pagine web esterne
Starter	10	10
Growth	30	30
Scale	100	100

Un contatore sotto la descrizione di ogni sezione, come 3/10, mostra quanti ne hai aggiunti e diventa rosso quando raggiungi il limite.

Al limite, Olvio non aggiunge la voce e mostra You've reached the Starter plan limit of 10 knowledge files… per un file, oppure Limite di 10 pagine web raggiunto (piano Starter). Eliminane una o fai l'upgrade. per una pagina, con il tuo piano e il tuo limite. Per i file, questo controllo avviene quando clicchi su Salva nella base di conoscenza. La finestra di revisione si chiude quando clicchi su Salva nella base di conoscenza, quindi se il file non viene salvato, le modifiche che hai fatto vanno perse e devi aggiungere di nuovo il file. Se il contatore dei file è già al limite, elimina un file prima di caricarne un altro. Per aggiungerne altri, elimina una voce da quella sezione oppure, con Starter o Growth, passa a un piano superiore: consulta Passa a un piano superiore o inferiore.

Se passi a un piano con un limite più basso, i file e le pagine già aggiunti restano, ma non puoi aggiungerne altri a una sezione finché non scende sotto il nuovo limite.

Come Olvio usa i tuoi file e le tue pagine

L'IA usa le informazioni dei tuoi file e delle tue pagine per rispondere agli acquirenti, con l'istruzione di presentarle come conoscenze proprie del tuo negozio, senza dire da quale documento o pagina provengono.
L'IA ha l'istruzione di ignorare le istruzioni scritte all'interno di un file o di una pagina. Per cambiarne il comportamento, usa Regole di conversazione: consulta Scrivi regole di conversazione efficaci.
Le modifiche ai tuoi file e alle tue pagine, come una voce nuova, aggiornata o eliminata, arrivano nelle conversazioni entro pochi minuti, di solito dal messaggio successivo inviato da un acquirente.
Olvio usa solo un numero limitato delle voci aggiunte più di recente, contando insieme file e pagine web, e una quantità limitata del loro testo. Se aggiungi molte voci, quelle più vecchie non vengono usate, anche se brevi. Anche un documento lungo può occupare da solo tutto questo spazio, quindi la parte finale di un documento molto lungo potrebbe non essere usata. Mantieni la tua base di conoscenza su pochi documenti mirati: riunisci in un unico file i documenti brevi correlati ed elimina quelli obsoleti. Per ridare priorità a un documento più vecchio, eliminalo e aggiungilo di nuovo.
Il testo viene inviato a Claude con la tua chiave API di Anthropic insieme a ogni messaggio dell'acquirente, quindi file e pagine lunghi aumentano il tuo utilizzo di Anthropic. Consulta Cosa usa la tua chiave API di Anthropic e cosa no.
Tutto ciò che si trova nella tua base di conoscenza può essere riportato agli acquirenti, quindi non aggiungere documenti interni o riservati.
File e pagine non modificano le domande suggerite mostrate nelle tue pagine prodotto.

Per vedere a quali domande l'IA non ha saputo rispondere e decidere cosa aggiungere, consulta Trova e colma le lacune di conoscenza nella scheda Senza risposta.

Messaggi che potresti vedere

Messaggio	Cosa fare
"size-guide.pdf" è troppo grande (max 50 MB)	Il file supera i 50 MB. Riducine le dimensioni, dividilo o copia il suo testo in un file TXT.
Impossibile leggere "size-guide.csv" — prova a convertirlo in PDF o TXT	Il tuo browser non è riuscito ad aprire il file. Verifica che si apra sul tuo computer, poi aggiungilo di nuovo. Se continua a non funzionare, copia il suo testo in un nuovo file TXT e carica quello.
Un messaggio che inizia con File content too large	Il testo nella finestra di revisione superava i 900 KB, quindi il file non è stato salvato. Aggiungi di nuovo il file e mantieni il testo entro 900 KB prima di salvare.
Too many uploads… oppure Troppe richieste — attendi un momento e riprova.	Attendi un momento, poi aggiungi di nuovo il file o riprova con la pagina web.
Could not save the file… oppure Impossibile salvare la pagina. Riprova tra un momento.	Un problema temporaneo ha impedito il salvataggio. Attendi un momento, poi aggiungi di nuovo il file o riprova con la pagina web.