> For the complete documentation index, see [llms.txt](https://trust.memori.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://trust.memori.ai/plans-billing/architettura.md). # Architettura Come è costruita la piattaforma AIsuru: i componenti, l'infrastruttura e le scelte tecniche che garantiscono sicurezza e affidabilità. Come è costruita la piattaforma AIsuru: i componenti, l'infrastruttura e le scelte tecniche che garantiscono sicurezza e affidabilità. L'architettura di AIsuru segue un approccio modulare che separa chiaramente le responsabilità tra sottosistemi indipendenti. Questa separazione è ciò che consente alla piattaforma di scalare, di isolare i guasti e di adattarsi ai diversi modelli di erogazione (SaaS, PaaS, Private Cloud, on-premise). *** **I cinque blocchi funzionali** | Componente | Ruolo | | --------------- | ----------------------------------------------------------------------------------------------------------------------------- | | **Frontend** | le interfacce (dashboard, widget di chat, app mobile, app VR) da cui gli utenti gestiscono e interagiscono con gli Agenti | | **Backend** | conserva i dati di utenti, tenant, consumi e asset; gestisce autenticazione e autorizzazione | | **Engine** | il cuore della piattaforma: esegue il dialogo conversazionale, ospita il motore NLP proprietario e i dati di tutti gli Agenti | | **MCP Gateway** | il componente attraverso cui gli Agenti si collegano a strumenti e sistemi esterni (database, CRM, servizi di automazione) | | **Billing** | tiene traccia di crediti, consumi e fatturazione (solo per il piano SaaS pubblico) | La comunicazione tra backend ed engine avviene su canale cifrato. *** **Come "pensa" un Agente** Un Agente AIsuru non è un semplice involucro attorno a un modello linguistico generico. Il sistema NLP proprietario di Memori analizza ogni domanda con tecniche di comprensione semantica sviluppate internamente, e tenta prima di tutto di rispondere con la conoscenza esplicita fornita dal creatore dell'Agente. Solo quando questa conoscenza non è sufficiente — e solo se l'Agente è configurato per farlo — la piattaforma interpella un modello di intelligenza artificiale generativa esterno, fornendogli il contesto pertinente recuperato dalla base di conoscenza. **La conoscenza esplicita ha sempre la precedenza sulla generazione**: è questa la proprietà che distingue AIsuru da un generico builder di chatbot basato su un unico modello linguistico, e che garantisce al creatore dell'Agente un controllo sostanziale sulle risposte fornite ai propri utenti. Il motore NLP è addestrato e gestito internamente da Memori per ciascuna delle lingue supportate nativamente (italiano, inglese, francese): la lingua di un Agente viene definita dal suo creatore alla creazione e non può essere modificata in seguito da terzi. Le conversazioni possono comunque avvenire in molte più lingue grazie a un servizio di traduzione che opera ai margini di ogni turno di dialogo, lasciando inalterata la lingua in cui l'Agente è stato istruito. *** **Isolamento e multi-tenancy** La piattaforma è progettata per gestire in modo isolato i dati di ciascun cliente ("tenant"): * ogni tenant può vedere esclusivamente i propri Agenti, utenti e configurazioni; * ogni tenant può essere personalizzato con branding, dominio e limiti operativi propri; * i dati non transitano fra tenant diversi. *** **Integrazioni con sistemi esterni** Attraverso il **MCP Gateway**, un Agente può collegarsi a strumenti esterni — database aziendali, CRM, piattaforme di automazione — per recuperare informazioni o eseguire azioni concrete (inviare una comunicazione, aggiornare un sistema, compilare un modulo). I sistemi esterni collegati restano sempre sotto il pieno controllo del cliente: la piattaforma agisce da intermediario tecnico per l'esecuzione dell'operazione richiesta, non da titolare dei dati che vi transitano. Tutte le comunicazioni verso i server esterni avvengono su connessione cifrata (HTTPS/TLS). *** **Sicurezza e continuità** * Segregazione dei dati fra i diversi clienti (isolamento multi-tenant). * Comunicazioni cifrate fra tutti i componenti della piattaforma. * Backup regolari e procedure di disaster recovery. * Monitoraggio continuo della disponibilità dei servizi, con canali di allerta dedicati per il team tecnico. * Ciclo di sviluppo con oltre 2.000 test automatizzati eseguiti prima di ogni rilascio in produzione, oltre a verifiche manuali di qualità. Per il dettaglio sulle attività di verifica della sicurezza applicativa, vedi \[Penetration test summary]. *** **Modelli di erogazione** AIsuru è disponibile in diverse modalità, con un livello di isolamento e controllo crescente — il dettaglio è nella pagina \[Modelli di erogazione]: * **Public Cloud / SaaS** — la piattaforma pubblica su [aisuru.com](http://aisuru.com/), con registrazione libera e sistema a crediti; * **Public Cloud / PaaS** — un ambiente brandizzato su dominio dedicato, con gestione avanzata di utenti, chiavi API e consumi; * **Private Cloud** — infrastruttura con maggiore isolamento, indicata per aziende con requisiti di protezione dei dati più stringenti; * **On-premise** — la piattaforma distribuita interamente all'interno dell'infrastruttura del cliente, per il massimo controllo sui dati. Per il trattamento e la localizzazione geografica dei dati, vedi \[Data residency UE] e \[Dove sono ospitati i miei dati?]. *** #### Deployment e aggiornamenti Gli aggiornamenti della piattaforma vengono rilasciati tramite **pipeline CI/CD automatizzate**. Per la maggior parte dei componenti viene adottata una strategia di **blue-green deployment**, che garantisce continuità del servizio durante i rilasci. L'ambiente di staging è mantenuto conforme a quello di produzione per test completi prima del deploy. {% hint style="warning" %} Per i modelli PaaS, Private Cloud e On-Premise sono disponibili architetture con maggiore isolamento. Contattare il [team tecnico](mailto:dev@memori.ai) per i dettagli specifici del proprio scenario. {% endhint %}