Widget Integrabile
Il widget di Queria e un'interfaccia chat completa che puoi incorporare in qualsiasi sito web, portale o applicazione. Offre le stesse funzionalita AI della piattaforma principale in un formato compatto e personalizzabile.
Cos'e il Widget
Il widget e una finestra di chat che appare nell'angolo del tuo sito web. I visitatori possono interagire con l'AI di Queria direttamente dalla tua pagina, senza dover accedere alla piattaforma. Il widget utilizza l'architettura Cog-RAG per fornire risposte basate sui tuoi documenti aziendali.
Casi d'Uso
- Assistenza clienti: risposte automatiche basate sulla documentazione aziendale
- Ricerca documentale: permetti agli utenti di cercare nei tuoi archivi tramite linguaggio naturale
- Supporto tecnico: manuali e guide accessibili tramite domande conversazionali
- FAQ intelligenti: sostituisci le FAQ statiche con un assistente AI dinamico
- Portali interni: integra la ricerca AI in intranet e strumenti aziendali
Come Integrare il Widget
Snippet HTML
Aggiungi il seguente codice prima della chiusura del tag </body> nel tuo sito:
<script
src="https://tuo-dominio-queria/widget/embed.js"
data-api-key="LA_TUA_API_KEY"
data-theme="light"
data-position="bottom-right"
async>
</script>Parametri di Configurazione
| Parametro | Valori | Descrizione |
|---|---|---|
data-api-key | Stringa | Chiave API della tua azienda (obbligatorio) |
data-theme | light, dark, auto | Tema grafico del widget |
data-position | bottom-right, bottom-left | Posizione sullo schermo |
data-primary-color | Codice esadecimale | Colore principale del widget |
data-title | Testo | Titolo mostrato nell'intestazione |
data-placeholder | Testo | Testo placeholder nel campo di input |
data-welcome | Testo | Messaggio di benvenuto iniziale |
data-language | it, en | Lingua dell'interfaccia |
Funzionalita del Widget
Il widget offre un sottoinsieme mirato delle funzionalita della piattaforma:
- Conversazione AI: stesse capacita di comprensione e generazione della piattaforma completa
- Risposte basate su topic: limita le risposte ai topic configurati per il widget
- Citazioni tracciabili: ogni risposta include riferimenti alle fonti utilizzate
- Badge sorgenti: identificazione visiva della provenienza delle informazioni
- Responsive: si adatta automaticamente a desktop, tablet e smartphone
- Storico sessione: la conversazione persiste durante la sessione del browser
Autenticazione
Il widget si autentica tramite una chiave API specifica per la tua azienda:
- La chiave viene generata dal pannello di amministrazione di Queria
- Ogni chiave e associata a un'azienda e ai suoi documenti
- Puoi rigenerare la chiave in qualsiasi momento per sicurezza
- La chiave API determina quali documenti e fonti sono accessibili dal widget
Personalizzazione
Aspetto Grafico
Adatta il widget al look del tuo sito:
- Colore primario: bottone, intestazione e accenti
- Tema chiaro o scuro: coerente con il design del tuo sito
- Modalita auto: segue le preferenze di sistema dell'utente
- Titolo personalizzato: mostra il nome del tuo servizio
Comportamento
Configura il comportamento del widget:
- Messaggio di benvenuto: primo messaggio mostrato all'apertura
- Topic predefiniti: limita le risposte a specifiche aree tematiche
- Lingua: interfaccia in italiano o inglese
Endpoint API Pubblici
Il widget comunica con la piattaforma tramite endpoint pubblici dedicati:
- Chat streaming: invio messaggi e ricezione risposte in streaming
- Sessioni: gestione della sessione conversazionale
- Upload: caricamento documenti temporanei per analisi
Tutti gli endpoint richiedono la chiave API nell'intestazione della richiesta.
Considerazioni Tecniche
- Il widget viene caricato in modo asincrono e non rallenta il tuo sito
- Le comunicazioni sono cifrate tramite HTTPS
- Il widget e compatibile con tutti i browser moderni
- Il peso dello script e contenuto per non impattare sulle prestazioni della pagina
Suggerimento
Configura un topic specifico per il widget, cosi le risposte saranno focalizzate sugli argomenti rilevanti per i visitatori del tuo sito. Carica nella Knowledge Base associata al topic le FAQ e i documenti piu importanti per i tuoi utenti.
Queria v3.1.0 -- Architettura Cog-RAG