WordPress 7.0搭載のAI Client完全ガイド：標準APIの活用法

WordPress 7.0のリリースにより、プラグインごとにバラバラだったAI実装に終止符が打たれます。標準搭載される AI Client と Connectors API は、開発者が独自のSDKを導入することなく、共通のインターフェースで LLM（大規模言語モデル） を呼び出すことを可能にします。APIキーの一元管理やプロバイダーの柔軟な切り替えなど、開発効率とセキュリティを劇的に向上させる新機能の全貌を解説します。

概要と技術的背景

WordPress 7.0（2026年4月9日リリース予定）では、コア機能として AI Client（開発者向けAPI）と Connectors API（認証基盤）が導入されます。これまで、AI機能を実装するには OpenAI や Anthropic などのSDKを個別に組み込む必要があり、APIキーの重複管理やセキュリティリスクが課題となっていました。

Connectors API は、AIに限らず決済やメール配信など外部サービスとの接続を標準化する汎用基盤として設計されています。その最初のユースケースとして AI Client が実装され、サイトオーナーは「設定 > Connectors」画面から一度設定するだけで、複数のプラグインから共通のAI基盤を利用できるようになります。

アーキテクチャの3層構造

内部では wordpress/php-ai-client パッケージが抽象化層を担っています。

レイヤー	役割
Settings UI	Connectors画面でのAPIキー一元管理
Abstraction Layer	php-ai-client SDKによる統一API（wp_ai_client_prompt）
Provider Plugins	OpenAI / Anthropic / Google 等の公式プロバイダー

主要メソッド一覧

ビルダーパターンを採用しており、メソッドチェーンで直感的にパラメータを組み立てられます。

メソッド	用途
generate_text()	テキスト生成を実行
generate_image()	画像生成を実行
using_system_instruction($text)	AIの振る舞い（システムプロンプト）を定義
using_temperature($value)	出力のランダム性を制御（0.0〜1.0）
using_model_preference(...$models)	優先するモデル候補を指定
using_max_tokens($count)	消費トークンの上限を設定
as_json_response($schema)	JSON Schemaに基づき構造化データを出力

実装・利用例

以下は、投稿保存時にAIを用いて「記事の抜粋」を自動生成する、実戦的なコード例です。

add_action( 'save_post', 'my_ai_auto_excerpt', 10, 2 );

function my_ai_auto_excerpt( $post_id, $post ) {
    // 互換性チェックと既存抜粋の有無を確認
    if ( ! function_exists( 'wp_ai_client_prompt' ) || ! empty( $post->post_excerpt ) ) {
        return;
    }

    $content = wp_strip_all_tags( $post->post_content );
    if ( empty( $content ) ) return;

    // 出力形式をJSON Schemaで定義
    $schema = [
        'type' => 'object',
        'properties' => [
            'excerpt' => [ 'type', 'string', 'description' => '1〜2文の日本語要約' ]
        ],
        'required' => [ 'excerpt' ]
    ];

    // AI Clientによる実行
    $json = wp_ai_client_prompt( "以下の内容を要約してください:\n\n" . $content )
        ->using_system_instruction( 'あなたはWordPress専門の編集者です。' )
        ->using_temperature( 0.3 )
        ->using_max_tokens( 200 )
        ->as_json_response( $schema )
        ->generate_text();

    // WP_Errorによるエラーハンドリング
    if ( is_wp_error( $json ) ) {
        error_log( 'AI Error: ' . $json->get_error_message() );
        return;
    }

    $result = json_decode( $json, true );
    if ( isset( $result['excerpt'] ) ) {
        wp_update_post( [
            'ID'           => $post_id,
            'post_excerpt' => sanitize_text_field( $result['excerpt'] ),
        ] );
    }
}

ベストプラクティスと制限事項

パフォーマンスとコストの管理

• 非同期処理: LLMの応答には数秒かかるため、save_post 等で直接呼ぶのではなく、wp_schedule_single_event() を用いて wp_cron 経由で実行することが推奨されます。
• キャッシュ: Transients API を活用し、同一プロンプトに対する応答をキャッシュすることで、APIコストを削減できます。
• APIキーの保護: 本番環境では wp-config.php で定数としてAPIキーを定義することが推奨されます。

現時点での制限事項

• ストリーミング非対応: 逐次表示（チャットUI等）には現在のところ対応していません。
• Function Calling: 外部ツールをAIに実行させる仕組みはスコープ外です。
• ステートレス: 標準の wp_ai_client_prompt() は単発のリクエストを想定しており、会話履歴の保持はプラグイン側で行う必要があります。

既存実装からの移行例

独自のSDK（OpenAI PHP SDK等）を利用していた場合、以下のように簡略化されます。

Before (独自実装):

$client = OpenAI::client($api_key);
$response = $client->chat()->create([
    'model' => 'gpt-4',
    'messages' => [['role' => 'user', 'content' => $prompt]]
]);
return $response->choices[0]->message->content;

After (WordPress 7.0):

return wp_ai_client_prompt($prompt)->generate_text();
// APIキー管理、クライアント初期化、エラーハンドリング（WP_Error）が標準化される

開発環境でのテスト手順

正式リリース前にRC版で検証する場合は、以下の手順で行います。

1. 1. RC版のインストール

wp core update --version=7.0-RC3 --force

2. 2. プロバイダープラグインのインストール

wp plugin install wordpress-openai-provider --activate

3. 3. APIキーの設定（CLI例）

wp option update connectors_openai_api_key "sk-..."

まとめ

• 標準APIの確立: wp_ai_client_prompt() により、プロバイダーを問わない統一的な実装が可能になった。
• 管理の集約: Connectors API により、サイト全体で1つのAPIキーを安全に共有・管理できる。
• エコシステムの進化: 開発者はインフラの実装から解放され、AIを活用した独自のビジネスロジックに集中できる。