WordPress 7.0 內建 AI Client：外掛開發者的統一 AI 介面指南

WordPress 7.0 引入了一個內建的 AI Client——一個與提供商無關的 PHP³ API，讓外掛可以將 prompt 傳送給 AI 模型並透過統一介面接收結果。外掛只需描述自己需要什麼，WordPress 負責將請求路由到網站管理員配置的 AI 提供商。

這意味著外掛開發者不再需要自己整合 OpenAI、Anthropic 或 Google 的 API。你只需要呼叫 WordPress 提供的標準介面，站點管理員在後臺的 Settings > Connectors 頁面配置好 API 金鑰和偏好模型即可。

基本用法

所有互動都從一個入口函式開始：

$text = wp_ai_client_prompt( '總結 WordPress 快取的好處。' )
    ->using_temperature( 0.7 )
    ->generate_text();

API 採用流暢的鏈式呼叫風格。你可以設定溫度引數、指定輸出格式、傳遞 JSON² schema 來獲取結構化資料。如果需要更豐富的後設資料（比如 token 用量、提供商資訊），可以使用 generate_text_result()、generate_image_result() 等方法，它們返回一個 GenerativeAiResult 物件，包含 token 用量、提供商和模型的詳細資訊。

支援的生成型別

AI Client 不限於文字生成。它原生支援多種模態：文字生成（generate_text）、圖片生成（generate_image）、文字轉語音（convert_text_to_speech）、語音生成（generate_speech）以及影片生成（generate_video）。每種模態都有對應的 generate_*_result() 方法返回帶後設資料的完整結果。

值得注意的是，GenerativeAiResult 物件是可序列化的，可以直接傳遞給 rest_ensure_response()，這意味著你可以輕鬆地透過 REST API¹ 暴露 AI 功能。

模型偏好與提供商配置

每個站點可用的模型取決於管理員在 Connectors 頁面配置了哪些 AI 提供商。外掛可以透過模型偏好來表達自己的需求：指定功能需求（如”需要支援文字生成”）、設定上下文視窗大小、或者建議特定的模型類別。WordPress 會根據這些偏好自動選擇最合適的提供商和模型。

對中文開發者意味著什麼

這是 WordPress Core 第一次提供標準化的 AI 能力介面。對中文外掛開發者來說，這意味著幾件事：

第一，降低門檻。不需要深入研究各個 AI 提供商的 API 差異，一套程式碼就能適配所有提供商。

第二，使用者自主權。終端使用者可以選擇自己信任的 AI 提供商，而不是被外掛鎖定在某一個服務上。對於關注資料主權的中國使用者來說，這一點尤為重要。

第三，生態統一。當所有外掛都透過同一個 AI Client 介面工作時，使用者體驗會更一致，API 金鑰管理也更簡單。

原文作者 Felix Arntz 是 WordPress Core 的關鍵貢獻者，文章中包含大量程式碼示例。如果你是外掛開發者，建議閱讀原文獲取完整的技術細節。

名詞解釋

1. REST API：基於 HTTP 協議的應用程式介面，用於系統間資料互動 ↩︎
2. JSON：一種輕量級的資料交換格式 ↩︎
3. PHP：WordPress 核心使用的服務端程式語言 ↩︎