# PHP AI Client – WordPress AI 能力官方介绍说明 *Published:* 2025-09-04 *Author:* 小雨 这是 **WordPress AI 构建区块** 计划的一部分。主要项目包括 PHP[6](#9ecab8ba) AI Client SDK、Abilities API、MCP[5](#5c266d40) Adapter 和 AI 实验插件。 介绍 -- PHP AI Client SDK（[GitHub[3](#8c9c1c59)](https://github.com/WordPress/php-ai-client)）提供了共享基础设施，让 WordPress 插件和其他 PHP 项目能够快速灵活地集成 AI 功能。类似于 [Vercel AI SDK](https://github.com/vercel/ai) 等项目，它提供了一个统一的接口，适用于所有 AI 提供商——从简单的文本生成到复杂的多模态操作、流式响应和长时间运行的任务。 开发者指定他们需要什么 AI 功能，用户在一个地方管理他们的提供商凭据。这些凭据随后自动在他们站点上所有兼容的插件中工作。 了解更多 [WordPress AI](https://wptea.com/tag/wordpress-ai) 信息扩展阅读： - [即将进入新品密集发布期，WordPress AI 专栏也要来了。](https://wptea.com/wordpress-ai-project-website-is-coming/) - [最近一直在给 WordPress 网站深度集成 AI …](https://wptea.com/wordpress-website-deep-integration-ai/) - [AI 实验插件 – WordPress AI 功能官方介绍说明](https://wptea.com/ai-experiments-wordpress-ai/) - [PHP AI Client – WordPress AI 能力官方介绍说明](https://wptea.com/php-ai-client-wordpress-ai/) - [Abilities API – WordPress AI 能力官方介绍说明](https://wptea.com/abilities-api-wordpress-ai/) - [MCP Adapter – WordPress AI 适配器官方介绍说明](https://wptea.com/mcp-adapter-wordpress-ai/) - [WordPress AI Building Blocks 构建区块计划方案官方说明](https://wptea.com/wordpress-ai-building-blocks-plan/) 该 SDK 既解决了用户需求，也解决了开发者需求： - 提供商无关的方法**将用户放在首位**。WordPress 网站管理员选择他们想要配置和使用的提供商和/或模型，并且他们可以在一个地方提供 API 凭据。任何具有 AI 功能的插件都能正常工作。不再有供应商锁定。 - 开发者可以**专注于构建 AI 功能，而不是 AI 基础设施**。而不是试图为单个提供商寻找非官方 SDK 或甚至自己构建，SDK 为开发者提供了中央基础设施，可以快速开始并专注于用户收益，而不是他们自己插件的技术管道。不再重新发明轮子。 工作原理 ---- API 适应不同的开发者需求。一些插件解决方案可能需要特定模型，而其他插件只需要任何文本完成功能。PHP AI Client SDK 在幕后处理所有复杂性。不同的身份验证方法、API 格式、流式协议和提供商怪癖都通过相同的清洁接口工作。 这是一个使用特定模型生成文本的简单临时代码示例： ``` $text = AiClient::prompt('写一首关于 PHP 的两节诗') ->usingModel(Google::model('gemini-2.5-flash')) ->generateText(); ``` 相同的例子，但以模型和提供商无关的方式编写： ``` $text = AiClient::prompt('写一首关于 PHP 的两节诗') ->generateText(); ``` 解决的问题 ----- 今天，每个具有 AI 功能的 WordPress 插件都重建相同的基础设施：提供商集成、API 密钥管理、响应标准化、错误处理。用户多次输入相同的凭据并处理不一致的体验。当提供商更改他们的 API 时，每个插件都会单独中断。 值得注意的是，这些问题不仅存在于 WordPress 中，而且几乎存在于每个试图以提供商无关方式使用 AI 的 PHP 项目中。迄今为止存在的真正提供商无关的 SDK 只适用于其他技术栈，这些技术栈与通用 PHP 项目不兼容——要么是不同的服务器端语言（例如 NodeJS 的 Vercel AI SDK），要么是特定平台（Drupal 的 AI 模块）。 PHP AI Client SDK 为 PHP 生态系统，特别是 WordPress 集中了这种复杂性。一个集成点处理所有提供商。一个凭据系统服务所有插件。当提供商更新或新的提供商出现时，更改只发生一次并使每个人受益。该架构考虑了多模态优先等最新趋势，甚至预见到了客户端或基于浏览器的 AI 等未来转变。 共同构建 ---- PHP AI Client SDK 在技术上由两个 Composer[1](#7eb4e4b6) 包组成： - 底层的 PHP 包提供统一的 AI 接口，它与 WordPress 无关。这是与更广泛的 PHP 社区的协作努力。 - 这由另一个 WordPress 特定的包补充，该包添加了技术上与 WordPress 相关的功能，例如 AI API 凭据的共享设置页面、与 [Abilities API](https://make.wordpress.org/ai/2025/07/17/abilities-api) 的连接，以及在 JavaScript 中使用 AI 功能的 REST API[2](#eb0512d8) 端点。 这种模块化方法意味着当任何社区添加提供商或改进性能时，每个人都受益，同时每个平台保持其独特的体验。 对于 WordPress 开发者来说，这种架构提供了灵活性。使用 WordPress 包获得具有管理 UI[7](#956d86bc) 的完整体验，或使用底层 PHP 包进行较低级别的项目，如 WP-CLI[4](#d86b6006) 集成。虽然也可作为插件用于测试，但这些 Composer 包是官方采用路径——今天引入它们，发布具有 AI 功能的插件，如果这些成为 WordPress 核心的一部分，则无缝过渡。多个插件可以使用相同的包而不会冲突，由 Composer 处理依赖关系。 前进发展 ---- 随着 AI 变得对 WordPress 必不可少，这个 SDK 提供了可持续的基础。它被设计为与新兴能力一起成长——新的模态、高级功能、新颖的部署模型。现在的重点是扩展提供商支持并根据实际使用情况完善开发者体验。 请在 Slack 的 #core-ai 中加入讨论，或探索[实现](https://github.com/WordPress/php-ai-client)。 --- *相关标签：* [\#ai-building-blocks](https://make.wordpress.org/ai/tag/ai-building-blocks/) ### 名词解释 1. Composer：PHP 的依赖管理工具 [↩︎](#7eb4e4b6-link) 2. REST API：基于 HTTP 的应用程序接口 [↩︎](#eb0512d8-link) 3. GitHub：全球最大的代码托管和协作开发平台 [↩︎](#8c9c1c59-link) 4. WP-CLI：WordPress 的命令行管理工具 [↩︎](#d86b6006-link) 5. MCP：AI 模型与外部工具交互的协议 [↩︎](#5c266d40-link) 6. PHP：WordPress 核心使用的服务端编程语言 [↩︎](#9ecab8ba-link) 7. UI：用户界面，用户与软件交互的视觉部分 [↩︎](#956d86bc-link)