Domande Frequenti
Tutto quello che devi sapere su Universal Commerce Protocol.
Generale
Cos'è Universal Commerce Protocol?
UCP (Universal Commerce Protocol) è uno standard aperto che fornisce un linguaggio comune per piattaforme AI, business, payment provider e credential provider. Permette agli agenti AI di effettuare transazioni commerciali in modo sicuro e standardizzato.
Chi ha sviluppato UCP?
UCP è stato co-sviluppato da Google e Shopify, con il contributo di altri leader del settore come Walmart, Stripe, Visa e Mastercard. È un progetto open source sotto licenza Apache 2.0.
Questo sito è una risorsa ufficiale di Google o Shopify?
No, questo sito non è affiliato ufficialmente a Google, Shopify o altri partner menzionati. È una risorsa informativa indipendente in italiano su Universal Commerce Protocol (UCP), uno standard aperto co-sviluppato da Google e Shopify.
Per informazioni ufficiali, consulta ucp.dev (sito ufficiale del protocollo) o i canali ufficiali di Google e Shopify.
Business
UCP è gratuito?
Sì, UCP è completamente open source e gratuito. Non ci sono costi di licenza per implementare il protocollo. I costi sono solo quelli normali di sviluppo e le eventuali fee delle transazioni (che dipendono dal tuo payment provider).
UCP sostituirà il mio e-commerce esistente?
No, UCP non sostituisce il tuo e-commerce. Si integra con la tua piattaforma esistente (Shopify, WooCommerce, Magento, etc.) per renderla accessibile agli agenti AI. Continuerai a gestire prodotti, prezzi e promozioni dal tuo pannello abituale, mentre UCP espone questi dati in un formato standardizzato che le AI possono comprendere.
Quali piattaforme AI supportano già UCP?
UCP è uno standard emergente supportato da Google. L'adozione è in crescita e diverse piattaforme AI stanno valutando l'integrazione. L'obiettivo è creare un ecosistema aperto dove qualsiasi assistente AI (ChatGPT, Gemini, Claude, etc.) possa interagire con merchant che implementano UCP.
Come vengono gestiti i pagamenti con UCP?
UCP non gestisce direttamente i pagamenti, ma coordina il flusso tra il tuo merchant account e i wallet degli utenti. Utilizzi i tuoi payment provider abituali (Stripe, PayPal, etc.) e mantieni il pieno controllo sulle transazioni. UCP standardizza solo il modo in cui le AI richiedono e confermano i pagamenti.
Posso controllare quali prodotti esporre agli agenti AI?
Sì, hai il controllo completo. Puoi decidere quali prodotti, categorie o promozioni rendere disponibili tramite UCP. Puoi anche impostare regole specifiche per canale (es. prezzi diversi per vendite via AI rispetto al sito web) e limitare l'accesso a determinati agenti o piattaforme.
Quali dati dei clienti vengono condivisi con le AI?
Solo i dati necessari per completare la transazione, nel rispetto del GDPR. L'utente autorizza esplicitamente la condivisione tramite OAuth 2.0. Tipicamente: nome, indirizzo di spedizione e metodo di pagamento. I dati sensibili (come numeri di carta) non vengono mai esposti alle AI, ma gestiti direttamente dai payment provider certificati.
Tecnico
Quanto tempo serve per integrare UCP?
Dipende dal tuo stack. Con piattaforme come Shopify, l'integrazione sarà quasi automatica tramite plugin. Per stack custom, con SDK e documentazione disponibili, un team può completare un'integrazione base in pochi giorni.
UCP usa REST API o GraphQL?
UCP è basato su REST API con payload JSON-LD (Linked Data). Questo permette una semantica ricca e comprensibile dalle AI, mantenendo la semplicità di implementazione tipica di REST. Non è richiesto GraphQL, ma puoi esporre i tuoi endpoint UCP tramite GraphQL se preferisci.
Come funziona l'autenticazione OAuth in UCP?
UCP utilizza OAuth 2.0 per l'account linking. L'utente autorizza l'agente AI ad accedere al suo account merchant tramite un flusso standard di autorizzazione. Questo garantisce che solo utenti autenticati possano effettuare acquisti e che tu possa tracciare le transazioni per utente, proprio come sul tuo sito web.
Serve un SDK specifico per implementare UCP?
Non è obbligatorio. UCP è uno standard aperto basato su HTTP/JSON, quindi puoi implementarlo con qualsiasi linguaggio e framework. Tuttavia, esistono SDK ufficiali e community-driven per Node.js, Python, PHP e altri linguaggi che semplificano l'integrazione e gestiscono automaticamente la validazione degli schemi.
Come gestisco gli errori nelle richieste UCP?
UCP definisce un set standardizzato di codici di errore HTTP e payload di errore strutturati. Ad esempio, un prodotto esaurito restituisce un 409 Conflict con dettagli sulla disponibilità. Questo permette agli agenti AI di gestire gli errori in modo intelligente (es. suggerire prodotti alternativi) invece di mostrare messaggi generici all'utente.
UCP supporta transazioni multi-merchant?
Sì, UCP è progettato per supportare scenari complessi come marketplace o carrelli che includono prodotti da più merchant. Ogni merchant mantiene il controllo sulle proprie regole di business e payment processing, mentre UCP coordina il flusso complessivo della transazione in modo trasparente per l'utente finale.
Che differenza c'è tra MCP e UCP?
MCP (Model Context Protocol) e UCP (Universal Commerce Protocol) sono complementari ma hanno scopi diversi:
-
MCP è un protocollo per connettere AI a fonti di dati e strumenti generici (database, API, file system, etc.). Permette agli agenti AI di accedere a informazioni contestuali.
-
UCP è specifico per il commercio elettronico. Standardizza come le AI effettuano transazioni commerciali: ricerca prodotti, gestione carrello, checkout e pagamenti.
In pratica, un agente AI potrebbe usare MCP per accedere al catalogo prodotti di un merchant e UCP per completare l'acquisto in modo sicuro e standardizzato.