Nella pagina Configurazione IA presenti il tuo negozio a Olvio: cosa vendi, cosa deve sapere l'IA e come deve parlare con gli acquirenti. Olvio usa queste impostazioni in ogni chat della pagina prodotto e, con i piani Growth e Scale, nelle conversazioni di Olvio Advisor. Le domande suggerite non le usano. Olvio funziona anche senza, ma le sue risposte saranno più generiche.

Apri Configurazione IA nel menu dell'app Olvio. La pagina è disponibile con tutti i piani e ha cinque sezioni: Descrizione dell'attività, Categorie / Parole chiave, File di conoscenza, Pagine web esterne e Regole di conversazione.

Descrivi la tua attività nel campo Descrizione, fino a 10.000 caratteri. Un contatore nell'angolo in basso a destra del campo, ad esempio 1250/10000, mostra quanti caratteri hai usato. Copri gli aspetti essenziali:

Scrivila come se stessi presentando il negozio a un nuovo venditore nel suo primo giorno. Due paragrafi di contesto chiaro aiutano l'IA più di un elenco di frasi generiche. Il testo segnaposto mostra un modo per iniziare: Sei l'assistente virtuale di [marchio], specializzato in…

Olvio legge anche automaticamente le pagine, gli articoli del blog e le politiche del tuo negozio. Inserisce un passaggio in una chat della pagina prodotto solo quando corrisponde alla domanda dell'acquirente, e Olvio Advisor non li usa. Indicare le tue politiche principali nella descrizione le mantiene sotto gli occhi dell'IA in ogni conversazione. Con i piani Growth e Scale puoi anche aggiungere in Pagine web esterne una pagina del negozio di cui l'Advisor ha bisogno. Aggiungi solo le pagine di cui l'Advisor ha bisogno: ognuna conta ai fini del limite di pagine web, viene usata anche nelle chat della pagina prodotto e può escludere file e pagine più vecchi tra quelli che l'IA usa. Consulta Come Olvio legge le pagine, gli articoli del blog e le informative del tuo negozio.

Le parole chiave descrivono le aree di competenza della tua IA. Per aggiungerne una, scrivila in Aggiungi una parola chiave e clicca su Aggiungi. Ogni parola chiave appare come un tag; clicca sulla × di un tag per rimuoverlo. Puoi aggiungere fino a 30 parole chiave, ciascuna di massimo 80 caratteri, e una parola chiave scritta esattamente come una già presente nell'elenco non viene aggiunta di nuovo. Quando l'elenco contiene 30 parole chiave, Aggiungi svuota il campo senza aggiungere nulla, quindi rimuovi prima una parola chiave.

Esempi per un negozio di bellezza: Detergenti, Sieri, Solari, Cura del corpo. Per un negozio di snowboard: All-mountain, Freestyle, Powder, Scarponi, Attacchi.

Olvio fornisce le tue parole chiave all'IA come aree di competenza del tuo negozio. Non sostituiscono il catalogo: ciò che l'IA sa dei tuoi prodotti proviene dal catalogo che Olvio sincronizza da Shopify. Consulta Come Olvio mantiene sincronizzato il tuo catalogo.

Aggiungi documenti che l'IA deve usare per rispondere con più precisione, come una FAQ, schede tecniche o guide. I formati supportati sono PDF, DOCX, TXT, MD e CSV, fino a 50 MB per file. Per i fogli di calcolo, salvali prima in formato CSV.

Per aggiungere un file:

Olvio salva solo il testo mostrato nella finestra di revisione, non il file originale. Ogni file può contenere fino a 900 KB di testo, e il contatore sotto il testo mostra la dimensione attuale. Se un documento è più lungo, Olvio ne conserva i primi 900 KB e ti avvisa. Se con le tue modifiche il testo supera i 900 KB, il file non viene salvato, compare un messaggio che inizia con File content too large e devi aggiungere di nuovo il file. In una conversazione, Olvio può usare solo una parte di un documento molto lungo, quindi concentra ogni file su ciò che gli acquirenti chiedono davvero.

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

Dopo il salvataggio non puoi visualizzare né modificare il testo di un file. Per aggiornare un documento, eliminalo con l'icona del cestino accanto al suo nome e carica la nuova versione. Il file viene eliminato non appena clicchi sull'icona, senza alcuna richiesta di conferma.

Aggiungi pagine web pubbliche che l'IA deve leggere, come una FAQ o una guida ospitata su un altro sito. Olvio legge ogni pagina quando la aggiungi, poi la ricontrolla automaticamente, di norma ogni notte.

Se la pagina non può essere letta, non viene aggiunto nulla e vedi Impossibile recuperare questa pagina: seguito dal motivo. Olvio non esegue gli script delle pagine. Per una pagina che costruisce il proprio contenuto con JavaScript, l'aggiunta può fallire con il messaggio Impossibile recuperare questa pagina: No readable text found on the page, oppure la pagina può essere aggiunta solo con una parte del testo, come i menu. Per i siti che bloccano i visitatori automatici, l'aggiunta può fallire con un motivo come HTTP 403. Le pagine più grandi di 3 MB vengono rifiutate con il motivo Page too large (max 3 MB). L'indirizzo deve essere un indirizzo https:// pubblico con un nome di dominio, senza indirizzo IP né numero di porta (come :8080), altrimenti vedi URL non valido. Usa un indirizzo https:// pubblico completo. Olvio legge solo pagine web e testo semplice: per aggiungere un PDF, caricalo invece in File di conoscenza. Lo stesso indirizzo non può essere aggiunto due volte.

Ogni pagina dell'elenco mostra un badge. Recuperata significa che Olvio ha letto la pagina, e la riga sottostante indica quando è stata letta l'ultima volta. Errore significa che l'ultimo tentativo non è riuscito, e la riga sottostante indica quando e perché; l'IA continua a usare il contenuto letto in precedenza da Olvio.

Per verificare subito se una pagina è cambiata, clicca sulla sua icona di aggiornamento. Vedi Pagina aggiornata se il contenuto è cambiato, oppure Già aggiornata se non è cambiato. Per rimuovere una pagina, clicca sulla sua icona del cestino.

Il tuo piano stabilisce quanti file di conoscenza e quante pagine web puoi aggiungere. I due limiti sono separati: le pagine web non contano ai fini del limite di file, e i file non contano ai fini del limite di pagine web.

Un contatore sotto la descrizione di ogni sezione, ad esempio 3/10, mostra a che punto sei e diventa rosso quando raggiungi il limite. Al limite, elimina una voce prima di aggiungerne un'altra. Con Starter o Growth puoi anche passare a un piano con un limite più alto. Controlla il contatore dei file prima di aggiungere un file: al limite la finestra di revisione si apre comunque, ma quando clicchi su Salva nella base di conoscenza il file non viene salvato, compare un messaggio di errore e le modifiche fatte nella finestra vanno perse. 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, e un contatore può mostrare un valore superiore al limite, ad esempio 50/30. Non puoi aggiungere altro a quella sezione finché non torna sotto il nuovo limite.

Per le note su un singolo prodotto, usa invece il metafield custom.olvio_knowledge di quel prodotto in Shopify. Consulta Aggiungi note specifiche per prodotto con il metafield custom.olvio_knowledge. Per maggiori dettagli su file e pagine, consulta Aggiungi file e pagine web alla base di conoscenza di Olvio.

Le regole dicono all'IA cosa fare e cosa evitare in ogni conversazione. Sono divise in due elenchi, Da fare e Da evitare:

Come suggerisce la pagina, formula le regole in modo positivo quando possibile: l'IA le segue meglio quando descrivono cosa fare invece di cosa evitare. Per altri consigli, consulta Scrivi regole di conversazione efficaci.

Il tono predefinito dell'IA è cordiale e rassicurante, ma diretto. L'IA ha l'istruzione di dare alle tue regole la priorità sulle istruzioni integrate di Olvio su tono, lunghezza e formattazione, quindi usale per regolare lo stile. Nella chat della pagina prodotto, l'IA ha l'istruzione di non lasciare che le tue regole cambino la lingua in cui risponde. L'IA ha l'istruzione di applicare le tue regole senza parlarne agli acquirenti.

L'IA ha l'istruzione di non rivelare né citare la tua configurazione (descrizione dell'attività, parole chiave o regole) quando un acquirente la chiede; ha l'istruzione di rifiutare con una frase e tornare ad aiutare. Usa comunque il contenuto della tua descrizione dell'attività per rispondere alle domande, quindi non inserire nemmeno lì informazioni interne o riservate.

Descrizione dell'attività, Categorie / Parole chiave e Regole di conversazione vengono salvate insieme. Non appena ne modifichi una, compare la barra di salvataggio di Shopify:

I file di conoscenza e le pagine web esterne non usano la barra di salvataggio: ogni caricamento, aggiunta, aggiornamento o eliminazione viene salvato subito.

Le modifiche raggiungono le conversazioni con gli acquirenti entro pochi minuti, di solito dal messaggio successivo inviato da un acquirente. Una volta salvata una descrizione dell'attività, il passaggio Personalizza la tua IA della guida alla configurazione nella Dashboard (clicca su Olvio nel menu dell'app) viene contrassegnato come completato. Consulta La tua guida di configurazione: prepara Olvio per il tuo primo cliente.

La descrizione dell'attività, le parole chiave e le regole, insieme ai file e alle pagine web che Olvio usa, vengono inviati a Claude con la tua chiave API Anthropic insieme a ogni messaggio dell'acquirente, quindi i testi lunghi aumentano il tuo consumo Anthropic. Consulta Cosa usa la tua chiave API di Anthropic e cosa no.

Per capire cosa aggiungere dopo, apri Conversazioni e controlla la scheda Senza risposta: elenca le domande sui prodotti a cui l'IA non ha saputo rispondere. Consulta Trova e colma le lacune di conoscenza nella scheda Senza risposta.