El cliente AI de WordPress 7.0 desde la perspectiva de un desarrollador

WordPress 7.0 incorpora un cliente de IA. No como un plugin, no como una característica experimental, sino como parte del núcleo. Esto es una afirmación.

Llevo desarrollando plugins para WordPress desde 2009 y he trabajado con citelayer Yo mismo he creado un plugin de IA que se ve directamente afectado por esta decisión arquitectónica. He aquí mi análisis técnico: ¿qué puede hacer la API, cuáles son sus puntos fuertes y qué deben saber los desarrolladores de plugins?

El punto de entrada: wp_ai_client_prompt()

Todo empieza con una única función:

$builder = wp_ai_client_prompt();

Esto da una WP_AI_Client_Prompt_Builder-objeto - un Fluent Builder a través del cual se vinculan el prompt, la configuración y el método de generación. El principio básico: El desarrollador describe, qué que necesita. WordPress se encarga de como.

Un ejemplo sencillo de generación de texto:

// Preguntar directamente como parámetro - conveniente para casos sencillos
$text = wp_ai_client_prompt( 'Resuma los beneficios del almacenamiento en caché en WordPress.' )
    ->using_temperature( 0.7 )
    ->generate_text();

// Manejo de errores como en todas partes en WordPress: Comprobar WP_Error
if ( is_wp_error( $text ) ) {
    return;
}

echo wp_kses_post( $text );

El texto del aviso puede establecerse como parámetro o mediante con_texto() Esto último es útil si el aviso se monta dinámicamente.

Más que texto: Imagen, lenguaje, vídeo

La API es multimodal. La generación de imágenes funciona según el mismo patrón:

use WordPress\AiClient\Files\DTO\File;

$image = wp_ai_client_prompt( 'Un logo futurista de WordPress en estilo neón' )
    ->generate_image();

if ( is_wp_error( $image ) ) {
    return;
}

// Archivo DTO con Data URI - directamente utilizable
echo '<img src="' . esc_url( $image->getDataUri() ) . '" data-no-translation="" data-no-auto-translation="">';

Para las variaciones existen generar_imágenes( 4 ) y generar_textos( 4 ). Además convertir_texto_en_voz_resultado(), generar_resultado_de_voz() y generar_vídeo_resultado(). WordPress cubre todas las modalidades habituales.

Especialmente emocionante: resultados multimodales en una sola investigación:

use WordPress\AiClient\Messages\Enums\ModalityEnum;

// Texto e imágenes en una respuesta - el resultado contiene ambos
$result = wp_ai_client_prompt( 'Crear una receta con fotos para cada paso.' )
    ->as_output_modalities( ModalityEnum::text(), ModalityEnum::image() )
    ->generate_result();

Esto abre la puerta a plugins que generan contenidos que van más allá del puro texto.

Detección de características: no haga suposiciones

No todas las instalaciones de WordPress tendrán configurado un proveedor de AI. Y no todos los proveedores admiten todas las modalidades. La API ofrece comprobaciones deterministas:

$builder = wp_ai_client_prompt( 'test' )
    ->using_temperature( 0.7 );

// No hay llamada a la API - comprobación puramente lógica con los proveedores disponibles
if ( $builder->is_supported_for_text_generation() ) {
    // Mostrar UI para generación de texto
}

if ( $builder->is_supported_for_image_generation() ) {
    // Mostrar botón de generación de imagen
}

Es una solución limpia. Las comprobaciones no cuestan nada: no hay llamadas a la API ni latencia. Los desarrolladores de plugins pueden cargar su interfaz de usuario condicionalmente y mostrar una sugerencia útil si no hay IA disponible. La regla: Nunca dé por sentado que las funciones de AI funcionarán sólo porque WordPress 7.0 esté instalado.

Cheques disponibles: is_supported_for_text_generation(), is_supported_for_image_generation(), is_supported_for_text_to_speech_conversion(), is_supported_for_speech_generation(), is_supported_for_video_generation().

Modelar preferencias en lugar de requisitos

La filosofía de diseño queda clara aquí:

$result = wp_ai_client_prompt( 'Explique la historia de la imprenta.' )
    ->using_temperature( 0.1 )
    ->using_model_preference(
        'claude-sonnet-4-6',
        'gemini-3.1-pro-preview',
        'gpt-5.4'
    )
    ->generate_text_result();

using_model_preference() es un Preferencia, ningún requisito. El cliente de IA toma el primer modelo disponible de la lista, o cualquiera compatible si no hay ninguno configurado. El código del plugin siempre funciona, independientemente del proveedor.

Esta es la decisión correcta. Los desarrolladores de plugins nunca deben depender de que un modelo concreto esté disponible. La recomendación oficial es ordenar los modelos de modo que los más recientes vayan antes que los más antiguos. Los tres plugins proveedores oficiales para el lanzamiento ya lo hacen.

Respuestas estructuradas con esquema JSON

Se trata de un punto fuerte para los plugins que requieren datos estructurados, que son muchos:

$schema = array(
    'type' => 'array',
    'items' => array(
        'type' => 'object',
        'properties' => array(
            'plugin_name' => array( 'type' => 'string' ),
            'category' => array( 'type' => 'string' ),
        ),
        'required' => array( 'plugin_name', 'category' ),
    ),
);

$json = wp_ai_client_prompt( 'Enumera 5 plugins populares de WordPress con categoría.' )
    ->as_json_response( $schema )
    ->generate_text();

// Estructurar los datos directamente como un array - no requiere análisis manual
$data = json_decode( $json, true );

Esto vale su peso en oro para plugins SEO, plugins de formularios y herramientas de análisis de contenidos. En lugar de analizar texto no estructurado, se obtienen datos directamente utilizables.

La arquitectura de dos capas

Bajo el capó, el Cliente AI consta de dos niveles:

1. Cliente PHP AI (wordpress/php-ai-client) - un SDK de PHP agnóstico para proveedores, incluido como biblioteca externa en Core. Métodos CamelCase, excepciones, técnicamente independiente de WordPress.
2. WordPress Wrapper — WP_AI_Client_Prompt_Builder desarrolla el SDK en las convenciones de WordPress: métodos snake_case, WP_Error en lugar de excepciones, la integración con el transporte HTTP de WordPress, la API de habilidades, la infraestructura de conectores y el sistema de ganchos.

Se trata de una separación elegante. En teoría, el SDK de PHP también puede utilizarse fuera de WordPress. La envoltura de WordPress lo hace idiomático. Y eso GenerativeAiResult-objeto puede serializarse y conectarse directamente a rest_ensure_response() Integración inmediata de la API REST:

function my_rest_callback( WP_REST_Request $request ) {
    $result = wp_ai_client_prompt( $request->get_param( 'prompt' ) )
        ->generate_text_result();

    // WP_Error oder GenerativeAiResult — beides funktioniert
    return rest_ensure_response( $result );
}

Control granular: el filtro

Para la seguridad y el cumplimiento de la normativa existen wp_ai_client_prevent_prompt:

add_filter(
    'wp_ai_client_prevent_prompt',
    function ( bool $prevent, WP_AI_Client_Prompt_Builder $builder ): bool {
        // Ejemplo: AI sólo para administradores
        if ( ! current_user_can( 'manage_options' ) ) {
            return true;
        }
        return $prevent;
    },
    10,
    2
);

Si se bloquea un aviso: no hay llamada a la API, is_supported_*() da falso atrás, generar_*() suministros WP_Error. Limpio, predecible, sin condiciones de carrera.

Puntos fuertes y débiles

Lo cual es una buena solución:

• La abstracción del proveedor. Los desarrolladores de plug-ins nunca tienen que lidiar con claves API, límites de tarifa o peculiaridades de los proveedores.
• Detección de funciones sin llamadas a la API. Nada de adivinar si algo funciona.
• Las convenciones de WordPress. WP_Error, ganchos, compatibilidad REST: parece nativo.
• Compatibilidad con el esquema JSON. Se admiten respuestas estructuradas de primera clase.
• Arquitectura de dos niveles. Separación limpia entre el SDK y la integración de WordPress.

Lo que observo críticamente:

• El propietario del sitio es responsable de la configuración del conector. Los plugins no tienen ninguna influencia en esto, si se configura un proveedor. La detección de funciones lo soluciona, pero la experiencia del usuario sigue siendo un reto.
• El panorama del modelismo se mueve con rapidez. Queda por ver lo bien que envejecerá la lista de preferencias cuando aparezcan nuevos modelos cada tres meses.
• Todavía no están claras las implicaciones para el rendimiento. Cómo se comporta el sistema bajo carga cuando 10 plugins envían avisos al mismo tiempo?

Qué significa esto para los plugins existentes

Todos los plugins que actualmente tienen sus propias integraciones de IA se enfrentan a una decisión: ¿Mantener su propia conexión API o migrar al cliente de IA?

Para Plugins SEO la respuesta es clara: los datos estructurados, el análisis de contenidos y la generación de meta descripciones se ejecutan de forma mucho más limpia a través del cliente AI. Para Plugins de formularios abre la validación inteligente de campos y el autocompletado. Para Plugins de comercio electrónico Las descripciones de productos generadas por IA se convierten de repente en algo trivial.

Para un plugin como citelayer® - AI Visibilidad para WordPress, que trabaja en la interfaz entre WordPress y los sistemas de IA, el cliente de IA es una extensión natural. Citelayer hace que el contenido sea legible para la IA, mediante llms.txt, inyección de esquemas, seguimiento de bots y protocolos como UCP y WebMCP. El cliente de IA podría complementar estas capas de análisis con análisis más inteligentes y asistidos por IA. He explicado lo que esto significa para la visibilidad de la IA en términos concretos. con más detalle en el blog de Citelayer.

No es un artilugio, sino una infraestructura

El cliente AI de WordPress 7.0 no es un gadget. Es una infraestructura. Bien pensada, WordPress-idiomática y con una filosofía de diseño clara: el desarrollador describe la intención, el sistema se encarga de la ejecución.

Cualquiera que desarrolle plugins para WordPress hoy en día debería familiarizarse con esta API. No porque sea necesario, sino porque es la base sobre la que se construirá la próxima generación de plugins de WordPress.

La documentación completa de la API está disponible en WordPress Hacer Blog.