Agente per il commercio
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, sul Claude Agent SDK e su Claude Managed Agents, 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. 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.
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 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, su Google Cloud's Agent Platform o su 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 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é.
Was this page helpful?