Fare clic sulle schermate di amministrazione di Product Feed Pro funziona bene per modifiche una tantum. Non è scalabile quando vuoi che un assistente AI, un'automazione interna o un agente connesso a MCP crei feed, corregga una mappatura, traduca un feed in un'altra lingua o controlli la salute del feed da solo. È qui che entrano in gioco le funzionalità AI: un modo strutturato e controllato dai permessi per un assistente AI di chiamare le stesse azioni che l'interfaccia utente di amministrazione espone già, tramite l'API Abilities di WordPress.
Ogni funzionalità è un sottile wrapper attorno al livello di servizio esistente del plugin, gli stessi helper che usano l'interfaccia utente di amministrazione e WP-CLI, quindi chiamare una funzionalità attiva gli stessi hook di WordPress e WooCommerce dell'azione di amministrazione equivalente. Non c'è un percorso di codice separato "tramite AI" di cui fidarsi. Questo riferimento copre ogni funzionalità registrata nella famiglia di plugin AdTribes, chi può chiamarla e come connettere un assistente al tuo negozio.
Cosa ti servirà
| Requisito | Dettagli |
|---|---|
| WordPress 6.9 o più recente | L'API Abilities (wp_register_ability()) è inclusa nel core di WordPress da 6.9. Nelle versioni precedenti di WordPress, la registrazione viene saltata del tutto e nessuna funzionalità appare. |
| Product Feed Pro 13.5.7 o più recente | Possiede e registra le 25 funzionalità nella tabella di riferimento sottostante. Anche WooCommerce deve essere attivo, poiché Product Feed Pro si avvia solo quando lo è. |
| Un modo per connettere un assistente AI | I plugin AdTribes non hanno una propria scheda delle impostazioni AI o MCP. Connetti Claude, ChatGPT o un altro assistente alle tue funzionalità tramite StoreAgent. Quella guida copre l'installazione di StoreAgent, la connessione di un assistente e l'approvazione della quantità di accesso che la connessione ottiene. |
| Product Feed Elite (facoltativo) | Non richiesto per nessuna delle funzionalità sottostanti. Vedi "Il ruolo di Product Feed Elite" più avanti. |
| Product Feed Translation Addon 1.0.1 o più recente (facoltativo) | Aggiunge altre 4 funzionalità per la creazione e il controllo dei feed per lingua. |
Cosa sono le funzionalità AI
Una funzionalità è un'azione specifica che il tuo assistente AI può intraprendere nel tuo negozio, ad esempio "elenca i miei feed" o "imposta la pianificazione di un feed". Alcune funzionalità leggono solo dati. Altre apportano modifiche e quelle che lo fanno sono contrassegnate come distruttive in modo che un client MCP sappia di confermare con te prima di eseguirle.
Connetti un assistente
Per il flusso di connessione completo, inclusa l'installazione di StoreAgent e l'approvazione di ciò che una connessione può leggere o modificare, vedere Come connettere ChatGPT o Claude al tuo negozio con MCP. Una volta che il tuo assistente è connesso tramite l'endpoint MCP di StoreAgent, le capacità di lettura di AdTribes sono immediatamente disponibili. Le capacità di scrittura rimangono disattivate finché non le attivi in StoreAgent > Impostazioni > MCP > Capacità, sotto la sorgente AdTribes.
Capacità di Product Feed Pro
Product Feed Pro registra 25 capacità sotto la categoria condivisa adtribes. La registrazione si aggancia a wp_abilities_api_init con priorità 20, condizionata da function_exists( 'wp_register_ability' ), quindi è un no-op elegante su WordPress precedente alla versione 6.9. Puoi anche disattivare completamente la registrazione con la costante PFP_DISABLE_ABILITIES o il filtro adt_pfp_enable_abilities, entrambi i quali impostano di default le capacità su attive.
| Capacità | Nome | Tipo | Chi può usarla |
|---|---|---|---|
| Elenca feed | adtribes/list-feeds | Lettura | Responsabile negozio + Amministratore |
| Ottieni feed | adtribes/get-feed | Lettura | Responsabile negozio + Amministratore |
| Crea feed | adtribes/create-feed | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Aggiorna feed | adtribes/update-feed | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Elimina feed | adtribes/delete-feed | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Rigenera feed | adtribes/regenerate-feed | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Clona feed | adtribes/clone-feed | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Ottieni validazione feed | adtribes/get-feed-validation | Lettura | Responsabile negozio + Amministratore |
| Elenca attributi feed | adtribes/list-feed-attributes | Lettura | Responsabile negozio + Amministratore |
| Elenca tassonomia Google | adtribes/list-google-taxonomy | Lettura | Responsabile negozio + Amministratore |
| Imposta mappatura campi | adtribes/set-field-mapping | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Imposta mappatura categorie | adtribes/set-category-mapping | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Aggiungi regola filtro | adtribes/add-filter-rule | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Elenca i canali | adtribes/list-channels | Lettura | Responsabile negozio + Amministratore |
| Crea feed personalizzato | adtribes/create-custom-feed | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Aggiorna feed in blocco | adtribes/bulk-update-feeds | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Ottieni stato tracciamento | adtribes/get-tracking-status | Lettura | Responsabile negozio + Amministratore |
| Imposta Pixel di Facebook | adtribes/set-facebook-pixel | Scrittura (distruttiva) | Solo amministratore |
| Imposta tracciamento Google | adtribes/set-google-tracking | Scrittura (distruttiva) | Solo amministratore |
| Imposta tagging UTM | adtribes/set-utm-tagging | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Imposta pianificazione feed | adtribes/set-feed-schedule | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Metti in pausa pianificazione feed | adtribes/pause-feed-schedule | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Ottieni statistiche feed | adtribes/get-feed-stats | Lettura | Responsabile negozio + Amministratore |
| Ottieni riepilogo canale | adtribes/get-channel-summary | Lettura | Responsabile negozio + Amministratore |
| Ottieni prodotti esclusi | adtribes/get-excluded-products | Lettura | Responsabile negozio + Amministratore |
Per istruzioni dettagliate su filtri e regole, consulta Come Creare Filtri per il Tuo Feed di Prodotti? e Come Creare Regole per il Feed di Prodotti.
Funzionalità del Product Feed Translation Addon
Con il Product Feed Translation Addon attivo, altre 4 funzionalità si registrano sotto la stessa categoria adtribes, agganciate a wp_abilities_api_init con priorità 40 in modo che Product Feed Pro registri prima le proprie funzionalità. Puoi disattivarle con la costante PFTA_DISABLE_ABILITIES o con il filtro adt_pfta_enable_abilities.
| Capacità | Nome | Tipo | Chi può usarla |
|---|---|---|---|
| Elenca feed tradotti | adtribes/list-translated-feeds | Lettura | Responsabile negozio + Amministratore |
| Crea un feed per lingua | adtribes/create-language-feed | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
| Ottieni copertura traduzioni | adtribes/get-translation-coverage | Lettura | Responsabile negozio + Amministratore |
| Imposta attributo lingua | adtribes/set-language-attribute | Scrittura (distruttiva) | Responsabile negozio + Amministratore |
Crea un feed per lingua duplica un feed esistente per una lingua specifica, lo stesso flusso di duplicazione e poi cambio lingua che esegue la schermata Gestisci feed dell’amministratore. Ottieni copertura traduzioni riporta, per lingua, quanti prodotti pubblicati esistono in quella lingua rispetto alla tua lingua predefinita, così puoi vedere quanto sarà completo un feed per lingua prima di generarlo.
Ruolo di Product Feed Elite
Product Feed Elite non possiede attualmente alcuna funzionalità esclusiva. Prima di Product Feed Pro 13.5.7, 12 delle funzionalità sopra (tutto ciò che riguarda feed personalizzati, marketing e tracciamento, e pianificazione e statistiche, più clone-feed e bulk-update-feeds) erano incluse in Elite 5.0.9. A partire da Pro 13.5.7, Pro possiede e registra tutte queste funzionalità autonomamente, poiché le funzionalità che esse gestiscono sono ora in Pro.
Con entrambi i plugin attivi e Product Feed Pro 13.5.7 o più recente, Elite 5.1.0 non registra più alcuna delle proprie funzionalità: Pro registra per primo (priorità 20) e le copie di Elite (priorità 30) verificano se il nome è già in uso e si saltano quando lo è, quindi non vengono mai attivate. Ciò che Elite fa ancora è:
- Arricchisci
adtribes/get-tracking-status: Elite aggiunge lo stato reale della Conversion API di Facebook alla risposta di quella funzionalità tramite il filtroadt_pfp_ability_tracking_status, poiché Pro non gestisce l’integrazione con la Conversion API. - Fornisci un fallback di compatibilità: Su un sito che esegue ancora Product Feed Pro versione precedente alla 13.5.7, le copie di Elite vengono registrate al posto loro, quindi questi nomi di funzionalità continuano a funzionare durante la finestra di aggiornamento.
Una funzionalità non è stata inclusa: adtribes/get-pixel-event-log, che era inclusa in Elite 5.0.9, è stata ritirata anziché adottata. Poteva solo riportare “non supportato”, quindi non fa parte della tabella di riferimento sopra.
Elite ha anche un proprio interruttore: la costante PFE_DISABLE_ABILITIES o il filtro adt_pfe_enable_abilities disattivano tutto ciò che Elite aggiunge alle funzionalità: le sue copie di fallback e il dettaglio della Conversion API di Facebook in adtribes/get-tracking-status.
Chi può usare ciascuna funzionalità
Le funzionalità utilizzano lo stesso modello di permessi delle schermate di amministrazione del plugin e degli endpoint REST, non la semplice capacità read di WordPress che ogni utente connesso possiede.
| Controllo dei permessi | Si applica a | Capacità richiesta |
|---|---|---|
| Leggi le funzionalità | Ogni riga “Leggi” sopra | manage_woocommerce |
| Funzionalità di gestione feed e traduzioni | Ogni riga “Scrivi” tranne le impostazioni di marketing sottostanti | manage_woocommerce |
| Funzionalità delle impostazioni di marketing | set-facebook-pixel, set-google-tracking | Filtrabile tramite adt_pfp_admin_capability, predefinito manage_options |
WooCommerce concede di default sia agli Amministratori che ai Gestori del Negozio il permesso manage_woocommerce. Quindi un Gestore del Negozio può utilizzare ogni funzionalità tranne set-facebook-pixel e set-google-tracking, che richiedono manage_options a meno che tu non cambi adt_pfp_admin_capability.
Le schermate di amministrazione del feed utilizzano un'autorizzazione separata. Per consentire anche ai Gestori del Negozio di utilizzare tali schermate, consulta Come consentire al Gestore del Negozio di gestire i feed?
Accesso in scrittura
Ogni funzionalità di scrittura riporta un flag destructive e idempotent nei suoi metadati di registrazione, visibile a qualsiasi client dell'API Abilities. Un client MCP come StoreAgent può utilizzare questi flag per decidere se chiederti prima di eseguire una chiamata, ma se il tuo assistente può scrivere sul tuo negozio è controllato da tre cose:
- L'autorizzazione del tuo account utente, dalla tabella sopra.
- L'accesso che hai approvato quando hai connesso il tuo assistente. Una connessione che hai approvato come sola lettura in StoreAgent non può eseguire una funzionalità distruttiva, indipendentemente dall'autorizzazione del tuo account. Vedi Come connettere ChatGPT o Claude al tuo negozio con MCP per sapere come rivedere o modificare l'accesso di una connessione.
- La whitelist delle funzionalità di StoreAgent. Le funzionalità di scrittura di AdTribes sono disattivate in StoreAgent finché non le attivi tutte sotto StoreAgent > Impostazioni > MCP > Funzionalità, nella sorgente AdTribes. Le funzionalità di lettura sono attive per impostazione predefinita.
Limiti di lettura
Le funzionalità di lettura che restituiscono elenchi sono limitate in modo che una singola chiamata non possa recuperare dati illimitati:
| Capacità | Limite |
|---|---|
adtribes/list-feeds | per_page massimo 500, predefinito 100 |
adtribes/list-google-taxonomy | limit massimo 5000, predefinito 200 |
adtribes/get-excluded-products | limit massimo 500, predefinito 100 |
adtribes/get-channel-summary | Aggrega fino a 500 feed per canale; oltre tale limite restituisce truncated: true |
adtribes/bulk-update-feeds | feed_ids accetta fino a 500 per chiamata |
Risoluzione dei problemi
PFP_DISABLE_ABILITIES (o PFTA_DISABLE_ABILITIES per il Translation Addon) o restituito false dal filtro adt_pfp_enable_abilities, poiché uno qualsiasi di questi disattiva completamente la registrazione.manage_woocommerce; le due funzionalità di impostazioni di marketing richiedono ciò a cui adt_pfp_admin_capability si risolve (manage_options per impostazione predefinita). Conferma che il tuo account utente o la password dell'applicazione che effettua la chiamata disponga effettivamente di tale autorizzazione.Domande frequenti
adtribes/get-tracking-status.adtribes/... sono rimasti gli stessi, quindi le chiamate esistenti continuano a funzionare.adtribes/bulk-update-feeds accetta fino a 500 ID di feed per chiamata. Per un numero maggiore, suddividi la richiesta in batch.Serve ulteriore aiuto?
Se hai Product Feed Elite, puoi aprire un ticket di supporto per ricevere assistenza prioritaria con l'integrazione delle tue abilitá AI.
Se utilizzi il plugin gratuito Product Feed Pro, puoi fare una domanda nel forum di supporto di WordPress.org.

