OAI / Software e integrazione
Assistente AI per documenti, dati e IoT
Piattaforma con wiki e chat che collega documenti operativi, database e telemetria IoT attraverso un orchestratore condiviso fra interfaccia web e messaggistica.
/ context
Il problema tecnico
Serviva un punto di accesso a conoscenza operativa, dati di dominio e misure IoT, mantenendo i sistemi gestionali già utilizzati. La risposta dell’assistente doveva derivare dalle fonti e dagli strumenti disponibili per il contesto dell’utente, con un percorso di esecuzione ricostruibile.
01
Una piattaforma per organizzare la conoscenza
Abbiamo realizzato una wiki multi-tenant con chat, frontend React PWA in TypeScript e backend FastAPI. L’interfaccia include il supporto alle lingue tramite i18next; autenticazione e collegamenti applicativi utilizzano JWT e OAuth. PostgreSQL costituisce la base dati, con SQLAlchemy e migrazioni Alembic per gestire l’evoluzione dello schema. La struttura monorepo raccoglie frontend, servizi e componenti condivisi, rendendo espliciti i collegamenti fra documentazione operativa e funzioni applicative.
02
Dalla domanda agli strumenti
Il runtime LangGraph classifica il dominio della richiesta e costruisce un piano scegliendo gli strumenti da un catalogo. L’esecuzione avviene in sequenza; i risultati raccolti alimentano la sintesi e possono portare a una ripianificazione limitata. Abbiamo integrato ricerca nella wiki, accesso in sola lettura ai database di dominio tramite composizione SQL con contesto tenant e un collegamento ThingsBoard attraverso un agente MCP. OpenRouter supporta le chiamate ai modelli per conversazione e decisioni del flusso.
03
Canali, integrazioni e distribuzione
La chat web e il canale WhatsApp utilizzano lo stesso orchestratore, così i connector restano parte di un runtime comune. L’integrazione calendario comprende sincronizzazione e operazioni di scrittura controllate; le API restituiscono gli eventi della conversazione anche tramite SSE. Il progetto comprende schema dati e migrazioni, configurazione di distribuzione con Nginx HTTPS e unità systemd, oltre alla documentazione tecnica. Gli strumenti di pianificazione e i canali di consegna completano il perimetro delle integrazioni applicative.
/ output
Cosa comprende il lavoro
- Wiki e chat multi-tenant
- Runtime con catalogo strumenti
- Connector SQL, IoT e calendario
- Integrazione del canale di messaggistica
- Schema dati, migrazioni e configurazione di distribuzione
/ contact
Un sistema da progettare?
Partiamo da funzioni, interfacce e vincoli. Raccontaci il tuo progetto.