La presente guida ha lo scopo di illustrare in modo dettagliato il funzionamento di tutti gli strumenti disponibili nella dashboard di configurazione del BOT InsiteAI. Ogni sezione è pensata per permettere all’utente di ottimizzare il comportamento e le risposte del proprio assistente virtuale, garantendo coerenza, efficienza e massima personalizzazione.

---

Introduzione al Concetto di Contesto

Il "contesto" è l'insieme delle informazioni che il BOT riceve prima di generare una risposta. Include:

• Istruzioni impartite all'AI (ruolo, tono, comportamento previsto).
• Contenuti statici o dinamici provenienti da documenti, siti o testi liberi.
• Esempi di addestramento che mostrano all'AI come rispondere a domande specifiche.
• Cronologia della conversazione, utile per mantenere coerenza nei dialoghi prolungati.

Il contesto è cruciale: una sua corretta configurazione influisce direttamente sulla precisione e pertinenza delle risposte fornite dal BOT.

Accesso alla piattaforma

Per accedere al pannello di controllo, visita il seguente link:

🔗 https://insiteai.it/inaidash/login.php

Se hai dimenticato la password, clicca su "PASSWORD DIMENTICATA" nella schermata di login. Ti verrà chiesto di inserire la tua email e riceverai un link per il reset della password.

🧰 STRUMENTI GENERALI

📊 ISTRUZIONI PER L’INTEGRAZIONE

In questa sezione è possibile visualizzare e copiare il codice da inserire nel proprio sito per l’integrazione del proprio assistente AI.
Il codice va inserito in ogni pagina in cui si vuole l’assistente, appena prima della chiusurua del tag </body>

Se sono caricati dei documenti (ad esempio dei manuali) è possibile anche creare pagine che rispondano tenendo come base di conoscenza un singolo documento (ad esempio se viene caricato un manuale di un prodotto e su una pagina si vuole inserire un bot che risponda SOLO su quel prodotto). In questo caso apparirò anche la voce Codice dinamico (base di documenti diversi in pagine diverse)
Scegliere il documento dal menù a tendina e copiare il codice generato

📊 Consumi

Questa sezione mostra l'utilizzo del bot, inclusi:

• Numero di richieste ricevute e richieste totali disponibili al mese (in base al proprio piano).
  Una richiesta corrisponde ad 1 domanda + 1 risposta del bot
• Storico delle richieste mensili

È utile per monitorare il traffico del bot.

💬 Storico Chat (Costo: 5€ al mese)

Questa funzione consente di visualizzare tutte le conversazioni avvenute tra gli utenti e il bot.
Puoi monitorare e analizzare le interazioni degli utenti con il bot per migliorare il servizio.

🔹 Vantaggi:

• Revisione delle domande più frequenti
• Ottimizzazione delle risposte del bot
• Monitoraggio delle performance

---

🧰 IMPOSTAZIONI GENERALI BOT

🤖 Gestione Nome e Logo Bot

Qui puoi personalizzare il nome del bot visibile agli utenti finali.
Puoi modificarlo in qualsiasi momento per adattarlo alla tua comunicazione aziendale.
Puoi anche caricare un piccolo logo (di formato 100x100 pixel, jpg o png) che apparirà come “fumetto” di riconoscimento nelle risposte del bot

✏️ Gestione Testo di Benvenuto

Questa funzione permette di personalizzare il messaggio iniziale che il bot mostra agli utenti quando inizia una conversazione.
Puoi scrivere un messaggio personalizzato per accogliere gli utenti in modo efficace.

È anche possibile in questa sezione modificare il testo accanto al fumetto in alto a destra quando la chat è chiusa

❓ Gestione Domande Suggerite

In questa sezione puoi:

• Aggiungere domande frequenti per aiutare gli utenti a interagire con il bot
• Modificare le domande già presenti
• Eliminare domande obsolete

Le domande suggerite vengono mostrate agli utenti per guidarli nelle loro richieste.

E’ possibile inserire fino ad un massimo di 4 domande (lasciare vuote le righe se si vogliono meno domande. Compilare almeno una domanda)

📝 Gestione Istruttore

Permette di configurare il comportamento base del BOT attraverso istruzioni impartite al modello come ruolo “system” (es. "Agisci come assistente commerciale..."). È il primo messaggio che il BOT riceve, fondamentale per il tono e l’obiettivo della conversazione.

L'Istruttore del Bot è una sezione avanzata dove puoi definire regole e istruzioni che il bot deve seguire. Puoi personalizzare il comportamento del bot in base alle tue esigenze aziendali. E’ possibile anche utilizzare il WIZARD in alto per generare uno schema preimpostato di istruzioni.

Si consiglia di seguire questo schema per le istruzioni:

Ruolo e contesto “Sei un assistente del sito XXXXXXXXXX.XX, specializzato in **************** ed esperto in. Ti verranno fornite delle domande riguardanti XXXXXXXXXXXXXX. Il tuo obiettivo è rispondere alle domande utilizzando il contesto fornito, anche se la domanda non è espressa esattamente come nel testo. ”   Interpretazione della domanda Interpreta ogni domanda in modo flessibile per individuare informazioni pertinenti anche se espresse in modo diverso. Elabora ogni domanda interpretandola ampiamente per identificare termini e concetti pertinenti. Se la domanda riguarda i servizi offerti cerca nel contesto le informazioni Se la domanda non riguarda i servizi di Bussola d'Impresa ma aspetti più generali cerca la risposta nel contesto Rispondi anche su altri aspetti descritti nel contesto. Risposta e Contenuti Se trovi informazioni pertinenti nel contesto, fornisci una risposta basata su di esse, anche se il testo non contiene esattamente le parole chiave della domanda. Se non trovi nulla di rilevante, rispondi: “Mi spiace, non ho trovato informazioni. Prova a riformulare la domanda.”   Formattazione della Risposta Usa HTML per migliorare la leggibilità. Evidenzia concetti chiave con . Struttura le informazioni in elenchi puntati ( Nota Finale Obbligatoria "Se hai ulteriori domande non esitare a contattarci all'indirizzo XXXXXXXX"

🎨 Gestione Stili (Costo: 5€ al mese)

Consente di personalizzare l'aspetto visivo del bot per adattarlo all'identità aziendale.
Questa funzione è utile per rendere l’interfaccia più in linea con il tuo brand. Potrai personalizzare:

headerBackgroundColor (colore sfondo testata)

headerTextColor (colore testo testata)

toggleButtonBackgroundColor  (colore di sfondo bottone di aperura chat)

toggleButtonTextColor (colore del testo bottone di aperura chat)

userBubbleBackgroundColor (colore di sfondo fumetto dell’utente)

botBubbleBackgroundColor (colore di sfondo fumetto del bot)

chatContainerHeight (altezza chat)

chatContainerWidth (larghezza chat)

chatSendButtonbackgroundColor (colore bottone di invio richiesta utente)

---

🧰 BASE DI CONOSCENZA DEL BOT

🏋️ Addestramento BOT

Sistema che consente di inserire esempi di domanda e risposta personalizzati. Serve a guidare il BOT verso risposte precise per casi ricorrenti.

• Ogni esempio viene interpretato come "modello da seguire".
• Gli esempi sono parte del contesto e vengono prioritizzati.
• Consigliato per casi aziendali, FAQ, risposte con linguaggio tecnico o specifico.

📝 Gestione Testo Libero

Permette di scrivere manualmente contenuti informativi da includere nel contesto.

• Ideale per contenuti aziendali ricorrenti.
• Utilizzato come "base" fissa.
• Inserito nei messaggi utente come "Contesto:".

Il testo sarà accessibile tramite un link che potrai aggiungere agli URL dinamici.

🔒 Gestione URL DINAMICHE

URL i cui contenuti non vengono memorizzati nel database: Ogni volta che l’utente fa una domanda, il contenuto viene scaricato in tempo reale.

Consente di aggiungere fino a 10 URL che il bot analizzerà per rispondere in base ai contenuti aggiornati. Le pagine verranno analizzate ogni volta dal bot per garantire che vengano presi in considerazione gli ultimi contenuti aggiornati.

Nota:

• Evitare di inserire URL con contenuti troppo ampi per non rallentare le risposte.
• Per contenuti ampi e che non vengono spesso aggiornati, utilizzare la funzione GESTIONE URL STATICHE.

 🔒 Gestione URL STATICHE

URL il cui contenuto viene indicizzato nel database. Questa funzione permette di inserire link a pagine web che contengono informazioni utili per il bot. All’inserimento, il contenuto viene scaricato e spezzato in “chunk embeddati”. Questi vengono usati per il contesto tramite similarità semantica.

Queste pagine verranno aggiunte ad un database di consocenze del BOT. Se il contenuto della pagina viene aggiornato, bisogna cancellare e ricaricare l’URL. Questa funzione è utile per pagine con tanti contenuti.

Ad esempio, puoi caricare:

• FAQ aziendali
• Pagina dei servizi o del chi siamo
• Manuali e linee guida
• Pagine informative

Il bot utilizzerà questi URL per migliorare le risposte agli utenti.
Sono consentiti fino a 10  url.
Per inserimento di più di 10 URL contattare l’assistenza.

Suggerimenti Generali per una Buona Configurazione

• Tono del BOT: scegli con cura le istruzioni per dare personalità coerente.
• Contesto breve ma ricco: evita contenuti superflui, privilegia quelli utili.
• Documentazione aggiornata: verifica periodicamente che testi, URL e istruzioni siano attuali.
• Evita ripetizioni: l’AI penalizza contenuti ridondanti.
• Test frequenti: esegui domande di prova e affina sulla base delle risposte.

Come Attivare le Funzionalità Aggiuntive?

Se una funzionalità premium è disattivata, puoi cliccare su "RICHIEDI ATTIVAZIONE" all'interno della dashboard.
Verrà inviata una richiesta al team di InsiteAI, che ti contatterà per finalizzare l’attivazione.

TESTARE IL BOT

Per testare le funzionalità del BOT dalla home della dashbord cliccare nel menà a destra su “TESTA IL TUO BOT”. Si aprirà una pagina demo con il bot (se la finestra della chat non è aperta cliccare in alto a destra su “Chiedi al nostro assistente AI”.

Potrete testare il BOT in azione facendo domande e visualizzando le risposte. Per tornare alla dashboard cliccare su “TORNA ALLA TUA DASHBOARD” sulla barra superiore della pagina

Supporto e Assistenza

Se hai bisogno di aiuto o hai domande sulla piattaforma, puoi contattare il supporto via email:
📧 info@insiteai.it