WooCommerce per agenti AI
Offri agli agenti commerciali compatibili un percorso prevedibile e in sola lettura, dalla scoperta del prodotto al checkout WooCommerce verificato.
Il problema
Una pagina negozio spiega i prodotti alle persone. Le API generiche di WooCommerce espongono dati al software. A un agente commerciale serve però un contratto pubblico e prevedibile: come scoprire il negozio, cercare in modo economico, verificare un solo prodotto selezionato e rispettare i limiti del merchant.
La risposta diretta
KaliCart Bridge pubblica dal dominio del merchant un’interfaccia catalogo in sola lettura. Trasforma i dati correnti di WooCommerce in risultati compatti, schede dettagliate e indicazioni esplicite sulla richiesta successiva. Il negozio resta la fonte autorevole per prezzo, disponibilità e checkout.
Un flusso disciplinato per l’agente
1. Scoperta
Legge capacità pubbliche ed entry point del catalogo senza indovinare gli endpoint.
2. Ricerca sintetica
Trova e ordina i candidati da risultati compatti senza scaricare ogni prodotto completo.
3. Verifica della scelta
Richiede il dettaglio solo del prodotto selezionato quando servono varianti, immagini o dati di acquisto.
4. Passaggio al checkout
Invia l’utente al percorso WooCommerce autorevole. Bridge non sostituisce il checkout del merchant.
Cosa può leggere l’agente
| Superficie | Segnale strutturato |
|---|---|
| Scoperta | Entry point pubblici e capacità supportate dal catalogo. |
| Ricerca | Query, filtri di categoria, paginazione e riepiloghi compatti. |
| Dati prodotto | ID stabile, SKU, brand, categoria, prezzo corrente, disponibilità e URL canonico. |
| Varianti | Necessità di selezione e dettagli delle varianti pubblicati da WooCommerce. |
| Guida alla richiesta | Quando basta il riepilogo e quando verificare un solo prodotto scelto. |
| Controllo del carico | Segnali di rate limit, errori strutturati e Retry-After quando il negozio chiede di rallentare. |
Confini che proteggono il merchant
Bridge espone una superficie commerciale di lettura, non accesso illimitato né autorità di acquisto.
- Un agente compatibile deve scegliere di usare l’interfaccia: l’installazione non obbliga ogni assistente a scoprire il negozio.
- Sono esposti soltanto dati pubblici del catalogo; informazioni amministrative e private restano fuori dal contratto.
- I limiti proteggono l’hosting. Un agente disciplinato segue i segnali ricevuti e riprova quando indicato.
- Bridge aiuta scoperta e verifica; merchant e WooCommerce restano autorevoli per prezzo, stock, condizioni e checkout.
Soluzione collegata
Catalogo WooCommerce pronto per gli agenti AI
Verifica se i dati dietro l’interfaccia agentica sono abbastanza completi da risultare affidabili.
Domande frequenti
- Ogni agente AI scoprirà automaticamente il mio negozio?
- No. Bridge pubblica un’interfaccia documentata, ma ogni agente o piattaforma decide quali fonti e strumenti utilizzare.
- Sostituisce le API REST di WooCommerce?
- No. È un contratto commerciale complementare, pubblico e in sola lettura, progettato per scoperta e verifica efficienti.
- Cosa succede se un agente invia troppe richieste?
- Bridge può restituire segnali di rate limit e Retry-After. Un agente conforme rallenta e riprova dopo l’intervallo indicato.
- Un agente può modificare prezzi, stock o ordini tramite Bridge?
- No. L’interfaccia catalogo è in sola lettura. WooCommerce e il merchant restano autorevoli per dati commerciali e transazioni.
- Bridge gestisce il checkout?
- No. Restituisce l’URL di acquisto canonico del merchant e mantiene il checkout nel negozio WooCommerce esistente.
- Ha un costo?
- Bridge è gratuito e open source con licenza GPL, senza abbonamento né percentuale sulle vendite.