OpenAI

Le seguenti impostazioni sono relative all'app di Intelligenza Artificiale OpenAI.

Sincronizzazione

Modalità di Sincronizzazione Automatica

• Questa funzionalità è disponibile solo nella versione cloud di Chat G Tech Group.
• La modalità di sincronizzazione automatica è pronta all'uso e non richiede impostazioni aggiuntive.
• Se vuoi attivare il chatbot, vai su Impostazioni > Intelligenza Artificiale > OpenAI > Chatbot.
• È necessario acquistare crediti per utilizzare questa opzione.

Modalità di Sincronizzazione Manuale

L'integrazione con OpenAI (ChatGPT) offre al tuo chatbot la capacità di rispondere a domande generali su quasi tutto ciò che puoi immaginare. Per iniziare a utilizzarla, segui i passaggi seguenti:

1. Registrati su OpenAI.
2. Ottieni una chiave API da OpenAI API Keys e incollala in Impostazioni > Intelligenza Artificiale > OpenAI > Chiave API.
3. Abilita il chatbot da Impostazioni > Intelligenza Artificiale > OpenAI > Chatbot.

Informazioni

• Se OpenAI non funziona, clicca qui.
• Se vuoi inviare solo l'ultimo messaggio dell'utente e impedire che tutti i messaggi precedenti della conversazione vengano inviati a OpenAI, puoi selezionare l'opzione Ometti messaggi precedenti. Se OpenAI non riesce a rispondere dopo alcuni messaggi dell'utente, puoi provare a selezionare questa opzione e tentare di nuovo.
• Se Dialogflow è attivo, la query OpenAI viene eseguita solo se il chatbot non conosce la risposta alla domanda dell'utente e se la lunghezza del messaggio dell'utente è superiore a 4 caratteri.
• Le seguenti impostazioni sono compatibili con OpenAI: Risposta intelligente, Presa in carico umana, Disabilita per l'area ticket, Disabilita durante l'orario di lavoro, Ritardo della risposta del bot, Rispondi alle email degli utenti, Rispondi ai messaggi di testo degli utenti.
• Le seguenti impostazioni di Google sono compatibili con OpenAI: Multilingue, Multilingue tramite traduzione, Traduzione automatica, Rilevamento della lingua.
• Se un operatore umano prende il controllo, il chatbot OpenAI viene disattivato e rimane disattivato anche se l'agente va offline. Il chatbot Dialogflow continua a funzionare quando necessario.
• Il modello predefinito è gpt-3.5-turbo.
• OpenAI supporta l'uso dei messaggi vocali tramite il riconoscimento vocale.

Modalità Chatbot

Questa funzione è relativa all'opzione Impostazioni > Intelligenza Artificiale > OpenAI > Modalità Chatbot. Ti consente di configurare le informazioni che OpenAI utilizzerà per rispondere ai messaggi degli utenti.

• Solo domande generali: OpenAI risponderà solo a domande generali e a domande relative ai messaggi precedenti dell'utente nella stessa conversazione, senza utilizzare alcuna informazione fornita. Questa è l'impostazione predefinita.
• Solo domande relative alle tue fonti: OpenAI risponderà solo a domande relative alle informazioni che fornisci. I messaggi dell'utente verranno ignorati. Devi prima addestrare il chatbot con le tue fonti.
• Tutte le domande: OpenAI risponderà a domande relative alle informazioni che fornisci, a domande generali e a domande relative ai messaggi precedenti dell'utente nella stessa conversazione. Devi prima addestrare il chatbot con le tue fonti. Questa è la modalità consigliata.
• Assistente: Usa questa modalità se stai utilizzando un Assistente OpenAI.

Assistente

Questa funzione ti consente di utilizzare i tuoi Assistenti creati su OpenAI Assistants.

• Se stai utilizzando la versione cloud, devi impostare Impostazioni > Intelligenza Artificiale > OpenAI > Modalità di sincronizzazione su Manuale e utilizzare la tua chiave API.
• Puoi utilizzare più assistenti aggiungendo i loro ID in Impostazioni > Intelligenza Artificiale > OpenAI Assistants - Collegamento ai dipartimenti e selezionando Assistente in Impostazioni > Intelligenza Artificiale > OpenAI > Modalità Chatbot. Per attivare un assistente, sia l'assistente che le conversazioni devono essere assegnati a un dipartimento.
• L'assistente viene utilizzato solo per il chatbot e le risposte intelligenti, non per la riscrittura dei messaggi e altre funzionalità.

Chatbot

La funzione chatbot OpenAI funziona in modo simile a Dialogflow, fornendo risposte automatiche ai messaggi degli utenti. Seleziona l'impostazione della modalità Chatbot per specificare le domande a cui il chatbot è in grado di rispondere. Utilizza la funzione di presa in carico umana per consentire al chatbot di reindirizzare la chat a un agente umano quando necessario.

Messaggio di Fallback

Il messaggio di fallback viene inviato quando OpenAI non riesce a comprendere la domanda dell'utente. Se il chatbot Dialogflow è abilitato, il messaggio di fallback verrà disattivato e verrà utilizzato invece il messaggio di fallback del chatbot Dialogflow.

Prompt

Il prompt istruisce OpenAI su come rispondere fornendo informazioni pertinenti che possono essere utilizzate per rispondere alle domande degli utenti. Per comprendere il processo, consulta gli esempi di prompt elencati di seguito.

• Se scegli di attivare la funzione di presa in carico umana, devi dire a OpenAI di rispondere con "Non lo so" se non è in grado di fornire una risposta alla domanda dell'utente. Dovresti sempre includere il seguente testo nel prompt: Rispondi "Non lo so", se non sei sicuro della risposta.

Riscrittura dei Messaggi

Questo prompt istruisce OpenAI su come riscrivere un messaggio quando il pulsante di riscrittura del messaggio è attivo. Questo prompt deve essere in inglese. Chat G Tech Group aggiunge automaticamente il seguente testo quando richiesto: e usa la lingua dell'utente, aggiungi saluti.

• Le risposte dalle fonti di addestramento possono essere utilizzate con la funzione di prompt poiché sono compatibili.

Correzione Ortografica

Questa funzione corregge automaticamente eventuali errori di ortografia nei messaggi dell'agente.

Risposta Intelligente

Questa funzione consente di abilitare la funzione di Risposta Intelligente anche se il chatbot non è attivo. Se il chatbot è attivo, la funzione di Risposta Intelligente utilizzerà OpenAI automaticamente.

Correzione Ortografica di Dialogflow

Nel caso in cui Dialogflow non riesca a trovare la risposta appropriata al messaggio dell'utente, questa funzione verifica se ci sono errori di ortografia. Se tali errori esistono, Dialogflow viene richiamato con la versione corretta del messaggio per una risposta accurata. Sebbene abbia una priorità più alta, questa funzione può comunque funzionare insieme alla funzione di correzione ortografica di Google Search.

Pulsante di Riscrittura del Messaggio

Questa funzione aggiunge un pulsante al campo di testo dell'area conversazioni. Cliccando su di esso, puoi riscrivere il tuo messaggio rendendolo più amichevole e professionale. I saluti verranno aggiunti automaticamente se non ci sono messaggi precedenti dell'agente. Se la tua lingua non è l'inglese, devi modificare il tuo profilo agente/amministratore e impostare la lingua corretta.

Riconoscimento Vocale

Quando questa opzione è attiva, i messaggi audio vengono convertiti in testo scritto.

• Non è necessario attivare questa funzione affinché il chatbot comprenda i messaggi audio. La funzione di riconoscimento vocale del chatbot è sempre abilitata.
• Per far funzionare meglio questa funzione, la lingua dell'utente dovrebbe essere conosciuta. Per rilevare automaticamente la lingua dell'utente, puoi abilitare la funzione di rilevamento della lingua.
• Il testo verrà visualizzato accanto al lettore audio.
• Il testo generato è compatibile con le funzionalità di traduzione.

Link alle Fonti

Quando questa opzione è attiva, la risposta includerà automaticamente i link alle fonti e ai dati di addestramento utilizzati per generare la risposta.

Estrazione Dati delle Note

Quando questa opzione è attiva, vedrai un menu nel pannello delle note. Il menu consente l'estrazione automatica di informazioni specifiche dai messaggi degli utenti.

Parametri OpenAI

Chat G Tech Group ti consente di regolare vari parametri OpenAI come temperature e logit_bias. Per ulteriori dettagli, visita la documentazione di OpenAI. Non impostare alcun valore se non sai cosa fanno questi parametri, altrimenti OpenAI potrebbe smettere di funzionare.

Logit Bias

Il parametro Logit bias deve essere una stringa JSON e le chiavi devono essere stringhe, ad esempio: {"2435":-100, "640":-100}.

Generazione di Espressioni Utente - Opzione

Quando questa opzione è attiva, OpenAI genererà nuove espressioni utente in tempo reale quando apri la finestra di addestramento del chatbot.

Generazione di Espressioni Utente - Pulsante

Quando clicchi sul pulsante Genera espressioni utente, OpenAI aggiornerà il tuo agente Dialogflow e genererà nuove espressioni utente per ogni Intent.

• Fai prima un backup del tuo agente Dialogflow.
• Questa operazione può richiedere diversi minuti o addirittura ore se il tuo chatbot ha molte Intents. Poiché l'operazione richiede molto tempo, il tuo server potrebbe interrompere l'operazione (timeout dell'operazione) prima che finisca, nel qual caso devi cliccare nuovamente sul pulsante. Puoi verificare se l'operazione è stata interrotta controllando la console del browser per eventuali errori.
• Questa operazione viene eseguita solo una volta per Intent. Le Intents elaborate in precedenza verranno ignorate.
• Questa operazione controlla le espressioni utente esistenti e non crea duplicati.
• Le prime 5 espressioni utente verranno utilizzate per generare nuove espressioni utente.
• Poiché si tratta di un processo automatizzato, si consiglia vivamente di rivedere le Intents dopo che l'operazione è stata completata.

Addestramento

Questa funzione consente al tuo chatbot di essere addestrato utilizzando il tuo sito web, testi, documenti PDF e altro. Una volta completato l'addestramento, il chatbot sarà in grado di rispondere a domande relative ai tuoi contenuti. Per accedere a questa funzione, naviga su Chatbot > Addestramento.

1. Per avviare l'addestramento del chatbot, accedi all'area del chatbot. È possibile inserire URL per siti web, file di testo o PDF, o sitemap XML.
2. Una volta impostate le fonti, clicca sul pulsante Addestra il chatbot e attendi il completamento del processo di addestramento.

Addestramento Tramite Cron Job

Per addestrare automaticamente il chatbot con i contenuti del tuo sito web a intervalli regolari, crea un cron job che esegua l'URL https://chat.gtechgroup.it/include/api.php?open-ai-training=true, oppure usa il comando */59 * * * * wget https://chat.gtechgroup.it/include/api.php?open-ai-training=true per eseguirlo tramite comando. Sostituisci chat.gtechgroup.it con l'URL di Chat G Tech Group, ottenibile da Impostazioni > Varie > Support Board URL. Se stai utilizzando la versione cloud, usa questo URL: https://cloud.chat.gtechgroup.it/script/include/api.php?open-ai-training=true&cloud=API-TOKEN e sostituisci API-TOKEN con il tuo token API.

• Per la versione cloud, il cron job può essere eseguito al massimo una volta ogni 7 giorni.
• Si raccomanda vivamente di fornire una sitemap XML invece dell'URL del sito web per motivi di prestazioni.
• L'addestramento automatico è limitato ai siti web; file, Q&A e articoli sono esclusi. Il riaddestramento cancellerà i dati di addestramento del sito web precedente.

Addestramento Multilingue

Se la tua base di utenti è multilingue, puoi addestrare il chatbot con contenuti in più lingue e limitare il chatbot a recuperare risposte solo dalle fonti nella lingua dell'utente. Per attivare questa funzione, seleziona l'opzione Impostazioni > Intelligenza Artificiale > OpenAI > Fonti di addestramento multilingue.

• File: I file supportano attualmente solo una lingua.
• Siti web: La lingua del sito web viene rilevata automaticamente. Per consentire a Chat G Tech Group di comprendere la lingua delle tue pagine web, il tag <html> deve contenere l'attributo lang.
• Q&A: Le Q&A supportano attualmente solo una lingua.
• Articoli: Tutte le lingue degli articoli vengono utilizzate automaticamente.
• Conversazioni: Se la traduzione automatica è attiva, verranno utilizzati solo i messaggi nella lingua dell'agente.

Informazioni

• Puoi aggiungere e gestire domande e risposte personalizzate da Chatbot > Addestramento > Q&A e dalla finestra di addestramento del chatbot.
• È possibile caricare solo file in formato PDF e TXT.
• Se riaddestri lo stesso sito web, devi prima eliminare i dati di addestramento del sito web precedente; in caso contrario, verranno addestrati solo i nuovi URL.
• Puoi fornire l'URL del sito web e tutti gli URL secondari saranno inclusi e scansionati, ma con siti web di grandi dimensioni è più efficiente e meno soggetto a errori e cicli infiniti di link utilizzare una sitemap XML anziché fare affidamento sull'URL del sito web. Puoi crearla con un servizio come XML Sitemaps.
• Se vuoi addestrare il tuo chatbot utilizzando pagine specifiche del tuo sito web anziché tutte, puoi utilizzare una sitemap XML. Creane una utilizzando uno strumento come XML Sitemaps, quindi rimuovi le pagine che non desideri includere modificando il file in un editor di testo. Per utilizzare la sitemap XML, devi caricarla sul tuo server o su una posizione online esterna. Successivamente, aggiungi l'URL della sitemap in Chatbot > Addestramento > Sito web.
• Puoi caricare file di grandi dimensioni e la tua sitemap XML con un servizio come TMP Files.
• Appena completato l'addestramento, i file caricati vengono rimossi.
• Per aggiungere nuove fonti di addestramento, basta riaddestrare il chatbot. Le fonti di addestramento precedenti non andranno perse e verranno aggiunte solo le nuove fonti.
• Gli articoli di Chat G Tech Group vengono utilizzati automaticamente come fonti di addestramento.
• Le conversazioni di Chat G Tech Group vengono utilizzate automaticamente come fonti di addestramento. L'addestramento viene eseguito tramite cron job ogni 24 ore. Vengono utilizzati solo i messaggi degli utenti e degli agenti, i messaggi del chatbot vengono ignorati.
• Se utilizzi la versione cloud, ci sono limiti di caratteri per l'addestramento del chatbot. Tuttavia, se utilizzi la versione PHP o WP, non ci sono limiti imposti. Puoi visualizzare i limiti di caratteri qui.
• Il modello di embedding è essenziale per l'addestramento del tuo chatbot e per gestire tutti i messaggi degli utenti. Attualmente utilizziamo il modello text-embedding-3-small. È necessario per questi scenari e non può essere disabilitato o modificato. Puoi trovare informazioni sui prezzi su OpenAI Pricing. Controlla i prezzi per il modello text-embedding-3-small nella sezione Embedding models.
• Le risposte generate da OpenAI hanno la funzione di includere nella risposta un link alla pagina del sito web corrispondente da cui è stata tratta la risposta.
• Vai su Chatbot > Addestramento > Informazioni, e clicca sul pulsante Elimina tutti i dati di addestramento per rimuovere tutti i dati di addestramento precedenti per il chatbot.
• Gli embeddings sono memorizzati come file JSON nella cartella degli upload di Chat G Tech Group e sono protetti utilizzando l'approccio password-by-filename.