Inizia
Come usare le funzionalità AI in Product Feed Pro - AdTribes
  1. Casa
  2. Knowledge Base
  3. Integrazione
  4. Come usare le funzionalità AI in Product Feed Pro

Come usare le funzionalità AI in Product Feed Pro

Vuoi un assistente AI o un'automazione per gestire i tuoi feed di prodotti? Questo riferimento elenca ogni funzionalità che i plugin AdTribes registrano. Se usi solo le schermate di amministrazione, consulta le altre guide nella knowledge base di AdTribes.

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à

RequisitoDettagli
WordPress 6.9 o più recenteL'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ù recentePossiede 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 AII 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àNomeTipoChi può usarla
Elenca feedadtribes/list-feedsLetturaResponsabile negozio + Amministratore
Ottieni feedadtribes/get-feedLetturaResponsabile negozio + Amministratore
Crea feedadtribes/create-feedScrittura (distruttiva)Responsabile negozio + Amministratore
Aggiorna feedadtribes/update-feedScrittura (distruttiva)Responsabile negozio + Amministratore
Elimina feedadtribes/delete-feedScrittura (distruttiva)Responsabile negozio + Amministratore
Rigenera feedadtribes/regenerate-feedScrittura (distruttiva)Responsabile negozio + Amministratore
Clona feedadtribes/clone-feedScrittura (distruttiva)Responsabile negozio + Amministratore
Ottieni validazione feedadtribes/get-feed-validationLetturaResponsabile negozio + Amministratore
Elenca attributi feedadtribes/list-feed-attributesLetturaResponsabile negozio + Amministratore
Elenca tassonomia Googleadtribes/list-google-taxonomyLetturaResponsabile negozio + Amministratore
Imposta mappatura campiadtribes/set-field-mappingScrittura (distruttiva)Responsabile negozio + Amministratore
Imposta mappatura categorieadtribes/set-category-mappingScrittura (distruttiva)Responsabile negozio + Amministratore
Aggiungi regola filtroadtribes/add-filter-ruleScrittura (distruttiva)Responsabile negozio + Amministratore
Elenca i canaliadtribes/list-channelsLetturaResponsabile negozio + Amministratore
Crea feed personalizzatoadtribes/create-custom-feedScrittura (distruttiva)Responsabile negozio + Amministratore
Aggiorna feed in bloccoadtribes/bulk-update-feedsScrittura (distruttiva)Responsabile negozio + Amministratore
Ottieni stato tracciamentoadtribes/get-tracking-statusLetturaResponsabile negozio + Amministratore
Imposta Pixel di Facebookadtribes/set-facebook-pixelScrittura (distruttiva)Solo amministratore
Imposta tracciamento Googleadtribes/set-google-trackingScrittura (distruttiva)Solo amministratore
Imposta tagging UTMadtribes/set-utm-taggingScrittura (distruttiva)Responsabile negozio + Amministratore
Imposta pianificazione feedadtribes/set-feed-scheduleScrittura (distruttiva)Responsabile negozio + Amministratore
Metti in pausa pianificazione feedadtribes/pause-feed-scheduleScrittura (distruttiva)Responsabile negozio + Amministratore
Ottieni statistiche feedadtribes/get-feed-statsLetturaResponsabile negozio + Amministratore
Ottieni riepilogo canaleadtribes/get-channel-summaryLetturaResponsabile negozio + Amministratore
Ottieni prodotti esclusiadtribes/get-excluded-productsLetturaResponsabile 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àNomeTipoChi può usarla
Elenca feed tradottiadtribes/list-translated-feedsLetturaResponsabile negozio + Amministratore
Crea un feed per linguaadtribes/create-language-feedScrittura (distruttiva)Responsabile negozio + Amministratore
Ottieni copertura traduzioniadtribes/get-translation-coverageLetturaResponsabile negozio + Amministratore
Imposta attributo linguaadtribes/set-language-attributeScrittura (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 filtro adt_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 permessiSi applica aCapacità richiesta
Leggi le funzionalitàOgni riga “Leggi” sopramanage_woocommerce
Funzionalità di gestione feed e traduzioniOgni riga “Scrivi” tranne le impostazioni di marketing sottostantimanage_woocommerce
Funzionalità delle impostazioni di marketingset-facebook-pixel, set-google-trackingFiltrabile 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-feedsper_page massimo 500, predefinito 100
adtribes/list-google-taxonomylimit massimo 5000, predefinito 200
adtribes/get-excluded-productslimit massimo 500, predefinito 100
adtribes/get-channel-summaryAggrega fino a 500 feed per canale; oltre tale limite restituisce truncated: true
adtribes/bulk-update-feedsfeed_ids accetta fino a 500 per chiamata

Risoluzione dei problemi

Un'automazione o un agente non può vedere alcuna funzionalità di AdTribes
Conferma che il sito esegue WordPress 6.9 o versioni successive e che WooCommerce è attivo. Se entrambi sono corretti, conferma che nulla ha impostato la costante 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.
Una chiamata restituisce un errore di autorizzazione
Verifica quale autorizzazione è necessaria per la funzionalità nella tabella "Chi può utilizzare ogni funzionalità" sopra. La maggior parte delle funzionalità richiede 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.
L'assistente afferma di non poter apportare una modifica
Vai su StoreAgent > Impostazioni > MCP > Abilitá, seleziona la sorgente AdTribes e attiva l'abilitá. Se é giá attiva, apri la sottoscheda Connessioni e controlla la colonna Ambito. Una connessione di sola lettura non puó eseguire abilitá di scrittura e non c'é un interruttore per cambiarla: fai clic su Revoca, riconnetti il tuo assistente e scegli Lettura e scrittura nella pagina di approvazione. Vedi Come connettere ChatGPT o Claude al tuo negozio con MCP.
Le abilitá del Translation Addon non sono presenti
Conferma che il Translation Addon sia attivo e aggiornato alla versione 1.0.1 o successiva, e che Product Feed Pro sia attivo insieme ad esso.
Product Feed Pro ed Elite sembrano registrare entrambi lo stesso nome di abilitá
Questo é previsto e innocuo. Viene registrata solo una copia per ogni nome. Con Product Feed Pro 13.5.7 o versioni successive ed Elite 5.1.0 o versioni successive, Pro registra ogni abilitá ed Elite salta le sue copie. Con Elite 5.0.9, la copia di Elite viene registrata per prima e Pro la salta. I nomi sono gli stessi in entrambi i casi, quindi le tue chiamate continuano a funzionare. Aggiorna Elite alla versione 5.1.0 o successiva per consentire a Pro di possederle tutte.

Domande frequenti

Ho bisogno di Product Feed Elite per usare le abilitá AI?
No. Tutte le 25 abilitá principali sono registrate dal plugin gratuito Product Feed Pro. Elite aggiunge solo il dettaglio della Facebook Conversion API a adtribes/get-tracking-status.
Ho bisogno di StoreAgent per connettere un assistente?
StoreAgent é il percorso di connessione documentato in questo articolo. É ció che fornisce l'endpoint MCP a cui si connette un assistente come Claude o ChatGPT, ed é dove approvi quanta accessibilitá ottiene una connessione.
L'aggiornamento di Product Feed Pro cambierá i nomi delle abilitá che la mia automazione chiama giá?
No. La proprietá delle 12 abilitá che sono state spostate da Elite a Pro é cambiata, ma i nomi adtribes/... sono rimasti gli stessi, quindi le chiamate esistenti continuano a funzionare.
Le abilitá aggirano le normali misure di sicurezza del plugin?
No. Ogni abilitá chiama gli stessi metodi del layer di servizio utilizzati dall'interfaccia utente dell'amministratore e da WP-CLI, quindi si applicano le stesse validazioni, hook e comportamenti di Action Scheduler.
Esiste un numero massimo di feed che posso aggiornare in una singola chiamata?
Sí, 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.

Questo articolo è stato utile?

Articoli Correlati

Completa il tuo acquisto
Feed Prodotti WooCommerce AdTribes

Il miglior plugin per i feed di prodotti WooCommerce

  • AdTribes Pty Ltd
    ABN: 40 675 636 816
Prodotto
Risorse e Informazioni
Siti Partner
Rymera