Lavorare con l'assistente AI
L'assistente AI è installato e collegato al negozio — значит, è ora di mettersi al lavoro. In questa sezione: da dove iniziare la conversazione, come assegnargli i compiti, cosa aspettarsi da lui e cosa no, cosa sa fare da solo e come aprire parte delle sue capacità ai vostri dipendenti.
Primo contatto
Dunque, il negozio è installato, l'assistente AI è configurato. Da dove iniziare? Scrivete il primo messaggio nel modo più semplice possibile — per verificare la connessione e vedere eventuali errori, se per caso ci fossero. Per esempio:
L'assistente AI non si limiterà a rispondere «va tutto bene» sulla parola: interrogherà uno per uno ogni strumento e vi dirà che cosa ha risposto esattamente. Più o meno così:
La connessione c'è. Cartella di lavoro D:\Melbis\MyFirstShop (non è un repository git), Windows 10, sono disponibili sia PowerShell sia Bash.
Verifico che gli strumenti rispondano davvero e non siano solo dichiarati.
Bash funziona. Questa è la cartella locale del negozio Melbis Shop. Controllo anche il server MCP melbis — qui la connessione passa proprio da lui.
Verifica della connessione — tutto in ordine.
Sessione Melbis MCP:
- Negozio: MyFirstShop
- Cartella: D:\Melbis\MyFirstShop
- Login: admin (su https://melbis.net)
Il server è vincolato a questo negozio tramite una configurazione dedicata — in questa sessione non se ne aprirà nessun altro. Il programma Melbis Shop lavora sullo stesso negozio, build 6.5.1.526. Sono stati forniti 27 strumenti AI: catalogo, prodotti, ordini, prezzi, utenti, impostazioni, importazione e file.
Lato locale: sia Bash sia PowerShell rispondono, cartella di lavoro D:\Melbis\MyFirstShop, Windows 10.
Prima di iniziare il lavoro vale la pena dire due cose:
- La mia memoria su questo negozio è vuota — questa è la prima sessione, nessuna mia sessione qui è ancora stata registrata. Prima di fare qualsiasi cosa devo leggere la documentazione della piattaforma e orientarmi nel negozio. Ci vorrà del tempo e dall'esterno sembrerà silenzio — vi avviserò quando inizierò, così da non sparire in silenzio.
- Con chi sto lavorando? Il negozio chiede di registrarlo: siete il proprietario, lo sviluppatore o un dipendente con accesso esteso? Sto scrivendo con il login admin, e tutto ciò che modifico il negozio lo firma con questo nome — conviene chiarirlo prima che tocchi qualcosa.
Come vi presenterete
Come vedete, l'assistente AI vi chiederà lui stesso di chiarire il vostro ruolo nel negozio — per scegliere uno stile di comunicazione adatto. Ma il ruolo con cui vi presentate non gli conferisce i diritti di quella persona: agisce rigorosamente con il login dell'utente indicato in Melbis Shop.
Che cosa esattamente sia consentito fare a questo utente tramite l'assistente AI si vede nella sezione "System" > "Users", scheda "Operations and Access Rights", ramo "AI Assistant". A sinistra — l'albero delle operazioni, a destra — a chi sono aperte: gruppi e singoli utenti.
Le operazioni qui non sono poi così tante, e non è un caso. La maggior parte è «accesso diretto»: Memory — le note dell'assistente AI, Tools — i suoi strumenti, Direct access — i file della vetrina e il lavoro diretto con il database. È ovvio che un accesso del genere sarà riservato solo al proprietario del negozio o a uno sviluppatore di fiducia. Più sotto racconteremo come lavorano con l'assistente AI i dipendenti ordinari, senza questi super-poteri.
Perché il negozio iniziale è così semplice
Supponiamo che vi siate presentati come il proprietario di un negozio che avete appena installato e forse popolato appena con alcuni dati di base. Questo è il momento giusto per rispondere a una domanda che sicuramente vi è venuta già al primo avvio: perché il negozio iniziale è così semplice. Ora si può rispondere in modo chiaro.
La nostra esperienza nello sviluppo di software per creare negozi si avvicina ai 25 anni. Come molti, abbiamo iniziato fornendo un negozio con una vetrina standard come esempio — molti sviluppatori di piattaforme fanno ancora così oggi. Ma Melbis Shop 6 ha superato quella fase: in sei generazioni le sue possibilità sono cresciute troppo.
Capite, se cercassimo di costruire un negozio standard come esempio, vi renderemmo un cattivo servizio. Insieme all'esempio ricevereste anche i limiti inseriti fin dall'inizio, e ve ne accorgereste solo dopo anni di lavoro — quando si scoprirebbe che proprio per il vostro modello di business il negozio andava progettato diversamente, e rifarlo sarebbe già molto costoso. In sostanza, se vi serve un progetto standard, allora un vostro negozio non vi serve affatto: basta uno spazio su un marketplace, dove le possibilità unificate vengono fornite subito.
Per questo, fino a poco tempo fa, i clienti di Melbis Shop 6 erano soprattutto grandi negozi di settore che assumevano sviluppatori per il proprio progetto unico. La soglia d'ingresso era alta, e abbiamo venduto molte meno licenze rispetto a Melbis Shop 5, che partiva con funzionalità e design standard fin dall'inizio.
Senza che ve ne accorgiate, dentro Melbis Shop 6 c'è un nucleo con un'enorme esperienza, documentazione e pratica di implementazioni reali. Proprio per questo continuiamo a non proporvi un esempio standard di negozio — lo consideriamo un'offesa alla vostra intuizione imprenditoriale, catene che frenano lo slancio creativo e vi guidano lungo una strada già battuta. Invece, vi apriamo la porta a un lavoro congiunto con l'assistente AI, che vi permetterà di occuparvi delle idee e non della routine.
Da dove iniziare la vostra attività
Il nostro consiglio: la cosa migliore è iniziare dalla descrizione del vostro modello di business. E all'assistente AI non serve un business plan ben formattato e studiato in ogni dettaglio. Scrivete semplicemente come stanno le cose — come le raccontereste a un amico, quale progetto volete realizzare e cosa servirà per farlo. Le idee arriveranno man mano che il progetto si svilupperà, ed è del tutto normale. E qualcosa l'assistente AI lo chiarirà e lo suggerirà da solo.
Ecco un esempio di una prima lettera di questo tipo — un normale racconto dell'attività, senza termini tecnici e senza struttura:
La prima cosa che farà l'assistente AI sarà scomporre il tutto in punti chiari e mostrarvi un piano, prima di cambiare qualcosa:
Ecco il mio piano, ora lo eseguirò:
| # | Cosa | Con cosa |
|---|---|---|
| 1 | Valute: grivnia (principale), dollaro, euro | strumento «Valute» |
| 2 | 3 fornitori, 4 marchi | strumenti «Fornitori» e «Marchi» |
| 3 | Catalogo: 4 sezioni, 12 sottosezioni | strumento «Catalogo» |
| 4 | Caratteristiche dei prodotti (materiale, colore, dimensione…) | strumento «Caratteristiche» |
| 5 | Campi di registrazione del cliente, opzioni dell'ordine (spedizione, pagamento, stato), gruppi clienti | direttamente tramite query — non esiste uno strumento pronto per questo |
| 6 | 12 prodotti dimostrativi con immagini gratuite | caricatori di prodotti e file |
| 7 | 2 gruppi e 2 login con diritti precisi | strumento «Utenti» — dopo che chiuderete la finestra |
Fate attenzione al settimo punto: l'assistente AI ha notato che la tabella utenti è occupata da una finestra del programma aperta, e ha rimandato quella parte a dopo. Poi prosegue secondo il piano e nel frattempo racconta cosa fa e perché. Prima legge la documentazione della piattaforma e si orienta nel negozio:
Mi metto al lavoro. Prima di toccare qualcosa, devo leggere la documentazione della piattaforma e orientarmi nel negozio — non ne ho memoria, questa è la prima sessione. È una fase silenziosa e non rapida, quindi racconterò man mano, così non sembrerà un blocco.
Letto l'indice della documentazione MCP
Indice letto. Ora le pagine principali — sessione, memoria, strumenti e ricette per i compiti tipici.
Eseguiti 4 comandi
La documentazione su sessione, memoria e strumenti è stata assimilata. Ora la pagina delle ricette e uno sguardo a ciò che c'è già nel negozio.
Letto il documento con le ricette
Con la documentazione ho finito. Ora guardo lo stato attuale del negozio — utenti, catalogo, valute, impostazioni di base.
Eseguiti 2 comandi, coinvolti 3 strumenti (2 con errore)
Il negozio è quasi vuoto — un utente (admin), un gruppo (Amministratori). Studierò la struttura delle tabelle in cui andrò a scrivere.
Eseguito un comando, coinvolto uno strumento
Il negozio è completamente vuoto — solo la sezione radice: niente prodotti, niente valute, niente gruppi clienti, niente campi di registrazione, niente opzioni d'ordine. Leggerò i valori dal registro delle impostazioni a cui farò poi riferimento.
melbis: engine db select
Ora l'albero dei diritti — per i due nuovi login — e le impostazioni linguistiche della vetrina.
Poi il lavoro vero e proprio. Qui si vede bene come l'assistente AI non si limiti a eseguire, ma cerchi una scorciatoia: invece di 79 chiamate separate per assegnare i diritti, controlla come sono strutturati gli identificatori e fa tutto con un'unica query.
Ho finito con il catalogo. Verifico se ora le tabelle utenti sono libere.
melbis: engine db locks
Tutto libero. Creo due gruppi e due login.
Coinvolti 4 strumenti
Entrambi i login sono stati creati. Ora i loro diritti — e qui c'è un intoppo che vale la pena dire ad alta voce: CmdRightAdd assegna una sola operazione per chiamata, mentre a questi due ruoli servono circa 75 operazioni in totale. Verifico se la tabella dei diritti genera da sola gli identificatori: in tal caso farò tutto con un unico batch invece di 75 chiamate.
melbis: engine db select
L'identificatore arriva dal generatore Melbis, non da AUTO_INCREMENT — quindi un solo batch con passaggi generate risolverà tutto in una sola chiamata. Prima guardo quali righe di diritti esistono già.
Eseguiti 2 comandi, coinvolto uno strumento
Tutti i 79 identificatori di operazione sono stati verificati. Li scrivo in un unico batch: blocco, 79 identificatori generati, un unico inserimento multi-riga.
melbis: engine db execute
79 righe di diritti inserite con un solo batch. Ora i diritti sulle sezioni: in Melbis l'accesso al catalogo viene assegnato per sezione — oltre ai diritti sulle operazioni.
Coinvolti 2 strumenti
Ora le caratteristiche dei prodotti. Vedrò cosa accetta lo strumento «Caratteristiche».
Sfumature dell'assistente AI
Può sbagliarsi? Sì, può. A volte capita che non vi capisca subito o che non abbia letto fino in fondo la documentazione di Melbis Shop 6 — e bisogna dirlo, è piuttosto imponente. Perciò date assolutamente all'assistente AI il tempo di imparare e di prendere qualche botta. È una fase inevitabile, ma vi assicuriamo: la supera molto più velocemente di una persona e poi esegue le operazioni di routine con maggiore precisione e qualità, lasciando a voi il lavoro creativo.
A cos'altro prestare attenzione. Nell'angolo in basso a destra c'è un cerchietto — cliccatelo e si aprirà una finestra con le statistiche attuali.
La prima cosa — la finestra di contesto: quante informazioni l'assistente AI riesce a tenere in memoria alla volta. Si comprimerà automaticamente (o manualmente, con il comando /compact) e in quel processo dimenticherà parte dei dettagli. Ma non si tratta di un'amnesia totale: al suo interno ha meccanismi per registrare dati intermedi, e in più Melbis Shop 6 gli permette di conservare le proprie note direttamente nel database del negozio. Quindi anche se cambiate computer, ciò che è importante non andrà perso.
La seconda cosa — i limiti del vostro piano tariffario: quanto è stato consumato in cinque ore e in una settimana. Il consumo si vede qui stesso, quindi saprete sempre quanto margine vi resta.
Primo risultato
Dunque, l'assistente AI ha concluso il suo primo lavoro. Alla fine verifica ciò che ha fatto con gli occhi del cliente, registra le conclusioni nella memoria del negozio — così la sessione successiva non ricomincerà da zero — e si mette al lavoro sul processo aziendale:
Tutte e 12 le icone sono pronte. Verifico che la vetrina non mostri più segnaposto.
Non sono rimasti segnaposto (nella home se ne vedono 8 su 12 — questa è la dimensione del blocco nel template). Verifica finale generale:
Tutto controllato. Scriverò ciò che ho imparato nella memoria del negozio, così la prossima sessione non inizierà da zero.
Ora il processo aziendale. Dovranno seguirlo sia l'amica sia la figlia, quindi lo raccoglierò in una pagina separata invece di lasciarlo nella conversazione.
24 min 45 s · 21,2 mila token
Non solo l'assistente AI ha riempito il negozio — ha anche creato una componente importante di qualsiasi attività: una roadmap dei processi aziendali, che ha salvato nella sezione Artifacts. È una pagina separata che può essere condivisa con i dipendenti tramite link. Vi è descritto chi fa cosa e in quale finestra del programma:
Handicraft Shop Operations — «Come è organizzato il lavoro del negozio di articoli per il fai da te». Chi fa cosa, in quale finestra del programma e in quale momento passa il lavoro avanti — è scritto per tre persone.
Who does what — «Chi fa cosa». I diritti vengono assegnati ai gruppi, non alle persone. Per aggiungere una quarta persona, create un login e inseritelo nel gruppo giusto — i diritti arriveranno insieme al gruppo.
Owner (admin) — «Proprietario»: fornitori, prezzi, vendite e tutte le impostazioni del negozio. Friend — product descriptions (content) — «Amica — descrizioni dei prodotti»: testi, caratteristiche, fotografie; non vede i dati commerciali. Daughter — orders & shipping (orders) — «Figlia — ordini e spedizione»: segue l'ordine dal primo contatto fino alla consegna e controlla le giacenze.
E come il prodotto percorre il cammino dal listino del fornitore alla scheda nella vetrina — passo dopo passo, indicando chi è responsabile di ciascuno:
How a product reaches the shop window — «Come un prodotto arriva in vetrina». Cinque passaggi dal listino del fornitore alla scheda prodotto pubblicata. L'ordine è importante: finché la descrizione non è pronta, il prodotto non viene mostrato ai clienti.
01. The product is entered — «Il prodotto viene inserito». Proprietario · Prodotti › Listini prezzi oppure Prodotti › Prezzi. Caricare il listino del fornitore o aggiungere il prodotto manualmente, indicando subito fornitore, prezzo d'acquisto e di vendita, quantità e sezione del catalogo. Stato — «Creare descrizione», il prodotto resta nascosto.
02. The description is written — «La descrizione viene scritta». Amica · Prodotti › Descrizioni. Filtro per stato «Creare descrizione» — questa è la coda di lavoro: nome, testo breve, descrizione completa, caratteristiche, fotografia. Scheda pronta — stato «Pronto». Se manca qualcosa — non inventare, ma lasciare il compito al proprietario (passaggio 5).
03. It goes live — «Il prodotto va in vetrina». Proprietario · Prodotti › Prezzi. Una volta al giorno controllare i prodotti nello stato «Pronto»: verificare prezzo e ricarico e attivarne la visibilità. Da questo momento il prodotto è in vetrina.
Chiaro, comodo e veloce.
Ora si può aprire il sito e vedere che cosa è venuto fuori. Il catalogo con sezioni per temi e schede prodotto:
La pagina del prodotto — con prezzo, disponibilità, descrizione e caratteristiche:
E un semplice modulo di checkout con quei campi di registrazione del cliente che l'assistente AI ha creato in base alla vostra descrizione:
Questa è la prima iterazione funzionante del negozio. Da qui in poi tutto è semplice: passo dopo passo, si precisano i dettagli, si descrivono i compiti e ci si muove verso l'ideale desiderato.
Passo dopo passo
Ecco, per esempio, nel catalogo le immagini si vedono male — hanno forme diverse e la griglia appare irregolare:
Potete formulare il compito esattamente con le parole con cui lo vedete — non è necessario sapere nulla del profilo immagini:
Ottima osservazione — questo è compito mio. Nel profilo è impostato smart: true, cioè «adattare all'interno del riquadro, mantenendo le proporzioni», e non riempirlo completamente. Per questo ogni icona ha preso la forma della foto originale: filato 400×225, forbici 303×400, album da colorare 400×400. Nella griglia questo appare come disomogeneo.
Controllo cosa produce l'impostazione opposta prima di applicarla a tutte e dodici.
Esattamente 400×400. Ora guardo il risultato con gli occhi: «riempire» può significare bordi ai lati, stiramento o ritaglio — e sono cose molto diverse.
smart: false inserisce l'immagine su una tela bianca 400×400 — nulla viene tagliato, nulla viene deformato. È proprio questo che serve alla griglia. Rigenero le altre undici.
Ora tutte e dodici sono 400×400. Elimino le vecchie icone irregolari, così ogni prodotto ne avrà esattamente una.
La vetrina sta già servendo le nuove icone quadrate. Le scaricherò e guarderò la griglia così come la vedrà il cliente.
Voilà, fatto — la griglia si è allineata:
Ma l'assistente AI non si è fermato qui. Ha visto da solo che i bordi bianchi ai lati erano solo metà della soluzione, ha ritagliato le immagini in quadrato e ha spiegato onestamente dove passa il limite delle sue possibilità:
Fatto — ora il catalogo prende un quadrato dal centro di ogni fotografia, e ogni immagine riempie completamente la propria tessera. Le bande bianche ai lati e sopra non ci sono più. Il negozio le sta già mostrando.
Ci sono due cose da sapere, dette in modo semplice:
Il negozio sa ridimensionare le immagini da solo, ma non può decidere quale parte della fotografia mantenere. Questa è una questione di gusto — quale angolo è importante, dove si trova il prodotto nell'inquadratura — e il negozio la lascia alla persona. Quando voi o la vostra amica aggiungete una fotografia nel programma, l'immagine ha uno strumento di ritaglio; una volta impostato come vi piace, potete chiedere al programma di ricordarlo e applicarlo subito a tutto il lotto di fotografie. È proprio quel pulsante che tornerà utile quando caricherete un gruppo di scatti del fornitore.
Gli sfondi restano diversi, e il ritaglio non lo risolverà. Guardate la vetrina: forbici su tessuto rosa, fili su sfondo blu, colori su bianco. Sono dodici fotografie stock scollegate tra loro. Tutto si sistemerà quando appariranno i vostri prodotti reali: una tecnica comune è fotografare tutto sullo stesso sfondo uniforme, e allora il catalogo sembrerà quello di un unico negozio, non di dodici diversi.
E c'è uno scambio che ho fatto io per voi: dato che si prende un quadrato, i bordi della fotografia originale scompaiono nell'immagine piccola. La foto completa rimane comunque nella pagina del prodotto, intatta — viene ritagliata solo l'immagine piccola nel catalogo. Se una vi sembrerà poco riuscita, ditemi quale e la ricadrerò più in alto, più in basso o lateralmente.
Ed ecco il risultato — le immagini quadrate riempiono completamente le tessere:
Naturalmente, nel negozio si può entrare anche tramite il programma. Nella sezione "Descrizioni" si vedono tutti i prodotti inseriti dall'assistente AI con immagini, caratteristiche e testi — e si possono correggere manualmente:
E nella sezione "Prezzi" — tutta la parte commerciale: fornitore, prezzo d'acquisto e di vendita, valuta, quantità e stato del prodotto:
Sviluppo ricorsivo
Come vedete, in circa mezz'ora abbiamo percorso il cammino da una semplice idea fino al primo risultato. Sicuramente avete già delle domande: fino a che punto l'assistente AI è in grado di estendere le funzionalità del negozio? E se potete lavorare così velocemente, sarebbe bene che anche i dipendenti lavorassero allo stesso modo — ma allora bisogna dare loro accesso completo?
Calma. Avete investito in Melbis Shop 6, e qui c'è una struttura scalabile.
Prima di tutto: l'assistente AI in modalità di accesso diretto, cioè come amministratore, dispone di diritti grandiosi — sia quanto a risorse, sia quanto a auto-miglioramento. Non può solo inserire prodotti e impostare configurazioni: è in grado di sviluppare e perfezionare l'architettura del database, costruire la vetrina e i moduli interni, guardare la vetrina con gli occhi del cliente, analizzarla, ottenere report interni sulle prestazioni del sistema e apportare correzioni. Ma soprattutto — può migliorare gli strumenti. Sia i propri sia quelli altrui.
Ricordate il ramo dei diritti nello screenshot sopra: AI Assistant > Tools > Get list e Execute? Sono comandi speciali che potete aprire ai vostri dipendenti — e allora per loro diventeranno disponibili gli strumenti dell'assistente AI, sviluppati appositamente da voi o da loro stessi.
Nel negozio iniziale di Melbis Shop 6 abbiamo già creato e aggiunto una serie di questi strumenti. Vi saranno utili di per sé e serviranno come esempio didattico per il vostro assistente AI. Per vederli, aprite la sezione "Development" > "AI tools".
A sinistra — il catalogo degli strumenti, suddiviso per sezioni del programma: prodotti, ordini, fornitori, struttura. A destra — i comandi dello strumento selezionato con le descrizioni, e sotto i parametri di ciascun comando: che cosa è obbligatorio, che cosa ha un valore predefinito, che cosa significa ogni campo. È proprio da queste descrizioni che l'assistente AI capisce come usare lo strumento.
Ma la parte più interessante è la scheda "Command Rights": qui indicate a quale dipendente è consentito fare cosa. Cioè, il dipendente può chiamare l'assistente AI e usare quei comandi dello strumento che gli avete aperto — e nient'altro oltre a questo.
E in sezioni come "Catalog", si può inoltre impostare il livello di accesso a una singola sezione del catalogo: chi può vedere la vetrina della sezione, chi può modificare le descrizioni, chi i prezzi.
Se lo desiderate, gli strumenti possono essere salvati e trasferiti — oppure aggiornati — da un negozio a un altro. Potete chiedere all'assistente AI di tradurre le loro descrizioni nella vostra lingua, per rendere il lavoro più semplice. Potete anche incaricarlo di assegnare i diritti. A quel punto la questione è solo cosa sia più rapido: scrivere il testo del compito all'assistente AI o passare personalmente tra le opzioni.
Come organizzare il lavoro
Consigliamo di dividere i compiti per argomenti separati. Nella finestra di Claude Code, a sinistra, nell'elenco degli argomenti, premete + e iniziate un nuovo dialogo. Così ogni tema ha la propria memoria e la propria cronologia, e non si intralciano a vicenda. Ecco, per esempio, un dialogo separato in cui cambiamo l'aspetto del negozio dimostrativo:
Fate attenzione: il template è realizzato con una tecnologia completamente diversa, e l'assistente AI non ha cercato di trascinarla dentro al progetto, ma ne ha trasferito il linguaggio visivo — colori, arrotondamenti, ombre, font — sul markup che il negozio aveva già. Ecco il suo report:
Che cosa ho fatto
Qui BloomShop non si può installare: è Next.js 16 + React 19 + Tailwind 4 + Radix, mentre la vostra vetrina è il templating Melbis su PHP, che serve Bootstrap 4. Perciò ne ho riprodotto il linguaggio visivo con normale CSS sopra il Bootstrap che avete già collegato — senza nuove dipendenze e senza ricompilare bundle.
I veri valori del design li ho presi dalle variabili CSS della demo live, non li ho scelti a occhio: ambra #f59e0b come colore principale, #fffbeb / #92400e come accento, #262626 per il testo, #6b7280 per il tono attenuato, raggio 1.225rem, pulsanti a pillola, ombre morbide, font Inter. Tutti si trovano come proprietà --bloom-* all'inizio di templates/default/statics/melbis/main.css — da lì si può ricolorare l'intero negozio.
Riscritti: il foglio di stile e 13 template — intestazione (barra sticky, scritta MELBISSHOP bicolore, carrello, menu su riga separata), footer (tre colonne, social, barra inferiore), home page (hero iniziale, barra dei vantaggi, griglia dei prodotti in evidenza — il jumbotron «Melbis Shop 6 Working!» è stato rimosso), pagine di sezione, scheda prodotto e il resto.
Ancora mezz'ora — ed ecco il risultato pronto. La home page con primo schermo, barra dei vantaggi e griglia dei prodotti in evidenza:
E la pagina prodotto nello stesso stile. Senza commenti.
