Come installare Flowise su Saplo: il visual builder per agenti e chatbot AI senza codice

Costruire il tuo chatbot o agente AI di solito significa una di due cose: o scrivere integrazioni con l'API del modello linguistico da zero, o un abbonamento a pagamento a una piattaforma SaaS chiusa, attraverso la quale passano tutti i dati dei clienti. Flowise è una terza via: un creatore visivo e aperto di agenti e chatbot AI, in cui colleghi il modello LLM, i tuoi strumenti (chiamate API, funzioni) e i database vettoriali per la ricerca di documenti (RAG) in un grafico di nodi trascinabili con il mouse, ed esponi il flusso finito come endpoint API o widget di chat da incorporare nel tuo sito web. In questo tutorial, ti mostreremo come installare Flowise su Saplo.

Cos'è Flowise

Flowise funziona su un canvas con nodi: aggiungi un nodo di modello linguistico (OpenAI, Anthropic, un modello locale tramite Ollama e altri), ci colleghi i nodi degli strumenti, ad esempio una chiamata API esterna o la tua funzione, e opzionalmente un database vettoriale con i tuoi documenti, in modo che l'agente risponda basandosi sulla conoscenza aziendale e non solo sulla conoscenza generale del modello. Colleghi il tutto con frecce senza scrivere codice di integrazione, lo testi nel Pannello e lo pubblichi come endpoint API o come widget di chat pronto per essere incorporato nella pagina del cliente. Questa è una nicchia diversa da n8n, che è un motore di automazione generico senza progettare prima la logica dell'agente, ed è diversa da Open WebUI, che fornisce solo l'interfaccia di chat per un modello pronto, ma non consente di costruire la propria logica dell'agente con strumenti e memoria. Puoi trovare la descrizione del servizio anche sulla pagina di hosting Flowise su Saplo.

A chi si rivolge Flowise

• Agenzie o sviluppatori che creano funzionalità AI per i clienti - chatbot, assistenti o motori di ricerca di documenti, senza dover scrivere integrazioni API del modello da zero per ogni progetto.
• Aziende che desiderano un proprio chatbot in grado di rispondere basandosi su documenti aziendali - senza dover affidare i loro contenuti a uno strumento SaaS esterno, i dati RAG rimangono sul tuo Box.
• Chiunque testi e confronti diversi modelli LLM e strumenti in un unico posto - prima di implementare una soluzione specifica in produzione.

Requisiti

Per installare Flowise su Saplo, ti serviranno:

• Un Box con Docker in esecuzione (il motore lo abilita automaticamente durante l'installazione dal Catalogo delle applicazioni; è richiesto il nesting nel container, che Saplo offre di default),
• Almeno 2 GB di RAM libera sul Box e 8 GB di spazio su disco. L'immagine ufficiale di Flowise include Chromium per i nodi che eseguono lo scraping di pagine web e file PDF, quindi è più pesante di una tipica applicazione a singolo container e non si adatta, insieme al sistema operativo di Box, ai piani S o M. Il piano più economico in grado di supportarlo è Box M a 63 € all'anno,
• Un Dominio o sottodominio *.saploapp.pl incluso in ogni piano, dove sarà ospitato il pannello di Flowise,
• La tua chiave API per il fornitore del modello linguistico (OpenAI, Anthropic o altro), che inserirai solo durante la creazione del flusso nel pannello, non al momento dell'installazione.

Non hai bisogno di alcun database esterno per l'installazione. Flowise memorizza di default i flussi e i dati di accesso in un file SQLite locale nel volume dati del container.

Installazione passo dopo passo

1. Nel Pannello Saplo, vai su Catalogo delle applicazioni e seleziona Flowise (categoria "Business").
2. Scegli un Box M o superiore con almeno 2 GB di RAM libera, dove verrà installato Flowise, e il dominio o sottodominio sotto cui funzionerà il pannello.
3. Conferma l'installazione. Il motore installa un container Docker con l'immagine ufficiale flowiseai/flowise nella versione fissata a 3.1.3, lo espone solo sul loopback del Box e lo collega a nginx, che lo serve sotto il dominio indicato con SSL gratuito. All'esterno è esposta solo la porta 443, non la porta raw del container.
4. Il motore attende che il container si avvii effettivamente e lo verifica al termine di docker compose up, perché il successo del comando non significa che il processo interno non sia fallito un attimo dopo.
5. Al termine dell'installazione, il pannello Flowise è disponibile sotto il dominio indicato.

Prima configurazione

Flowise, come n8n, ha un sistema di account integrato e non genera automaticamente i dati di accesso durante l'installazione, ma li richiede al primo accesso al Pannello.

1. Vai all'indirizzo del Dominio che hai indicato durante l'installazione.
2. Al primo accesso, Flowise mostrerà la schermata di creazione dell'account: inserisci il tuo indirizzo e-mail e la password. Flowise genera da solo i segreti di sessione al primo avvio e li salva nel volume dei dati, quindi il riavvio del container non disconnette tutti gli utenti.
3. Dopo aver effettuato l'accesso, verrai indirizzato all'elenco dei flussi. Fai clic su Add New, scegli Chatflow per un bot semplice o Agentflow per un agente con più passaggi e strumenti.
4. Sulla tela vuota, aggiungi un nodo del modello linguistico, ad esempio ChatOpenAI o ChatAnthropic, e collega la tua chiave API per il provider selezionato nelle sue impostazioni.
5. Facoltativamente, aggiungi un nodo strumento (chiamata API personalizzata, funzione) o un nodo di database vettoriale con i tuoi documenti, se desideri che l'agente risponda in base alla conoscenza aziendale (RAG).
6. Collega i nodi con le frecce, testa il flusso nella finestra di chat sulla destra e, quando funziona, pubblicalo come endpoint API o widget di chat da incorporare nella pagina del cliente dalla scheda Embed.

Domande frequenti

Flowise richiede un database esterno? No, per impostazione predefinita archivia i flussi e gli account in un file SQLite locale nel volume dei dati del container. Non è necessario impostare un database separato.

Quali modelli linguistici posso usare? Qualsiasi provider compatibile con i nodi Flowise: OpenAI, Anthropic, e anche modelli locali tramite Ollama. In ogni caso, hai bisogno della tua chiave API o di un modello in esecuzione localmente, Flowise non fornisce le chiavi da solo.

Perché Flowise richiede Box M e non Box S? L'immagine Docker ufficiale include Chromium per i nodi di scraping di pagine e file PDF, il che la rende significativamente più grande di una tipica applicazione a contenitore singolo e richiede più RAM di quella che il piano Box S può contenere insieme al sistema operativo Box.

In cosa differisce Flowise da n8n disponibile nel catalogo Saplo? n8n è un motore di automazione generale, in cui la logica dell'agente AI è una delle possibilità, non il punto di partenza. Flowise è progettato dal primo nodo attorno al modello LLM, agli strumenti e ai database vettoriali, quindi si adatta meglio quando stai costruendo specificamente un agente o un chatbot, piuttosto che un flusso di integrazione generale tra le applicazioni.

I dati in Flowise vengono sottoposti a backup automatico? Dipende dal piano Box acquistato, il backup funziona a livello dell'intero Box, proprio come con altre applicazioni del catalogo, non è una funzione separata di Flowise stesso.

Se hai domande sull'installazione di Flowise sul tuo Box o sulla creazione del tuo primo agente o chatbot AI, scrivici, ti aiuteremo con la configurazione iniziale. Una descrizione dei piani e del listino prezzi dell'hosting è disponibile sulla pagina Flowise su Saplo.