Loading…
Integrazione dell’IA — una piattaforma, due modi di agire
Due prodotti avevano bisogno di assistenti capaci di comprendere dati aziendali reali senza inventare informazioni né apportare modifiche rischiose. Questo progetto usa un’unica base di assistente riutilizzabile per entrambi i casi d’uso.
- Ruolo
- Ingegneria di applicazioni IA — ho progettato e realizzato un nucleo di assistente riutilizzabile e due adattatori specifici per il business, con retrieval, azioni con intervento umano e la logica di instradamento che li collega.
- Stack
- Vercel AI SDKNext.jsTypeScriptZustandOpenAI API
Panoramica
Chat, streaming, cronologia e artefatti vivono in un’unica shell condivisa. La logica di business — ciò che l’assistente sa e può fare davvero — è intercambiabile. Un adattatore deve solo consultare i dati in sicurezza. L’altro deve agire in sicurezza su dati reali. Stessa base, profili di rischio opposti.
La maggior parte delle funzionalità IA viene costruita una volta, aggiunta a posteriori e poi riscritta da zero per l’app successiva — questo invece è un nucleo riutilizzabile, con due prodotti molto diversi collegati.
Interfaccia
Una shell, due assistenti
La shell dell’assistente
Cronologia delle chat, risposte in streaming e artefatti — la parte riutilizzabile che nessuno dei due adattatori deve ricostruire.
Interfaccia
Una shell, due assistenti
La shell dell’assistente
Cronologia delle chat, risposte in streaming e artefatti — la parte riutilizzabile che nessuno dei due adattatori deve ricostruire.
Funzionalità principali
Una shell, due compiti molto diversi
Quattro elementi che mostrano la stessa piattaforma al lavoro in direzioni opposte — trovare informazioni in sicurezza e modificare record reali in sicurezza.
Funzionalità principali
Una shell, due compiti molto diversi
Quattro elementi che mostrano la stessa piattaforma al lavoro in direzioni opposte — trovare informazioni in sicurezza e modificare record reali in sicurezza.
Non inventa mai un prodotto
Ogni raccomandazione nasce da una ricerca reale nel catalogo — nessun SKU inventato, nessun prezzo ipotizzato. Se nulla corrisponde, lo dice onestamente invece di inventare qualcosa.
La conversazione ti segue
Passi da una pagina all’altra e l’assistente continua a parlare — lo stato della chat sopravvive alla navigazione invece di azzerarsi a ogni clic.
Nulla cambia senza approvazione
L’assistente propone una modifica e attende. Una persona la conferma. Solo allora viene scritto qualcosa — e l’autorizzazione viene ricontrollata in quell’esatto momento.
Rispetta le regole dell’app
L’assistente non può vedere né toccare nulla che una persona con lo stesso ruolo non potrebbe. I permessi sono applicati a livello di dati, non solo nascosti nell’interfaccia.
Approccio tecnico
I meccanismi dietro ciascun lato — come il retrieval resta onesto e come le modifiche restano sicure.
Due pipeline, una base condivisa
La piattaforma di chat non importa mai codice di business. Ogni prodotto collega la propria logica tramite un unico contratto — così un terzo prodotto potrebbe aggiungersi senza toccare affatto il nucleo.
Una sola chiamata al modello classifica la richiesta. Tutto ciò che segue — cosa cercare, come mostrarlo — è codice semplice, non un’altra decisione dell’IA. Il modello non sceglie mai da solo il risultato del catalogo.
Il modello pianifica cosa fare e prepara una proposta — non conferma mai le proprie scritture. Una persona approva, e solo allora un passaggio separato, senza modello, ricontrolla i permessi e applica la modifica.
Cronologia, streaming e artefatti sono infrastruttura condivisa. Tutto ciò che riguarda cosa l’assistente sa e cosa gli è permesso fare vive fuori da quel nucleo — cambia da prodotto a prodotto, mai cablato nella shell.
Progetti correlati
Altri lavori in questo ambito
Sandelia AI
Una piattaforma di assistenti IA per freelance e piccole imprese — chat, streaming e flussi di approvazione con intervento umano, costruita come livello di presentazione per un backend LangGraph gestito altrove.
Shopmate
L’assistente per lo shopping basato sul retrieval citato sopra — scoperta dei prodotti, gestione del carrello e artefatti generati, tutto a partire da dati reali del catalogo. Visita Shopmate
Closer AI
L’assistente sicuro per le modifiche descritto sopra — propone cambiamenti, attende la conferma e verifica ogni scrittura prima che tocchi dati reali. Esplora la piattaforma CRM
Risultati
Una piattaforma, dimostrata in due direzioni
Un unico nucleo di assistente riutilizzabile che alimenta due prodotti con profili di rischio opposti
Assistente di retrieval senza alcun dato di catalogo inventato — ogni risultato risale a una riga reale di prodotto
Assistente di modifica in cui il modello non conferma mai le proprie scritture — ogni cambiamento viene verificato in modo indipendente prima di essere applicato
Architettura progettata per supportare un terzo adattatore senza modificare il nucleo condiviso