Configurazione
Area di configurazione della Console — modelli AI, avatar, progetti, knowledge base, strumenti, flussi, widget e webhook.
L'area Configurazione della Console contiene tutto ciò che definisce il comportamento del tuo assistente: quale modello AI usa, come si presenta, quali dati consulta, quali azioni può eseguire e come notifica i tuoi sistemi.
Prima di iniziare
Se è la tua prima configurazione, segui la Guida rapida: ti porta a un assistente pubblicato in circa 15 minuti con le impostazioni predefinite.
Ordine consigliato di configurazione
Le entità della piattaforma hanno dipendenze precise. Configurale in questo ordine per evitare di dover tornare indietro.
Modello AI
Scegli il provider e il modello, imposta i parametri di generazione e scrivi il prompt di sistema. Senza un modello attivo nessun progetto può rispondere.
Avatar
Definisci nome, immagine, tono di voce, messaggi di benvenuto e di fallback, orari di disponibilità e lingue supportate.
Progetto
Crea il contenitore che unisce modello, avatar, knowledge base e canali. Il progetto genera la chiave usata dal widget e dalle API.
Knowledge base
Carica documenti, collega siti web o database. Attendi il completamento dell'indicizzazione prima di collaudare le risposte.
Strumenti
Registra le funzioni che il modello può invocare per leggere o scrivere sui tuoi sistemi (disponibilità, prenotazioni, anagrafiche).
Flussi conversazionali
Definisci i percorsi deterministici che devono avere priorità sulla generazione libera del modello.
Widget Builder
Componi le schede visive che l'assistente restituisce in chat (slot disponibili, elenco medici, conferme).
Webhook
Notifica i tuoi sistemi quando accadono eventi rilevanti: sessioni, prenotazioni, documenti, fatturazione.
Mappa delle dipendenze
| Entità | Dipende da | Bloccante se assente | Riutilizzabile tra progetti |
|---|---|---|---|
| Modello AI | — | Sì, il progetto non risponde | Sì |
| Avatar | — | No, si usa l'avatar predefinito | Sì |
| Progetto | Modello AI | Sì | — |
| Knowledge base | — | No, l'assistente risponde solo dal prompt | Sì |
| Strumento | Endpoint raggiungibile | No | Sì |
| Flusso | Progetto, strumenti citati | No | No |
| Widget | Nodi della libreria | No | Sì |
| Webhook | Progetto (o tenant) | No | Sì |
| Widget BluBot | Progetto pubblicato, domini autorizzati | Sì | — |
Pubblicazione
Le modifiche a modelli, avatar, flussi e widget diventano effettive in produzione solo dopo la pubblicazione del progetto. In ambiente di sviluppo sono immediate.
Dove trovi ogni cosa
Il menu laterale della Console espone le otto sezioni seguenti.
Modelli AI
Provider, modello, temperatura, prompt di sistema, fallback e budget.
Avatar
Identità dell'assistente: nome, immagine, tono, messaggi e orari.
Progetti
Chiavi di progetto, domini autorizzati, ambienti e pubblicazione.
Widget Builder
Composizione visiva delle schede e motore di template con $bind.
Flussi conversazionali
Trigger, condizioni, azioni, rami e integrazione con WhatsApp.
Strumenti
Function calling: schema JSON, endpoint, autenticazione e retry.
Webhook
Eventi, segreto di firma, log di consegna, retry e dead letter.
Knowledge base
Sorgenti dati, OCR, chunking, indicizzazione e qualità delle risposte.
Permessi richiesti
Per accedere all'area Configurazione serve un ruolo con i permessi seguenti.
| Permesso | Consente |
|---|---|
identity:projects:read | Visualizzare progetti e configurazioni |
identity:projects:write | Creare e modificare progetti |
identity:models:write | Modificare modelli e prompt di sistema |
identity:datastore:write | Caricare e reindicizzare documenti |
identity:webhooks:write | Creare e ruotare i segreti dei webhook |
Assegna i permessi come descritto in Ruoli e permessi.
Passi successivi
- Automazioni e RPA — collega la piattaforma ai tuoi robot software.
- Riferimento API — usa le stesse funzionalità in modo programmatico.
- Supporto — apri un ticket se una configurazione non produce l'effetto atteso.