Vai al contenuto

Workspace Multi-Bot

Gestione Bot Gestione Bot

FRENZY.BOT supporta l'esecuzione di molteplici bot AI isolati da un'unica installazione. Ogni bot ha la propria base di conoscenza, impostazioni, accesso al team, conversazioni e widget — completamente separati da ogni altro bot sullo stesso server.

Perché usare il multi-bot?

  • Agenzie: Gestisci i bot per più clienti da un'unica dashboard.
  • Aziende multi-brand: Ogni marchio ha il proprio assistente AI con branding e dati separati.
  • Dipartimenti: Vendite, Supporto e HR possono avere ciascuno un bot specializzato senza sovrapposizione di dati.
  • Testing: Crea un bot di staging per testare le modifiche prima di applicarle in produzione.

Come funziona

Isolamento dei dati

Ogni bot ottiene i propri:

Componente Isolamento
Base di conoscenza Collezione vettoriale Qdrant separata per bot
File Memorizzati in data/uploads/{bot_id}/
Impostazioni Impostazioni con ambito bot nel database
Conversazioni Filtrate per bot_id
Lead Relativi al bot che li ha acquisiti
Analytics Metriche per bot e tracciamento del funnel
Widget Codice di incorporamento separato con data-bot-id univoco
Log di attività Relativi alle azioni a livello di bot

Membri del team

  • Gli amministratori possono accedere a tutti i bot.
  • Gli utenti regolari vedono solo i bot a cui sono stati assegnati.
  • Quando viene creato un nuovo bot, il creatore viene aggiunto automaticamente come membro.

Creazione di un nuovo bot

  1. Fai clic sul menu a discesa del workspace in alto a destra nella testata della dashboard.
  2. Fai clic su + New Bot.
  3. Compila i dettagli:
    • Bot name: Un'etichetta leggibile (es. "Assistente Vendite").
    • Bot ID: Slug generato automaticamente dal nome (es. sales-assistant). Puoi personalizzarlo.
  4. Fai clic su Create.

Il sistema automaticamente:

  • Crea una nuova collezione vettoriale Qdrant per il bot.
  • Configura l'archiviazione file isolata.
  • Ti aggiunge come primo membro.

Formato Bot ID

I Bot ID devono essere alfanumerici minuscoli con solo trattini, tra 3 e 64 caratteri. Questo ID viene utilizzato nel codice di incorporamento e nelle chiamate API — scegli qualcosa di chiaro e permanente.

Passare da un bot all'altro

Usa il menu a discesa del workspace nella testata della dashboard:

  1. Fai clic sul nome del bot corrente nella testata.
  2. Seleziona il bot a cui vuoi passare.
  3. La dashboard si ricarica con i dati di quel bot.

La tua selezione viene salvata in un cookie di sessione, quindi persiste tra i caricamenti della pagina.

Gestione dei bot

Pagina di gestione bot

Vai al menu a discesa del workspace → Manage All Bots per vedere ogni bot in una griglia di schede:

  • Statistiche per bot: File, messaggi, sessioni, lead, sessioni attive.
  • Badge bot corrente: Mostra su quale bot stai lavorando attualmente.
  • Badge bot predefinito: Contrassegna il bot predefinito del sistema.
  • Crea / Modifica / Elimina: Gestione completa del ciclo di vita da questa pagina.

Modificare un bot

Fai clic sulla scheda di un bot per aggiornare il suo nome o la sua descrizione. Il Bot ID non può essere modificato dopo la creazione.

Eliminare un bot

L'eliminazione di un bot esegue una pulizia a cascata:

  • Rimuove la collezione vettoriale Qdrant.
  • Elimina tutti i file, messaggi, sessioni, lead e log di attività.
  • Rimuove tutte le appartenenze al team per quel bot.

Protezione bot predefinito

Il bot predefinito non può essere eliminato. Questo previene la rimozione accidentale del tuo bot principale.

Membri del team

Aggiungere membri

  1. Apri la pagina di gestione bot.
  2. Seleziona un bot.
  3. Fai clic su Members → Add Member.
  4. Scegli un utente dal menu a discesa.

Rimuovere membri

Seleziona un membro e fai clic su Remove. L'utente non vedrà più questo bot nel suo menu a discesa del workspace.

Regole di accesso

  • Gli Admin vedono sempre tutti i bot indipendentemente dall'appartenenza.
  • I ruoli Manager / Staff vedono solo i bot a cui sono stati esplicitamente aggiunti.
  • L'appartenenza è separata dal RBAC — un utente può essere membro di un bot ma essere comunque limitato dai permessi del modulo del suo ruolo.

Incorporamento widget per bot

Ogni bot ha il proprio codice di incorporamento per il widget:

<script 
  src="https://yourdomain.com:8321/chatbot-widget/v1/js/loader.js"
  data-bot-id="sales-assistant"
  data-bot-name="Sales Assistant"
  data-theme-color="#3b82f6"
  data-backend-url="https://yourdomain.com:8321"
  async>
</script>

L'attributo data-bot-id determina quale bot gestisce la conversazione. Il widget di ogni bot utilizza i propri:

  • System prompt
  • Branding e colori
  • Messaggio di benvenuto e domande suggerite
  • Configurazione del modulo lead
  • Impostazioni della lingua

Vai su Dashboard → Embed per generare lo snippet corretto per il bot attualmente selezionato.

FAQ

D: C'è un limite al numero di bot che posso creare?

  • Non c'è un limite predefinito. I limiti pratici dipendono dalle risorse del tuo server (RAM, disco, CPU).

D: Due bot possono condividere la stessa base di conoscenza?

  • Non direttamente. Ogni bot ha la sua collezione Qdrant. Puoi caricare gli stessi file su più bot.

D: Cosa succede ai dati di un bot quando lo elimino?

  • Tutto viene eliminato: collezione vettoriale, file, conversazioni, lead, log di attività e appartenenze. Questa azione è permanente e non può essere annullata.

D: Posso trasferire un bot su un altro server?

  • Esporta i file del bot e i record del database, quindi importali sul server di destinazione. Uno strumento di migrazione integrato è in fase di sviluppo.

D: I bot condividono la stessa chiave API di OpenRouter?

  • Sì. La connessione al provider AI è a livello di server, condivisa tra tutti i bot. Ogni bot può avere la propria selezione del modello e le proprie impostazioni di comportamento.