AI Bridge
AI Bridge es un módulo opcional que expone los datos de tu tienda a asistentes y herramientas de IA de forma controlada. Consta de dos partes. La primera es un conjunto de capacidades de solo lectura registradas en la WordPress Abilities API (WP 6.9+), de modo que la paleta de comandos del editor del sitio, los servidores MCP y los asistentes de IA pueden leer los mismos datos que vería un administrador humano. La segunda son dos ayudantes asistidos por IA en el panel de administración: un resumen de producto y un borrador de texto de seguridad GPSR, ambos mediante el WordPress AI Client (WP 7.0+) a través del proveedor configurado en el sitio.
El módulo nunca cambia nada automáticamente. Las capacidades solo leen datos, y los ayudantes de IA generan propuestas para revisión, sin sobrescribir nunca campos que requieren autorización manual. El plugin nunca almacena una clave de proveedor de IA. Es una herramienta de ayuda, no asesoramiento legal ni una garantía de cumplimiento.
Activar el módulo
Section titled “Activar el módulo”El módulo está desactivado de forma predeterminada. Actívalo en WooCommerce > Polski > Módulos (la sección “AI Bridge”, clave de módulo ai_bridge). Una vez activado:
- en WordPress 6.9+ se registran las capacidades de comercio (cuando la Abilities API está disponible); en versiones anteriores de WordPress el módulo no hace nada de forma segura y simplemente omite el registro,
- los ayudantes de IA (resumen de producto, borrador GPSR) solo quedan disponibles cuando el sitio tiene configurado un proveedor de IA para la generación de texto (mediante el WP AI Client / conector, por ejemplo Anthropic, Google, OpenAI, Vercel AI Gateway). Sin un proveedor configurado, estos ayudantes simplemente permanecen inactivos, y la ruta determinista del AI Feed no se ve afectada.
Capacidades de comercio (solo lectura)
Section titled “Capacidades de comercio (solo lectura)”Todas las capacidades pertenecen a la categoría polski-commerce, están marcadas como readonly y show_in_rest, y están protegidas por la capacidad de WooCommerce manage_woocommerce. Cada una está conectada a un servicio existente del plugin, por lo que no reimplementa la lógica. No se cambia nada.
| Capacidad (id) | Qué devuelve | Entrada |
|---|---|---|
polski/get-omnibus-history | Historial de precios y el precio más bajo registrado de un producto (tal como se usa para la presentación según la Directiva Omnibus). | product_id |
polski/get-gpsr-data | Datos de seguridad del producto (GPSR): fabricante, importador, persona responsable, identificador, advertencias, instrucciones. | product_id |
polski/list-products-missing-gpsr | Productos publicados a los que les falta uno o más campos GPSR, para poder localizar y rellenar los vacíos. | limit (1-200), offset |
polski/get-compliance-status | El resultado de las comprobaciones heurísticas de las páginas legales configuradas (Términos, Privacidad, Devoluciones, Reclamaciones) con una puntuación. | page_type (opcional) |
polski/get-store-health | La instantánea más reciente del estado de la tienda (estado general más los sensores de errores fatales, pagos y ventas). | (ninguna) |
polski/get-product-facts | La lista estructurada de datos del producto (pares etiqueta/valor) que muestra el AI Feed: SKU, GTIN, precio, categorías, tiempo de entrega y más. | product_id |
Cada llamada pasa por un permission_callback que comprueba manage_woocommerce. Un usuario sin esa capacidad no obtiene datos. Las capacidades son accesibles a través de REST (/wp-json/wp-abilities/v1/...) cuando la Abilities API está activa.
Resumen de producto (IA)
Section titled “Resumen de producto (IA)”Un resumen fáctico de un producto, a demanda y activado por el administrador. Solo funciona cuando el módulo está activado y hay configurado un proveedor de IA capaz de generar texto. No se genera nada al cargar la página.
| Aspecto | Comportamiento |
|---|---|
| Datos de origen | El nombre del producto, la descripción corta y larga, más la lista de datos del AI Feed - solo datos que la tienda ya publica. |
| Modelo | Se le indica que use únicamente los datos proporcionados, que no invente especificaciones ni precios, sin lenguaje de marketing y sin afirmaciones legales. |
| Longitud | Corto, 1-3 frases; el resumen almacenado está limitado a 600 caracteres. |
| Almacenamiento | Se guarda en los metadatos del producto (_polski_ai_summary) solo después de que un administrador active explícitamente la generación. |
| Sin proveedor | La función no está disponible; no ocurre nada, y las demás rutas siguen funcionando sin cambios. |
Borrador de texto de seguridad GPSR (IA)
Section titled “Borrador de texto de seguridad GPSR (IA)”Un ayudante que produce un borrador de advertencias de seguridad del producto e instrucciones de uso como punto de partida para la revisión humana. Es asistencia editorial, no asesoramiento legal ni una garantía de cumplimiento.
| Aspecto | Comportamiento |
|---|---|
| Datos de origen | La descripción pública del producto más los campos GPSR ya introducidos por una persona, de modo que el borrador no contradiga los datos existentes. |
| Modelo | Se le indica que use únicamente los datos proporcionados, que no invente peligros ni certificaciones, y que no afirme ni dé a entender cumplimiento legal. |
| Almacenamiento | Se escribe únicamente en un metadato de borrador separado y con nombre claro (_polski_ai_gpsr_draft). Nunca sobrescribe los campos GPSR reales. |
| Revisión | Un administrador debe leer el borrador y copiarlo manualmente en los campos reales tras la verificación. Cada borrador lleva una nota de que es solo para revisión y no constituye una garantía de cumplimiento. |
| Longitud | Cada campo de borrador está limitado a 1500 caracteres. |
Privacidad y claves
Section titled “Privacidad y claves”El plugin nunca almacena una clave de proveedor de IA y nunca realiza por sí mismo la solicitud saliente al proveedor. Las credenciales y la llamada de red pertenecen al conector de IA configurado en WordPress (un modelo de “trae tu propia clave”). Al modelo solo se envían datos que la tienda ya publica o almacena.
Resolución de problemas
Section titled “Resolución de problemas”Las capacidades no aparecen - asegúrate de estar en WordPress 6.9+ con la Abilities API activa y de que el módulo AI Bridge está activado. En versiones anteriores de WordPress, el registro se omite sin error.
Los ayudantes de IA aparecen atenuados - configura un proveedor de IA capaz de generar texto mediante el WP AI Client / conector. Sin un proveedor, el resumen y el borrador GPSR permanecen inactivos.
Una capacidad no devuelve datos - comprueba que el usuario actual tenga la capacidad manage_woocommerce.
Reportar problemas: github.com/wppoland/polski/issues