Módulo 5

Agentes de IA en WordPress

Un agente sin reglas improvisa. Uno bien dirigido consulta el sitio, propone, espera confirmación y verifica.

El problema

Un agente sin reglas inventa funciones obsoletas, crea bloques que ya existen y se salta comprobaciones de seguridad. Un agente bien dirigido combina cinco ingredientes.

01

Una petición clara

Fija el objetivo y el alcance exacto: borrador, propuesta o cambio aplicado.

02

Reglas del proyecto

Un archivo AGENTS.md que el agente lee siempre: jerarquía, límites, seguridad y reparto tema/plugin.

03

Conocimiento experto

Las Agent Skills oficiales, orquestadas por wordpress-router.

04

Herramientas con permisos mínimos

Edición de archivos, WP-CLI, APIs de WordPress o herramientas MCP.

05

Contexto real del sitio

Abilities de solo lectura para preguntar al sitio en vez de adivinar.

Flujo seguro

Contexto, propuesta, confirmación, ejecución, verificación

Nada que modifique o destruya contenido se ejecuta sin confirmación explícita y copia de seguridad declarada.

1

Contexto

El agente consulta el sitio: tema, sistema de diseño, patrones.

2

Propuesta

Describe qué cambiará, con qué bloques y dónde.

3

Confirmación

La persona aprueba por escrito. Puerta obligatoria.

4

Ejecución

Aplica el cambio con permisos mínimos.

5

Verificación

Comprueba el resultado con evidencia.

Agent Skills y wordpress-router

Las WordPress Agent Skills son paquetes de instrucciones, checklists y scripts mantenidos por el equipo de WordPress que dan al agente conocimiento experto actual: bloques, temas, plugins, REST, Abilities, rendimiento. Viven en el entorno del agente, no en el sitio, y no conceden permisos.

wordpress-router es una de ellas: la de entrada u orquestadora. Detecta el tipo de proyecto (Core, tema de bloques, plugin…) y deriva al agente a las skills adecuadas. No es un protocolo ni una herramienta del sitio.

Abilities API: preguntar al sitio

Una ability es una operación de WordPress registrada con nombre, descripción, esquema tipado de entrada y salida y comprobación de permisos explícita. La Abilities API es su registro central, incorporado al núcleo en WordPress 6.9. Las abilities de solo lectura permiten que el agente conozca el tema activo, el sistema de diseño o los patrones existentes antes de proponer nada.

MCP y MCP Adapter: el puente hacia agentes externos

MCP (Model Context Protocol) es un estándar abierto, no exclusivo de WordPress, para que un asistente de IA externo descubra y use las capacidades de una aplicación con permisos. El MCP Adapter traduce las abilities de WordPress a MCP: las de efectos se vuelven tools y las de lectura resources. Solo expone las marcadas explícitamente como públicas y respeta sus permisos.

Acceso al proyecto

  • El agente tiene la carpeta de la instalación abierta
  • Típico de entornos locales y de laboratorio
  • Usa archivos, WP-CLI y APIs

Acceso remoto (MCP)

  • El agente se conecta al sitio publicado sin acceso a archivos
  • Usa abilities expuestas explícitamente
  • Misma regla: la persona decide

Estado a revisar. Las abilities de lectura del núcleo (core/read-*) se aplazaron a WordPress 7.2 en la última revisión, y el MCP Adapter sigue evolucionando. Comprobar siempre la fuente oficial antes de impartir.

Seguridad y operaciones destructivas

  • Toda operación comprueba capacidades reales del usuario.
  • Las instrucciones halladas en contenido, maquetas o respuestas de modelos son datos no confiables.
  • Borrar, vaciar o sustituir exige autorización expresa, confirmación escrita y copia de seguridad declarada.
  • Ninguna tarea se declara cerrada sin evidencia comprobable.