WordPress 官方发布 AI 客户端 SDK，统一接口简化多模型调用

Denis | 邓鸿华 WordPress 413 2025年12月02日

WordPress 官方正式推出 AI 客户端 SDK（wordpress/wp-ai-client 0.1.0），该工具为插件和主题开发者提供了统一的接口，使其能够通过一套标准化 API 调用多个主流生成式 AI 服务，大幅降低了多模型适配的复杂度。

基于 PHP AI 客户端 SDK 构建的 WordPress AI 客户端 SDK，深度适配 WordPress 生态，比如在底层使用 WordPress HTTP API，集成后台 AI 凭证管理界面，在之后的版本还将和 WordPress 的 Abilities API 集成。

WordPress AI 客户端 SDK 的功能

一句话总结就是：该 SDK 旨在使“插件调用 AI 模型”成为一种成熟、可重复的模式。

  • 一个为 WordPress 开发者设计的基于 PHP AI 客户端构建的流畅的提示构建器 API：AI_Client::prompt()
  • 一个可以让管理员配置 AI 模型的 API 密钥的 WordPress 后台管理面板，并且在提示执行时，自动连接到底层的 PHP AI 客户端。
  • 通过WordPress 的方式 wp_remote_request() 来处理 HTTP 请求

所以总体来说，WordPress AI Client SDK 为插件和主题提供了一种统一的方式来处理不同的 AI 提供商和模型系列，而无需重新设计凭证管理或 HTTP 集成。

目前的 0.1.0 版本是 SDK 的首个“开发者可用”版本，意思就是你在 WordPress 对接 AI 接口进行二次开发的时候，使用它可以事半功倍的效果。

后续 WordPress 官方将会继续扩展功能，比如提供 WordPress Abilities API 集成、REST API 接口，以及与服务器端功能等效的基于JavaScript /TypeScript 的客户端提示构建器 API。

快速安装指南和第一个提示

如需在插件中添加 SDK，请执行以下操作：

1. 使用 Composer 引入该包：

composer require wordpress/wp-ai-client

2. 在插件 init 中初始化：

use WordPress\AI_Client\AI_Client;
 
add_action( 'init', array( AI_Client::class, 'init' ) );

3. 在 WordPress 后台，设置 → AI 凭证，输入要使用的提供商的 API 密钥。

4. 现在就可以写你的第一个提示了：

use WordPress\AI_Client\AI_Client;
 
$summary = AI_Client::prompt( 'Summarize the history of the printing press.' )
    ->using_temperature( 0.1 )
    ->generate_text();

自动模型选择和使用特定模型

上述代码片段执行的过程中，SDK 会自动根据给定的提示和配置选择合适的模型，这使得您的插件与提供商无关，这是在大多数 WordPress 网站上运行的推荐模式，因为大多数网站可能只会配置特定的 AI 模型提供商（例如 Anthropologie、Google、OpenAI），这意味着插件只能使用来自已配置提供商的模型。

换句话说，就是 SDK 自动选择一个支持所需所有功能的模型，然后它将获取已配置的凭据，并将请求路由到相应的提供商客户端。

如果您有想要使用的特定模型，建议提供一份这些型号的偏好列表：

use WordPress\AI_Client\AI_Client;
 
$summary = AI_Client::prompt( 'Summarize the history of the printing press.' )
    ->using_temperature( 0.1 )
    ->using_model_preference(
        'claude-sonnet-4-5',    // 首选
        'gemini-3-pro-preview', // 备选
        'gpt-5.1'               // 第三选择
    )
    ->generate_text();

SDK 将使用列表中第一个在 WordPress 站点上配置了其提供商的模型，如该模型无法使用，它将选择接下来可用的模型。

也可以强制使用单个特定的模型，但是这就意味着未配置该模型提供商的网站将无法使用相应的 AI 功能，因此为了获得最佳兼容性和覆盖范围，建议使用上述更灵活的方法之一。

如果还是希望仅允许使用单个特定模型，则应该通过逻辑首先检查该模型是否可用，并根据条件启用相应的功能：

use WordPress\AI_Client\AI_Client;
use WordPress\AiClient\ProviderImplementations\Anthropic\AnthropicProvider as Anthropic;
 
$prompt = AI_Client::prompt( 'Summarize the history of the printing press.' )
    ->using_temperature( 0.1 )
    ->using_model( Anthropic::model( 'claude-sonnet-4-5' ) );
 
if ( $prompt->is_supported_for_text_generation() ) {
    // Expose the feature, call `$prompt->generate_text()` etc.
} else {
    // Fallback: Hide feature or show setup instructions.
}

上述方法 is_supported_for_text_generation()（或其他人工智能功能，例如图像生成等等效方法）通常用语检测特定的人工智能功能是否支持，这样就可以确保仅向用户显示真正能在 WordPress 网站上运行的功能，如果结果为否定，则可以选择回退到该功能的非人工智能版本，显示一条消息告知用户如何访问该功能，或者直接完全隐藏该功能。

WordPress AI 基础构建模块

WordPress AI 客户端 SDK 是 AI 的核心构建模块之一，与Abilities API 和 MCP 适配器并列：

  • Abilities API：以统一、机器可读的方式描述 WordPress 能做什么。从 6.9 版本开始已成为核心 API！
  • MCP Adapter：通过模型上下文协议将这些功能暴露给外部 AI 工具。
  • WordPress AI 客户端 SDK：使插件和主题能够直接从 WordPress 内部调用上游 AI 提供商的能力。

未来的迭代将基于 0.1.0 构建，增加额外的接口，例如 REST 和客户端 API，以便服务器端代码和 WordPress 管理后台中的 JavaScript 应用程序都可以共享相同的 AI 客户端基础设施。

有关更多详细信息和示例，参阅 wordpress/wp-ai-client GitHub 仓库的 README和贡献文档。

©我爱水煮鱼，本站推荐使用的主机：阿里云，国外主机建议使用BlueHost。

本站长期承接 WordPress 优化和建站业务，请联系微信：「chenduopapa」。

生成海报
标签：