Come funziona questa demo
Crema & Ferro è un negozio inventato costruito attorno a un assistente agli acquisti. Questa pagina spiega quali alternative sono state valutate a settembre 2026 e come è fatta quella scelta.
Le alternative valutate
- Assistenti SaaS per e-commerce
- Intercom Fin, Gorgias, Tidio Lyro, Zendesk AI
- Pronti in poche ore, con ticketing e passaggio all'operatore. Si pagano a conversazione, il widget non si personalizza e non possono mostrare schede prodotto o modificare il carrello.
- Assistenti della piattaforma
- Shopify Sidekick e storefront agentici
- Ottimi se il negozio è già su Shopify, ma legano alla piattaforma. Sidekick aiuta il commerciante, non il cliente.
- Commercio dentro i chatbot
- Agentic Commerce Protocol (OpenAI), Universal Commerce Protocol (Google)
- Servono a farsi trovare dentro ChatGPT o Gemini, non ad assistere chi è già sul proprio sito. Sono il passo successivo, non l'alternativa.
- Kit di un singolo fornitore
- OpenAI ChatKit e Agent Builder
- Belle interfacce, ma legate ai modelli di un solo fornitore; Agent Builder chiude a novembre 2026.
- Soluzione su misura (scelta)
- Next.js 16, Vercel AI SDK 7, AI Elements, PostgreSQL con pgvector
- Controllo completo: il modello usa strumenti tipizzati sul vero catalogo, l'interfaccia mostra prodotti, confronti e ordini, e il fornitore del modello si cambia da configurazione.
Cosa succede quando scrivi al Barista
- 1Il messaggio parte dal pannello (React, useChat) verso /api/chat insieme alla pagina che stai guardando.
- 2Il server controlla dimensione e limiti di frequenza, poi chiama il modello con le istruzioni del negozio e sei strumenti.
- 3Il modello decide quali strumenti usare; ogni chiamata legge o modifica il database PostgreSQL.
- 4Testo e risultati tornano in streaming: i risultati diventano schede prodotto, tabelle di confronto, stato dell'ordine.
- 5Le azioni delicate, come aprire una richiesta di assistenza, aspettano la tua conferma.
Gli strumenti del Barista
- searchProducts
- Ricerca ibrida nel catalogo: testo in italiano più similarità semantica, con filtri su categoria e prezzo.
- getProduct / compareProducts
- Scheda tecnica e confronto affiancato, letti dal database.
- addToCart / getCart
- Modificano il carrello vero del visitatore, lo stesso mostrato nell'intestazione.
- trackOrder
- Stato dell'ordine solo se numero ed email corrispondono.
- searchHelp
- Recupera le sezioni pertinenti del centro assistenza (RAG) e il Barista cita la fonte.
- createSupportTicket
- Apre una richiesta per un operatore solo dopo la conferma del cliente, con approvazione firmata lato server.
Modelli e costi
Le risposte arrivano dal router gratuito di OpenRouter (openrouter/free), che sceglie di volta in volta un modello open con supporto agli strumenti: sotto ogni risposta vedi quale. Il costo è zero, in cambio la qualità e la velocità variano e c'è un limite giornaliero di messaggi. Con una chiave a pagamento basta cambiare due variabili d'ambiente.
La ricerca semantica usa un modello di embedding multilingue che gira sul server stesso (multilingual-e5-small), quindi non costa nulla per richiesta. Catalogo, ordini e centro assistenza sono in PostgreSQL con l'estensione pgvector.
Sicurezza e privacy
- Le chiavi dei modelli restano sul server; il browser parla solo con questo sito.
- Limiti per visitatore e giornalieri, lunghezza massima dei messaggi e dei turni del modello.
- Il modello non sceglie prezzi né dati: li legge dagli strumenti, e gli ordini richiedono l'email giusta.
- Le conversazioni vengono salvate con un identificativo anonimo dell'IP (hash) per migliorare la demo. I fornitori dei modelli gratuiti possono registrare i messaggi: non scrivere dati personali reali.