Empezar
Cómo usar las habilidades de IA en Product Feed Pro - AdTribes
  1. Inicio
  2. Base de conocimientos
  3. Integración
  4. Cómo usar las habilidades de IA en Product Feed Pro

Cómo usar las habilidades de IA en Product Feed Pro

¿Quieres un asistente de IA o una automatización para gestionar tus feeds de productos? Esta referencia enumera cada habilidad que registran los plugins de AdTribes. Si solo usas las pantallas de administración, consulta las otras guías en la base de conocimiento de AdTribes.

Hacer clic en las pantallas de administración de Product Feed Pro funciona bien para cambios puntuales. No escala cuando quieres que un asistente de IA, una automatización interna o un agente conectado a MCP cree feeds, corrija un mapeo, traduzca un feed a otro idioma o verifique la salud del feed por sí solo. Eso es lo que resuelven las habilidades de IA: una forma estructurada y con verificación de permisos para que un asistente de IA llame a las mismas acciones que ya expone la interfaz de usuario de administración, a través de la API de Habilidades de WordPress.

Cada habilidad es un delgado envoltorio alrededor de la capa de servicio existente del plugin, los mismos ayudantes que usan la interfaz de usuario de administración y WP-CLI, por lo que llamar a una habilidad dispara los mismos hooks de WordPress y WooCommerce que la acción de administración equivalente. No hay una ruta de código separada "a través de IA" en la que confiar. Esta referencia cubre cada habilidad registrada en la familia de plugins de AdTribes, quién puede llamar a cada una y cómo conectar un asistente a tu tienda.

Lo que necesitarás

RequisitoDetalles
WordPress 6.9 o superiorLa API de Habilidades (wp_register_ability()) se incluye en el núcleo de WordPress a partir de la versión 6.9. En versiones anteriores de WordPress, el registro se omite por completo y no aparecen habilidades.
Product Feed Pro 13.5.7 o superiorPosee y registra las 25 habilidades en la tabla de referencia a continuación. WooCommerce también debe estar activo, ya que Product Feed Pro solo se inicia cuando lo está.
Una forma de conectar un asistente de IALos plugins de AdTribes no tienen su propia pestaña de configuración de IA o MCP. Conecta Claude, ChatGPT u otro asistente a tus habilidades a través de StoreAgent. Esa guía cubre la instalación de StoreAgent, la conexión de un asistente y la aprobación de cuánta acceso obtiene la conexión.
Product Feed Elite (opcional)No es necesario para ninguna de las habilidades a continuación. Consulta "El papel de Product Feed Elite" más abajo.
Product Feed Translation Addon 1.0.1 o superior (opcional)Añade 4 habilidades más para crear y verificar feeds por idioma.

Qué son las habilidades de IA

Una habilidad es una acción específica que tu asistente de IA puede realizar en tu tienda, por ejemplo, "listar mis feeds" o "establecer la programación de un feed". Algunas habilidades solo leen datos. Otras realizan un cambio, y las que lo hacen están marcadas como destructivas para que un cliente de MCP sepa que debe confirmarlo contigo antes de ejecutarlas.

Conectar un asistente

Para el flujo de conexión completo, incluida la instalación de StoreAgent y la aprobación de lo que una conexión puede leer o cambiar, consulte Cómo conectar ChatGPT o Claude a su tienda con MCP. Una vez que su asistente esté conectado a través del punto final MCP de StoreAgent, las capacidades de lectura de AdTribes estarán disponibles de inmediato. Las capacidades de escritura permanecerán desactivadas hasta que las active en StoreAgent > Configuración > MCP > Capacidades, bajo el origen AdTribes.

Capacidades de Product Feed Pro

Product Feed Pro registra 25 capacidades bajo la categoría compartida adtribes. El registro se engancha a wp_abilities_api_init con prioridad 20, limitado por function_exists( 'wp_register_ability' ), por lo que es una operación nula elegante en WordPress anterior a la versión 6.9. También puede desactivar el registro por completo con la constante PFP_DISABLE_ABILITIES o el filtro adt_pfp_enable_abilities, ambos los cuales tienen como valor predeterminado que las capacidades estén activadas.

CapacidadNombreTipoQuién puede usarla
Listar feedsadtribes/list-feedsLeerGerente de Tienda + Administrador
Obtener feedadtribes/get-feedLeerGerente de Tienda + Administrador
Crear catálogoadtribes/create-feedEscribir (destructivo)Gerente de Tienda + Administrador
Actualizar feedadtribes/update-feedEscribir (destructivo)Gerente de Tienda + Administrador
Eliminar feedadtribes/delete-feedEscribir (destructivo)Gerente de Tienda + Administrador
Regenerar feedadtribes/regenerate-feedEscribir (destructivo)Gerente de Tienda + Administrador
Clonar feedadtribes/clone-feedEscribir (destructivo)Gerente de Tienda + Administrador
Obtener validación de feedadtribes/get-feed-validationLeerGerente de Tienda + Administrador
Listar atributos del feedadtribes/list-feed-attributesLeerGerente de Tienda + Administrador
Listar taxonomía de Googleadtribes/list-google-taxonomyLeerGerente de Tienda + Administrador
Establecer mapeo de camposadtribes/set-field-mappingEscribir (destructivo)Gerente de Tienda + Administrador
Establecer mapeo de categoríasadtribes/set-category-mappingEscribir (destructivo)Gerente de Tienda + Administrador
Añadir regla de filtroadtribes/add-filter-ruleEscribir (destructivo)Gerente de Tienda + Administrador
Listar canalesadtribes/list-channelsLeerGerente de Tienda + Administrador
Crear feed personalizadoadtribes/create-custom-feedEscribir (destructivo)Gerente de Tienda + Administrador
Actualizar feeds en bloqueadtribes/bulk-update-feedsEscribir (destructivo)Gerente de Tienda + Administrador
Obtener estado de seguimientoadtribes/get-tracking-statusLeerGerente de Tienda + Administrador
Establecer Pixel de Facebookadtribes/set-facebook-pixelEscribir (destructivo)Solo administradores
Establecer seguimiento de Googleadtribes/set-google-trackingEscribir (destructivo)Solo administradores
Establecer etiquetado UTMadtribes/set-utm-taggingEscribir (destructivo)Gerente de Tienda + Administrador
Establecer programación de feedadtribes/set-feed-scheduleEscribir (destructivo)Gerente de Tienda + Administrador
Pausar programación de feedadtribes/pause-feed-scheduleEscribir (destructivo)Gerente de Tienda + Administrador
Obtener estadísticas del feedadtribes/get-feed-statsLeerGerente de Tienda + Administrador
Obtener resumen del canaladtribes/get-channel-summaryLeerGerente de Tienda + Administrador
Obtener productos excluidosadtribes/get-excluded-productsLeerGerente de Tienda + Administrador

Para obtener instrucciones detalladas sobre filtros y reglas, consulta ¿Cómo crear filtros para tu feed de productos? y Cómo crear reglas para el feed de productos.

Funcionalidades del Product Feed Translation Addon

Con el Product Feed Translation Addon activo, se registran 4 funcionalidades más bajo la misma categoría adtribes, enganchadas a wp_abilities_api_init con prioridad 40 para que Product Feed Pro registre sus propias funcionalidades primero. Puedes desactivarlas con la constante PFTA_DISABLE_ABILITIES o el filtro adt_pfta_enable_abilities.

CapacidadNombreTipoQuién puede usarla
Listar feeds traducidosadtribes/list-translated-feedsLeerGerente de Tienda + Administrador
Crear feed de idiomaadtribes/create-language-feedEscribir (destructivo)Gerente de Tienda + Administrador
Obtener cobertura de traducciónadtribes/get-translation-coverageLeerGerente de Tienda + Administrador
Establecer atributo de idiomaadtribes/set-language-attributeEscribir (destructivo)Gerente de Tienda + Administrador

Crear feed de idioma duplica un feed existente para un idioma específico, el mismo flujo de duplicar y luego cambiar de idioma que realiza la pantalla Administrar Feeds del administrador. Obtener cobertura de traducción informa, por idioma, cuántos productos publicados existen en ese idioma en comparación con tu idioma predeterminado, para que puedas ver cuán completo será un feed de idioma antes de generarlo.

Función de Product Feed Elite

Product Feed Elite no tiene actualmente ninguna habilidad exclusiva. Antes de Product Feed Pro 13.5.7, 12 de las habilidades anteriores (todo lo relacionado con feeds personalizados, marketing y seguimiento, y programación y estadísticas, además de clone-feed y bulk-update-feeds) se incluían en Elite 5.0.9. A partir de Pro 13.5.7, Pro las posee y registra todas por sí mismo, ya que las funciones que envuelven viven en Pro.

Con ambos plugins activos y Product Feed Pro 13.5.7 o más reciente, Elite 5.1.0 ya no registra ninguna de sus propias habilidades: Pro se registra primero (prioridad 20), y las copias de Elite (prioridad 30) comprueban si el nombre ya está ocupado y se omiten a sí mismas cuando lo está, por lo que nunca se activan. Lo que Elite todavía hace es:

  • Enriquecer adtribes/get-tracking-status: Elite añade el estado real de la API de Conversiones de Facebook a la respuesta de esa habilidad a través del filtro adt_pfp_ability_tracking_status, ya que Pro no posee la integración de la API de Conversiones.
  • Proporcionar una solución de compatibilidad: En un sitio que todavía ejecuta Product Feed Pro anterior a 13.5.7, las copias de Elite se registran en su lugar, por lo que esos nombres de habilidad siguen funcionando durante la ventana de actualización.

Una habilidad no se trasladó: adtribes/get-pixel-event-log, que se incluyó en Elite 5.0.9, se retira en lugar de adoptarse. Solo podía informar "no compatible", por lo que no forma parte de la tabla de referencia anterior.

Elite también tiene su propio interruptor: la constante PFE_DISABLE_ABILITIES o el filtro adt_pfe_enable_abilities desactivan todo lo que Elite añade a las habilidades: sus copias de compatibilidad y el detalle de la API de Conversiones de Facebook en adtribes/get-tracking-status.

Quién puede usar cada habilidad

Las habilidades utilizan el mismo modelo de permisos que las pantallas de administración y los puntos finales REST del plugin, no la capacidad read básica de WordPress que tiene cada usuario conectado.

Comprobación de permisosSe aplica aCapacidad requerida
Leer habilidadesCada fila de "Leer" anteriormanage_woocommerce
Habilidades de gestión de feeds y traduccionesCada fila de "Escribir" excepto la configuración de marketing a continuaciónmanage_woocommerce
Habilidades de configuración de marketingset-facebook-pixel, set-google-trackingFiltrable a través de adt_pfp_admin_capability, por defecto manage_options

WooCommerce otorga a los Administradores y Gerentes de Tienda manage_woocommerce por defecto. Así, un Gerente de Tienda puede llamar a cualquier habilidad excepto set-facebook-pixel y set-google-tracking, que necesitan manage_options a menos que cambies adt_pfp_admin_capability.

Las pantallas de administración de feeds usan una capacidad separada. Para permitir que los Gerentes de Tienda usen esas pantallas también, consulta ¿Cómo permitir que el Gerente de Tienda administre los feeds?

Acceso de escritura

Cada habilidad de escritura informa un indicador destructivo e idempotente en sus metadatos de registro, visible para cualquier cliente de la API de Habilidades. Un cliente MCP como StoreAgent puede usar estos indicadores para decidir si te pregunta antes de ejecutar una llamada, pero si tu asistente puede escribir en tu tienda o no está controlado por tres cosas:

  • La capacidad de la cuenta de usuario, de la tabla anterior.
  • El acceso que aprobaste al conectar tu asistente. Una conexión que aprobaste como de solo lectura en StoreAgent no puede ejecutar una habilidad destructiva, sin importar la capacidad que tenga tu cuenta. Consulta Cómo conectar ChatGPT o Claude a tu tienda con MCP para saber cómo revisar o cambiar el acceso de una conexión.
  • La lista de permitidos de Habilidades de StoreAgent. Las habilidades de escritura de AdTribes están desactivadas en StoreAgent hasta que actives cada una en StoreAgent > Configuración > MCP > Habilidades, en la fuente AdTribes. Las habilidades de lectura están activadas por defecto.

Límites de lectura

Las habilidades de lectura que devuelven listas están limitadas para que una sola llamada no pueda extraer datos ilimitados:

CapacidadLímite
adtribes/list-feedspor_página tiene un máximo de 500, por defecto 100
adtribes/list-google-taxonomylímite tiene un máximo de 5000, por defecto 200
adtribes/get-excluded-productslímite tiene un máximo de 500, por defecto 100
adtribes/get-channel-summaryAgrega hasta 500 feeds por canal; más allá de eso devuelve truncado: verdadero
adtribes/bulk-update-feedsfeed_ids acepta hasta 500 por llamada

Solución de problemas

Una automatización o agente no puede ver ninguna habilidad de AdTribes
Confirma que el sitio está ejecutando WordPress 6.9 o más reciente y que WooCommerce está activo. Si ambos se cumplen, confirma que nada ha establecido la constante PFP_DISABLE_ABILITIES (o PFTA_DISABLE_ABILITIES para el Addon de Traducción) o devuelto falso del filtro adt_pfp_enable_abilities, ya que cualquiera de ellos desactiva el registro por completo.
Una llamada devuelve un error de permiso
Verifica qué capacidad necesita la habilidad en la tabla "Quién puede usar cada habilidad" de arriba. La mayoría de las habilidades necesitan manage_woocommerce; las dos habilidades de configuración de marketing necesitan lo que sea que adt_pfp_admin_capability resuelva (manage_options por defecto). Confirma que tu cuenta de usuario o la contraseña de aplicación que realiza la llamada realmente tiene esa capacidad.
El asistente dice que no puede hacer un cambio
Ve a StoreAgent > Ajustes > MCP > Habilidades, selecciona el origen AdTribes y activa la habilidad. Si ya está activada, abre la subpestaña Conexiones y comprueba la columna Ámbito. Una conexión de solo lectura no puede ejecutar habilidades de escritura, y no hay un interruptor para cambiarla: haz clic en Revocar, reconecta tu asistente y elige Leer y escribir en la página de aprobación. Consulta Cómo conectar ChatGPT o Claude a tu tienda con MCP.
Faltan las habilidades del Addon de Traducción
Confirma que el Addon de Traducción está activo y actualizado a la versión 1.0.1 o posterior, y que Product Feed Pro está activo junto a él.
Product Feed Pro y Elite parecen registrar el mismo nombre de habilidad
Esto es esperado e inofensivo. Solo se registra una copia de cada nombre. Con Product Feed Pro 13.5.7 o posterior y Elite 5.1.0 o posterior, Pro registra cada habilidad y Elite omite sus copias. Con Elite 5.0.9, la copia de Elite se registra primero y Pro la omite. Los nombres son los mismos de cualquier manera, por lo que tus llamadas siguen funcionando. Actualiza Elite a la versión 5.1.0 o posterior para que Pro las posea todas.

Preguntas frecuentes

¿Necesito Product Feed Elite para usar habilidades de IA?
No. Las 25 habilidades principales están registradas por el plugin gratuito Product Feed Pro. Elite solo añade el detalle de la API de Conversiones de Facebook a adtribes/get-tracking-status.
¿Necesito StoreAgent para conectar un asistente?
StoreAgent es la ruta de conexión que documenta este artículo. Es lo que proporciona el endpoint MCP al que se conecta un asistente como Claude o ChatGPT, y donde apruebas cuánta acceso obtiene una conexión.
¿Cambiará la actualización de Product Feed Pro los nombres de las habilidades que mi automatización ya llama?
No. La propiedad de las 12 habilidades que se trasladaron de Elite a Pro cambió, pero los nombres adtribes/... se mantuvieron iguales, por lo que las llamadas existentes siguen funcionando.
¿Las habilidades omiten las salvaguardas normales del plugin?
No. Cada habilidad llama a los mismos métodos de capa de servicio que usan la interfaz de administración y WP-CLI, por lo que se aplican la misma validación, ganchos y comportamiento de Action Scheduler.
¿Hay un número máximo de feeds que puedo actualizar en una sola llamada?
Sí, adtribes/bulk-update-feeds acepta hasta 500 IDs de feed por llamada. Para más, divide la solicitud en lotes.

¿Necesitas más ayuda?

Si tienes Product Feed Elite, puedes abrir un ticket de soporte para obtener ayuda prioritaria con la integración de tus habilidades de IA.

Si usas el plugin gratuito Product Feed Pro, puedes hacer una pregunta en el foro de soporte de WordPress.org.

¿Te ha resultado útil este artículo?

Artículos relacionados

Completa tu compra
Feed de productos de WooCommerce de AdTribes

El mejor plugin de feeds de productos de WooCommerce

  • AdTribes Pty Ltd
    ABN: 40 675 636 816
Producto
Recursos e información
Sitios asociados
Rymera