¿Qué es la API de Habilidades de WordPress?

La API de Habilidades de WordPress es una forma estándar para que los plugins indiquen a las herramientas de IA qué pueden hacer. Se incluyó en WordPress 6.9. La conecté a WP Mail SMTP y le pedí a una IA que leyera mis registros de correo electrónico. Respondió en segundos.

Hasta ahora, no existía una forma compartida para que las herramientas externas vieran lo que tu sitio podía hacer. Cada plugin hablaba su propio idioma. Un agente de IA tenía que adivinar, o tú tenías que escribir código personalizado.

En esta guía, aprenderás qué son las habilidades y cómo se aplican a las herramientas de IA. También verás exactamente qué pueden leer WP Mail SMTP y WPForms.

La mayor parte de esto no requiere código. También hay una sección para desarrolladores cerca del final.

¿Qué es la API de Habilidades de WordPress?

La API de Habilidades de WordPress es un registro central donde los plugins, temas y el núcleo de WordPress declaran lo que pueden hacer. Cada capacidad declarada se llama "habilidad".

Una habilidad es una unidad clara de funcionalidad. Piensa en "leer los últimos 10 correos electrónicos" o "obtener las estadísticas de envío de este mes". Cada habilidad tiene cuatro partes:

• Entrada: los datos que necesita para ejecutarse
• Salida: los datos que devuelve
• Ejecutar: la acción que realiza
• Permiso: la comprobación de quién tiene permitido ejecutarla

El registro es legible tanto por máquinas como por humanos. Así, un agente de IA, otro plugin o un desarrollador pueden consultarlo y entenderlo. WordPress almacena cada habilidad en un solo lugar, llamado WP_Abilities_Registry.

¿Cómo funciona la API de Habilidades?

La API de Habilidades funciona manteniendo cada habilidad en un único registro que cualquier herramienta puede consultar. Un plugin registra sus habilidades cuando WordPress se inicia. Cada una lleva sus propias reglas.

Esas reglas realizan tres trabajos:

• JSON Schema comprueba los tipos de entrada y salida antes de que se ejecute nada.
• Una devolución de llamada de permiso confirma que el usuario o la herramienta tienen permiso para ejecutar la habilidad.
• Marcadores de metadatos marcan una habilidad como de solo lectura, destructiva o idempotente, para que las herramientas conozcan las consecuencias.

También hay un marcador show_in_rest. Permite que una habilidad aparezca en la API REST de WordPress cuando un desarrollador la activa. Esto mantiene la exposición deliberada, no automática.

¿Cómo se conectan las habilidades a los agentes de IA (el adaptador MCP)?

Las habilidades están disponibles para los agentes de IA a través del Adaptador MCP de WordPress. MCP significa Model Context Protocol. Es el lenguaje compartido que las herramientas de IA utilizan para hablar con sistemas externos.

El adaptador MCP permite a las herramientas de IA acceder a estas habilidades. Lee tus habilidades registradas y las convierte en partes de MCP:

• Herramientas: habilidades que ejecutan una acción
• Recursos: habilidades que devuelven datos para leer
• Indicaciones: plantillas listas para tareas comunes

Funciona sobre HTTP para sitios en vivo, o STDIO para desarrollo local. El inicio de sesión utiliza contraseñas de aplicación de WordPress. Una vez que esté activo, las herramientas de MCP como Claude, ChatGPT, Cursor y VS Code podrán descubrir y utilizar tus habilidades.

¿Por qué es importante la API de Habilidades?

La API de Habilidades es importante porque proporciona a la IA una forma fiable de acceder a tu sitio. Antes, no había un estándar. Las herramientas tenían que escanear rutas REST o leer el código del plugin para adivinar lo que era posible.

Ahora la recompensa es simple:

• Un registro para descubrir: las herramientas encuentran cada capacidad en un solo lugar.
• Solo lectura por defecto: la mayoría de las habilidades solo leen datos, por lo que son seguras de exponer.
• Sin pegamento personalizado: te saltas la integración a medida que cada plugin solía necesitar.
• Seguridad consistente: cada habilidad se ejecuta dentro del mismo modelo de permisos.

Para los propietarios de sitios, significa que puedes hacer preguntas reales a una IA sobre tu sitio. Para los desarrolladores, significa que tu plugin obtiene soporte de IA sin un SDK separado.

Soluciona tus correos de WordPress ahora

¿Qué puede hacer WP Mail SMTP con la API de Habilidades?

WP Mail SMTP utiliza la API de Habilidades para permitir que las herramientas de IA lean tus datos de correo electrónico, solo lectura. Un asistente conectado revisa tu actividad de correo electrónico y responde preguntas. Nunca envía correos, elimina datos ni cambia tu configuración.

Esto es lo que expone:

• Buscar y filtrar correos electrónicos registrados por estado, remitente, fecha y destinatario
• Obtener los detalles completos de un solo correo electrónico y su contenido cuando necesites una mirada más cercana
• Leer estadísticas de envío de tus Informes
• Comprobar eventos de depuración para ayudar a rastrear un problema de entrega

Estas habilidades leen del Registro de Correos y los Informes, que forman parte de WP Mail SMTP Pro. Tu sitio necesita WordPress 6.9 o posterior y WP Mail SMTP 4.9 o posterior.

Una vez conectado, puedes preguntar cosas como "¿Se enviaron hoy mis correos de restablecimiento de contraseña?" Para verlo en acción, lee nuestra guía para monitorizar tu correo electrónico de WordPress con IA.

¿Qué habilidades expone WPForms?

WPForms expone habilidades de lectura y escritura para las entradas de tus formularios. Un asistente de IA puede crear formularios, leer envíos, resumirlos y responder preguntas sobre ellos.

Eso abre preguntas rápidas y útiles:

• ¿Cuántas entradas llegaron esta semana?
• Resume los comentarios de mi formulario de encuesta.
• ¿Qué formulario recibe más envíos?

Las reglas son bastante diferentes para WPForms. Opcionalmente, puedes habilitar el acceso de escritura para permitir que el asistente cree y administre formularios en tu sitio. Simplemente darás una indicación del tipo de formulario que deseas crear, y se creará automáticamente para ti.

Cómo usar la API de Habilidades con WP Mail SMTP

Para usar WP Mail SMTP con asistentes de IA, primero deberás actualizar el plugin a la versión 4.9 o posterior. Luego, conecta una herramienta de IA. Aquí están los pasos para WP Mail SMTP:

1. Actualiza a WordPress 6.9 o posterior.
2. Actualiza a WP Mail SMTP 4.9 o posterior.
3. Ve a WP Mail SMTP » Herramientas, luego abre la pestaña AI MCP.
4. Instala y activa WPVibe, luego conecta tu asistente de IA.

Esa es la versión corta. Para la guía completa con capturas de pantalla, sigue nuestra guía sobre cómo conectar WP Mail SMTP a asistentes de IA.

¿Cómo registran los desarrolladores una habilidad?

Los desarrolladores registran una habilidad con la función wp_register_ability(). La llamas dentro de una función enganchada a la acción wp_abilities_api_init. Aquí tienes un ejemplo sencillo:

add_action( 'wp_abilities_api_init', 'myplugin_register_abilities' );

function myplugin_register_abilities() {
    wp_register_ability(
        'myplugin/get-recent-orders',
        array(
            'label'               => __( 'Get recent orders', 'myplugin' ),
            'description'         => __( 'Returns the 10 most recent orders.', 'myplugin' ),
            'category'            => 'myplugin',
            'input_schema'        => array(
                'type'       => 'object',
                'properties' => array(
                    'limit' => array( 'type' => 'integer' ),
                ),
            ),
            'output_schema'       => array( 'type' => 'array' ),
            'execute_callback'    => 'myplugin_get_recent_orders',
            'permission_callback' => function () {
                return current_user_can( 'manage_options' );
            },
        )
    );
}

¿Cómo es wp_register_ability()?

La función toma dos cosas: un nombre único y una matriz de configuraciones. El nombre usa el formato vendor/ability, como myplugin/get-recent-orders. La matriz de configuraciones define el resto:

• label y description: nombres legibles por humanos para la habilidad
• category: un grupo al que pertenece la habilidad
• input_schema y output_schema: Esquema JSON para los datos de entrada y salida
• execute_callback: la función que ejecuta el trabajo
• permission_callback: la función que concede o deniega el acceso

¿Cómo mantienen seguras las habilidades las devoluciones de llamada de permisos?

Las devoluciones de llamada de permisos deciden quién puede ejecutar una habilidad. La tuya debería devolver una comprobación de current_user_can(), para que solo los usuarios correctos pasen. El ejemplo anterior limita la habilidad a los administradores.

Tres capas más lo respaldan. El Esquema JSON rechaza entradas del tipo incorrecto. Las marcas de metadatos advierten a las herramientas cuando una habilidad cambia datos. Y show_in_rest mantiene la exposición REST opt-in en lugar de automática.

A continuación, Conecta tu sitio a ChatGPT

Ahora sabes qué es la API de Habilidades de WordPress, cómo llega a las herramientas de IA y qué exponen tus plugins a través de ella.

El siguiente paso es usar una. Mi guía sobre cómo conectar tu sitio de WordPress a ChatGPT te guía a través de ella, sin necesidad de código. Una vez que actualices a la última versión de WP Mail SMTP y conectes tu sitio usando un conector como WPVibe, puedes preguntar a un asistente sobre tus registros de correo electrónico en lenguaje natural.

Soluciona tus correos de WordPress ahora

Listo para crear tu formulario? Empieza hoy mismo con el plugin de creación de formularios de WordPress más fácil. WPForms Pro incluye muchas plantillas gratuitas y ofrece una garantía de devolución de dinero de 14 días.

Si este artículo te ha sido útil, síguenos en Facebook y Twitter para más tutoriales y guías gratuitas de WordPress.