--- title: Agente per il commercio url: https://platform.claude.com/docs/it/about-claude/use-case-guides/commerce-agents description: Crea un agente per gli acquisti e un agente per il venditore su Claude usando Claude for commerce, un blueprint open source con implementazioni funzionanti sulla Messages API, sul Claude Agent SDK e su Claude Managed Agents. --- Questa guida mostra come creare agenti per il commercio su Claude: uno "shopping agent" (agente per gli acquisti) che i clienti usano all'interno della tua app e un "merchant agent" (agente per il venditore) per le persone che gestiscono il negozio, che si tratti del personale operativo dell'azienda o dei venditori presenti sulla sua piattaforma. Lo fa attraverso Claude for commerce, un "blueprint" (progetto di riferimento) open source che include un'implementazione funzionante di ciascun agente sulla [Messages API](https://platform.claude.com/docs/it/build-with-claude/working-with-messages), sul [Claude Agent SDK](https://code.claude.com/docs/it/agent-sdk/overview) e su [Claude Managed Agents](https://platform.claude.com/docs/it/managed-agents/overview), esempi eseguibili per i settori retail, viaggi, telecomunicazioni e intrattenimento, e un plugin per Claude Code che genera la struttura dello stesso design sui tuoi sistemi. Il codice, le istruzioni di configurazione e la documentazione sulla sicurezza si trovano nel [repository di Claude for commerce su GitHub](https://github.com/anthropics/commerce-agents). Per sapere come sono costruiti gli agenti e perché, incluso il design ad agente singolo con "skill" (competenze), i componenti UI come strumenti, la sicurezza applicata dall'"harness" (infrastruttura di esecuzione), il "prompt caching" (cache dei prompt), la memoria e le "eval" (valutazioni), leggi l'articolo tecnico [A guide to the anatomy of effective commerce agents](https://claude.com/blog/the-anatomy-of-effective-commerce-agents). Il blueprint è un'implementazione di riferimento da cui creare un fork e da adattare, non un prodotto supportato né un servizio ospitato. ## L'agente per gli acquisti L'agente per gli acquisti risiede all'interno della tua app e raggiunge i tuoi sistemi attraverso un'unica interfaccia di backend che implementi sopra i tuoi servizi di catalogo, carrello, preferenze, ordini, policy ed evasione degli ordini. Nessun metodo di tale interfaccia effettua un ordine o sposta denaro. In una conversazione l'agente può: * Cercare nel catalogo, confrontare i finalisti e trasformare un'esigenza descritta in una rosa di opzioni e in una raccomandazione. * Pianificare un insieme coordinato di articoli verso un obiettivo come un viaggio, un evento o una stanza, e adattarlo a un budget. * Mostrare prodotti, confronti, piani, stato degli ordini e il carrello come componenti UI visualizzati nella conversazione. * Riempire il carrello e passare il controllo al tuo checkout. * Rispondere a domande su ordini, consegne, resi e policy attingendo ai tuoi sistemi di ordini e policy. * Ricordare ciò che un cliente gli chiede di ricordare e applicarlo nelle sessioni successive. Cinque skill vengono caricate su richiesta per coprire ricerca e scoperta, ricerca pre-acquisto, pianificazione verso un obiettivo, assistenza clienti, e memoria e personalizzazione. Le regole di cui l'agente ha bisogno nella maggior parte dei turni, come il "grounding" (ancoraggio ai dati), la semantica di carrello e checkout e la presentazione, risiedono invece nel "system prompt" (prompt di sistema). L'agente indica prodotti, prezzi, disponibilità e condizioni del negozio solo sulla base dei risultati degli strumenti presenti nella conversazione, e le scritture nel carrello accettano solo ID prodotto restituiti da uno strumento di catalogo o di ordine in quella sessione. Il checkout prepara un riepilogo che il cliente conferma nella tua app. Se usi un checkout ospitato, il tuo back end restituisce il suo URL e l'host lo visualizza senza farlo passare attraverso il modello. ## L'agente per il venditore L'agente per il venditore supporta le persone che gestiscono il negozio. Raggiunge i tuoi sistemi di analisi, catalogo, inventario, prezzi e campagne attraverso una propria interfaccia di backend, e può: * Spiegare l'andamento dell'attività: perché una metrica è cambiata, quale segmento ha determinato il cambiamento e il ritmo rispetto a un periodo comparabile. Un delegato di analisi opzionale esegue query di sola lettura entro un budget di tempo e di dimensione. * Presentare un riepilogo giornaliero di ciò che richiede attenzione, incluse scorte basse, articoli a lenta rotazione ed eccezioni negli ordini. * Migliorare il contenuto delle inserzioni e correggere i dati del catalogo a partire dal materiale fornito dall'operatore. * Raccomandare variazioni di prezzo e promozioni entro i limiti di sicurezza del negozio, con un'anteprima del margine. * Preparare bozze di campagne di marketing con pubblici, posizionamenti e budget. Le sue cinque skill coprono approfondimenti sulle prestazioni, inventario e operazioni, catalogo e inserzioni, prezzi e promozioni, e campagne di marketing. Ogni scrittura proposta dall'agente per il venditore, che si tratti di un aggiornamento di un'inserzione, di una variazione di prezzo, di un'azione sull'inventario, di una promozione o di una campagna, è una modifica in attesa con un ID generato dal server che l'operatore vede come scheda di anteprima. I "guardrail" (limiti di sicurezza), come la variazione massima di prezzo, l'entità della promozione, la dimensione del rifornimento, il budget della campagna e i campi protetti, vengono verificati quando la modifica viene preparata e di nuovo quando viene applicata. La modifica viene applicata solo dopo che una persona la approva al di fuori della conversazione: un pulsante nel portale del venditore nel percorso della Messages API, una richiesta di conferma nella console dell'Agent SDK, oppure una [policy di autorizzazione always-ask](https://platform.claude.com/docs/it/managed-agents/permission-policies) sullo strumento di applicazione su Claude Managed Agents. Un'approvazione digitata in chat non approva nulla. ## Esempi verticali Ogni esempio include una vetrina per i clienti e un portale per il venditore basati su dati fittizi. | Settore | Vetrina | Portale del venditore | | ----------------- | ------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | | Retail | Ricerca, confronto, piani, carrello, checkout e memoria tramite i componenti integrati | Riepilogo giornaliero, rifornimenti e correzioni delle inserzioni in attesa, e il delegato di analisi su una vista SQL | | Viaggi | Inventario legato alle date e un componente per l'itinerario | Calendario di occupazione e variazioni tariffarie per finestre di date | | Telecomunicazioni | Contesto dell'account, una matrice dei piani e informative sulle commissioni redatte dal server | Mix di piani, variazioni di prezzo che indicano le linee interessate e commissioni regolamentate protette | | Intrattenimento | Prenotazioni temporanee, liste d'attesa, trasferimenti, una mappa della sede e informative sulle commissioni complessive | Andamento degli eventi, rilasci di prenotazioni che aggiungono capacità reale e variazioni di prezzo che preservano le commissioni | ## Dove viene eseguito I runtime della Messages API e dell'Agent SDK vengono eseguiti sulla Claude API, su [Amazon Bedrock](https://platform.claude.com/docs/it/build-with-claude/claude-in-amazon-bedrock), su [Google Cloud's Agent Platform](https://platform.claude.com/docs/it/build-with-claude/claude-on-vertex-ai) o su [Microsoft Foundry](https://platform.claude.com/docs/it/build-with-claude/claude-in-microsoft-foundry), oppure tramite il tuo gateway. Il percorso di Claude Managed Agents viene eseguito sulla Claude API. La guida al deployment del repository mostra dove ciascun percorso seleziona la propria piattaforma e quale formato di ID modello si aspetta ciascuno. ## Crea il tuo con il plugin per Claude Code Il blueprint include un plugin per [Claude Code](https://code.claude.com/docs/it/overview) che legge il repository clonato come riferimento e crea un agente sui tuoi sistemi. I suoi quattro comandi coprono il percorso da zero a un agente testato: | Comando | Cosa fa | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/scaffold-commerce-agent` | Ti pone domande sul tuo stack, ti riepiloga il piano e genera la struttura di un agente per gli acquisti, di un agente per il venditore o di entrambi sui pacchetti di riferimento | | `/add-commerce-flow` | Aggiunge un flusso a un agente esistente copiandone la skill, collegando gli strumenti che richiama e scrivendo i suoi primi casi di eval | | `/author-commerce-evals` | Crea una suite di eval con un runner, i primi casi sul tuo catalogo e un controllo di replay per la CI | | `/review-commerce-agent` | Mappa un agente che già esegui, lo confronta con il riferimento e converte le parti che scegli | Il plugin include anche sei skill su architettura, cache dei prompt, UI come strumenti, fiducia e sicurezza, eval e operazioni del venditore, che vengono caricate ogni volta che una conversazione di Claude Code corrisponde a esse. Le istruzioni di installazione si trovano nel README del repository. Per adattare invece il riferimento manualmente, implementa l'interfaccia di backend per gli acquisti o per il venditore sopra i tuoi servizi, disattiva con i flag di configurazione i sistemi che non possiedi in modo che i relativi strumenti e le righe del prompt vengano esclusi, e imposta il nome del tuo brand, il nome dell'assistente e il tono di voce. La guida al backend del repository illustra identità e credenziali, flussi ordinati, passaggio al checkout e prodotti con opzioni. Un progetto pilota può implementare la ricerca e i dettagli dei prodotti e usare stub per il resto. ## Inizia Clona il blueprint ed esegui entrambi gli agenti in locale. Scopri come sono costruiti gli agenti e perché.