PHP AI Client – WordPress AI 能力官方介紹說明

這是 WordPress AI 構建區塊 計劃的一部分。主要專案包括 PHP AI Client SDK 、 Abilities API 、 MCP Adapter 和 AI 實驗外掛。

介紹

PHP AI Client SDK（GitHub）提供了共享基礎設施，讓 WordPress 外掛和其他 PHP 專案能夠快速靈活地整合 AI 功能。類似於 Vercel AI SDK 等專案，它提供了一個統一的介面，適用於所有 AI 提供商——從簡單的文字生成到複雜的多模態操作、流式響應和長時間執行的任務。

開發者指定他們需要什麼 AI 功能，使用者在一個地方管理他們的提供商憑據。這些憑據隨後自動在他們站點上所有相容的外掛中工作。

瞭解更多 WordPress AI 資訊擴充套件閱讀：

該 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 包組成：

底層的 PHP 包提供統一的 AI 介面，它與 WordPress 無關。這是與更廣泛的 PHP 社群的協作努力。
這由另一個 WordPress 特定的包補充，該包新增了技術上與 WordPress 相關的功能，例如 AI API 憑據的共享設定頁面、與 Abilities API 的連線，以及在 JavaScript 中使用 AI 功能的 REST API 端點。

這種模組化方法意味著當任何社群新增提供商或改進效能時，每個人都受益，同時每個平臺保持其獨特的體驗。

對於 WordPress 開發者來說，這種架構提供了靈活性。使用 WordPress 包獲得具有管理 UI 的完整體驗，或使用底層 PHP 包進行較低階別的專案，如 WP-CLI 整合。雖然也可作為外掛用於測試，但這些 Composer 包是官方採用路徑——今天引入它們，釋出具有 AI 功能的外掛，如果這些成為 WordPress 核心的一部分，則無縫過渡。多個外掛可以使用相同的包而不會衝突，由 Composer 處理依賴關係。