Passa al contenuto principale

Concetti Chiave

Prima di esplorare i dettagli tecnici di Emblema, è importante comprendere i concetti fondamentali che guidano l'architettura e il funzionamento della piattaforma.

📚 Terminologia Essenziale​

Document Processing​

Il cuore di Emblema è la capacità di processare documenti in modo intelligente. Ma cosa significa esattamente?

Loading diagram...

Componenti chiave:

  • Processing: MinerU per documenti, WhisperX per audio/video
  • Chunking: Divisione basata su token (512 default) con overlap di 75
  • Embedding: BGE-M3 genera vettori a 1024 dimensioni
  • Indicizzazione: Storage in Milvus per ricerca vettoriale veloce

La ricerca semantica va oltre le parole chiave, comprendendo il significato della richiesta.

Esempio pratico:

  • Ricerca tradizionale: "contratto cliente Milano 2023"
  • Ricerca semantica: "accordi commerciali con aziende lombarde dello scorso anno"

Entrambe trovano gli stessi documenti perché l'AI comprende che:

  • "accordi commerciali" ≈ "contratto"
  • "aziende lombarde" ≈ "cliente Milano"
  • "scorso anno" ≈ "2023"

Vector Embeddings​

Gli embeddings sono rappresentazioni numeriche del significato di un testo. Immagina ogni documento come un punto in uno spazio multidimensionale dove documenti simili sono vicini tra loro.

Loading diagram...

Knowledge Base​

Una Knowledge Base in Emblema è più di una semplice collezione di documenti. È un ecosistema intelligente di informazioni interconnesse.

Caratteristiche:

  • Auto-organizzazione: I contenuti si organizzano automaticamente
  • Relazioni dinamiche: Collegamenti tra documenti creati dall'AI
  • Evoluzione continua: Si arricchisce ad ogni interazione

🏗️ Pattern Architetturali​

Microservizi​

Emblema adotta un'architettura a microservizi dove ogni componente ha una responsabilità specifica:

Loading diagram...

Vantaggi:

  • Scalabilità indipendente: Ogni servizio scala secondo necessità
  • Resilienza: Un problema non compromette l'intero sistema
  • Sviluppo parallelo: Team diversi su servizi diversi

Event-Driven Architecture​

Gli eventi guidano le interazioni tra i servizi:

Loading diagram...

Architettura a Servizi​

Ogni servizio backend in Emblema segue principi di design modulare:

  • Una responsabilità chiara: Ogni servizio ha un compito specifico
  • API ben definite: Interfacce RESTful o GraphQL documentate
  • Stato isolato: Nessuna condivisione diretta di database
  • Deploy indipendente: Containerizzazione con Docker

🛠️ Tecnologie Chiave​

Docker & Containerizzazione​

Tutti i componenti di Emblema sono containerizzati per garantire:

  • Portabilità: Funziona ovunque allo stesso modo
  • Isolamento: Nessun conflitto tra dipendenze
  • Riproducibilità: Ambiente identico in dev/staging/prod

Vector Database (Milvus)​

Milvus è il database specializzato per la ricerca semantica:

  • Ottimizzato per vettori: Query su miliardi di embeddings
  • Ricerca ibrida: Combina filtri tradizionali e semantici
  • Scalabilità orizzontale: Cresce con i tuoi dati

Message Queue (Redis + Celery)​

La coda di messaggi gestisce l'elaborazione asincrona:

  • Affidabilità: Nessun task viene perso
  • Priorità: Task urgenti processati prima
  • Retry automatico: Gestione intelligente degli errori

LiteLLM​

Gateway unificato per accedere a diversi modelli AI:

  • Multi-provider: OpenAI, Anthropic, modelli locali
  • Fallback automatico: Se un provider fallisce, usa un altro
  • Cost optimization: Sceglie il modello più economico per il task

🔄 Workflow Operativi​

Document Lifecycle​

Loading diagram...

Query Processing​

Quando un utente fa una ricerca:

  1. Comprensione: L'AI analizza l'intento della query
  2. Espansione: Aggiunge sinonimi e concetti correlati
  3. Ricerca: Interroga il vector database
  4. Ranking: Ordina per rilevanza semantica
  5. Presentazione: Formatta i risultati per l'utente

Chat Interaction​

Le conversazioni seguono un flusso intelligente:

Loading diagram...

🎯 Principi di Design​

User-Centric​

Ogni decisione parte dall'esperienza utente:

  • Semplicità: Complessità nascosta dietro interfacce intuitive
  • Feedback immediato: L'utente sa sempre cosa sta succedendo
  • Personalizzazione: Si adatta al modo di lavorare di ciascuno

Data Privacy by Design​

La privacy non è un'aggiunta, è nel DNA:

  • Segregazione dati: Ogni tenant isolato
  • Crittografia: A riposo e in transito
  • Audit trail: Ogni accesso tracciato

Extensibility First​

Progettato per crescere:

  • Plugin architecture: Aggiungi funzionalità senza modificare il core
  • API aperte: Integra qualsiasi sistema
  • Customizzazione: Adatta alla tua realtà aziendale

💡 Best Practices​

Per gli Sviluppatori​

  • Usa sempre le API documentate
  • Segui i pattern esistenti
  • Testa in ambiente isolato
  • Documenta le modifiche

Per gli Amministratori​

  • Monitora le metriche chiave
  • Pianifica la capacità
  • Automatizza i backup
  • Mantieni aggiornato

Per gli Utenti​

  • Organizza i contenuti con tag
  • Usa nomi descrittivi
  • Sfrutta la ricerca avanzata
  • Fornisci feedback

🔍 Approfondimenti​

Ogni concetto qui introdotto sarà esplorato in dettaglio nelle sezioni successive:

🚀 Prossimo passo: Esplora i Principi di Architettura che guidano le scelte tecniche di Emblema.

Questa pagina ti è stata utile?