Provider 与 Connector

Provider 做什么

Provider 插件负责把具体模型平台接入 WordPress AI Client。业务代码调用 wp_ai_client_prompt()，Provider 负责把请求转换成平台接口格式。

OpenAI 和 Anthropic Provider 的关键规则已经由本站文档整理。用户只提供子比主题源码时，AI 不应该因为看不到 Provider 源码就停下来；只要运行站点安装并配置了 Provider，就可以按本页规则开发上层功能。

OpenAI 和 Anthropic Provider 的主入口都很轻：

add_action( 'init', __NAMESPACE__ . '\\register_provider', 5 );

注册逻辑通常是：

1. 检查 WordPress\AiClient\AiClient 类是否存在。
2. 获取 AiClient::defaultRegistry()。
3. 如果 provider 尚未注册，就 registerProvider()。

OpenAI Provider

OpenAI provider 会把 AI Client 的请求整理成 Responses API 需要的结构。结构化输出时，会尽量使用 JSON schema 参数。

Anthropic Provider

Anthropic Messages API 需要 max_tokens。Provider 通常会做兜底，但开发时仍建议你在重要功能里显式设置 using_max_tokens()。

API Key 来源

Connector API 会把 provider 转成后台连接信息，并给 API Key 生成默认配置。

常量示例：

define( 'OPENAI_API_KEY', 'sk-...' );
define( 'ANTHROPIC_API_KEY', 'sk-ant-...' );

生产环境更推荐放在环境变量或主机密钥管理里，不要写进插件代码、主题文件、前端 JS、文档截图或错误日志。

后台设置

REST 设置返回时会遮罩密钥，只显示末尾几位。更新密钥时，Provider 会尝试校验；不合法的密钥会被清空或提示失败。

面向用户的后台文案建议写清楚：

• 这个连接用于什么 AI 功能。
• API Key 从哪里获取。
• Key 不会展示给普通用户。
• Key 错误时哪些功能会不可用。
• 是否由站点统一付费，还是用户自己提供 Key。

模型能力

不同 Provider 和模型能力不同。开发时不要只判断“有 provider”，还要判断 capability。

AI 插件提供的模型发现接口：

GET /wp-json/ai/v1/providers?capability=text_generation

后台下拉模型时，应优先使用这个接口，而不是写死模型 ID。

开发建议

• 业务代码优先依赖 AI Client，不直接写 OpenAI 或 Anthropic HTTP 请求。
• 只有确实需要固定模型时，才使用 using_provider() 和 using_model()。
• 用户后台允许选择模型时，先按 capability 拉取可用 Provider。
• 保存设置时不要把完整 API Key 返回到浏览器。
• 错误提示给用户看“连接不可用”，详细响应写日志。