WordPress 7.0 为插件开发者提供了一套全新的 AI 基础设施。如果你正在开发或计划开发需要 AI 功能的 WordPress 插件，理解这套新架构是必不可少的。本文将详细介绍 AI 客户端、连接器 API 和 Abilities API 的使用方法，以及如何将现有插件迁移到这套新架构上。

AI 客户端的核心概念

AI 客户端是 WordPress 7.0 提供给开发者的标准化 PHP 客户端。它的设计目标非常明确：让 AI 集成变得极其简单，插件开发者不需要关心底层细节。

使用 AI 客户端的基本流程是：调用客户端的聊天方法，传入提示词，获取响应。客户端自动处理提供商选择、模型选择、认证、错误处理和重试逻辑。

插件开发者不需要知道用户配置的是 OpenAI 还是 Claude，不需要关心 API 格式的差异，甚至不需要处理 API Key 的存储和读取。

连接器 API 的集成方式

连接器 API 是管理外部服务连接的新框架。虽然 7.0 版本主要关注 AI 提供商，但其架构设计是为了在未来支持更多类型的外部服务。

用户在后台设置中的连接器页面配置一次凭证，所有兼容的插件就会自动共享。这意味着插件开发者不需要在自己的设置页面中要求用户再次输入 API Key。

如果插件需要支持用户选择不同的 AI 提供商，可以在插件的设置页面中调用连接器 API 获取可用的提供商列表，让用户选择。

Abilities API 的注册与调用

Abilities API 定义了 AI 代理可以执行的具体操作。每个能力包括名称、输入参数定义、权限检查和执行逻辑。

插件可以注册新的能力，让 AI 代理能够操作插件的数据。例如，一个电商插件可以注册创建产品、更新库存、查询订单等能力。

注册能力需要声明能力名称、描述、参数模式、所需的权限级别以及执行回调函数。执行回调函数接收参数，执行具体操作，并返回结果。

MCP 适配器的使用场景

MCP 适配器让 AI 编码助手能够直接与 WordPress 交互。对于插件开发者来说，MCP 适配器提供了一种新的测试和调试方式，可以用自然语言指令来操作插件的数据。

从旧方式迁移到新架构

如果你的插件之前自己管理 AI 集成，迁移到新架构的步骤是：

  1. 移除自己管理的 API Key 存储逻辑

  2. 移除自己编写的 HTTP 请求代码

  3. 改用 AI 客户端发送请求

  4. 如果插件提供了 AI 代理功能，注册对应的能力

  5. 测试确保所有功能正常工作

迁移的好处是代码量大幅减少，安全性和可维护性提升。

实际开发示例

创建一个使用 AI 客户端的简单插件，核心逻辑是调用 AI 客户端发送提示词并处理响应。插件只需要专注于提示词的构建和响应结果的利用，其他所有事情都交给核心处理。

对于需要用户选择 AI 提供商的插件，可以通过连接器 API 获取可用列表，并在插件的设置页面中让用户选择。

开发注意事项

在使用 AI 客户端时，需要考虑提示词的构建质量，这直接影响 AI 输出的质量。对于长时间运行的任务，考虑使用异步处理。对于敏感数据，评估是否需要通过 AI 服务处理。

测试与调试

AI 客户端的调试可以通过 WordPress 的调试日志查看请求和响应。连接器 API 提供了测试连接功能，用户可以在配置后验证凭证是否有效。