WordPressのAbilities APIとは？

WordPressのAbilities APIは、プラグインがAIツールに対して自身ができることを伝えるための標準的な方法です。WordPress 6.9に搭載されました。私はこれをWP Mail SMTPに接続し、AIにメールログを読むように依頼しました。AIは数秒で回答しました。

これまでは、外部ツールがあなたのサイトができることを知るための共通の方法がありませんでした。各プラグインは独自の言語で話していました。AIエージェントは推測するか、カスタムコードを書く必要がありました。

このガイドでは、Abilitiesとは何か、そしてそれがAIツールにどのように適用されるかを学びます。また、WP Mail SMTPとWPFormsがAIに何を読ませることができるかを正確に確認します。

これのほとんどはコード不要です。最後に開発者向けのセクションもあります。

WordPressのAbilities APIとは？

WordPressのAbilities APIは、プラグイン、テーマ、WordPressコアが自身ができることを宣言するための中心的なレジストリです。宣言された各機能は「Ability」と呼ばれます。

Abilityは、明確な1つの機能単位です。「最後の10件のメールを読む」や「今月の送信統計を取得する」と考えてください。各Abilityには4つの部分があります：

• 入力: 実行に必要なデータ
• 出力: 返されるデータ
• 実行: 実行されるアクション
• 権限: 誰がそれを実行できるかのチェック

このレジストリは機械可読であり、人間可読でもあります。そのため、AIエージェント、他のプラグイン、または開発者はそれを調べて理解することができます。WordPressはすべてのAbilityを1つの場所、WP_Abilities_Registryと呼ばれる場所に保存します。

Abilities APIはどのように機能しますか？

Abilities APIは、すべてのAbilityを1つのレジストリに保持することで機能し、どのツールでもクエリできます。プラグインはWordPressの起動時にAbilityを登録します。それぞれが独自のルールを持っています。

これらのルールは3つのジョブを実行します：

• JSONスキーマは、実行前にデータの入力と出力の型をチェックします。
• 権限コールバックは、ユーザーまたはツールがAbilityを実行する権限があることを確認します。
• メタデータフラグは、Abilityを読み取り専用、破壊的、または冪等としてマークし、ツールがその結果を認識できるようにします。

また、show_in_restフラグもあります。これにより、開発者がオプトインした場合、AbilityはWordPress REST APIに表示されます。これにより、公開は意図的になり、自動的ではなくなります。

AbilityはAIエージェント（MCPアダプター）にどのように接続されますか？

Abilityは、WordPress MCP Adapterを介してAIエージェントが利用できます。MCPはModel Context Protocolの略です。これは、AIツールが外部システムと通信するために使用する共通言語です。

MCPアダプターは、AIツールがこれらのAbilityにアクセスできるようにします。登録されたAbilityを読み取り、MCPのパーツに変換します：

• ツール: アクションを実行するAbility
• リソース：データを読み取って返す機能
• プロンプト：一般的なタスクのための既製のテンプレート

ライブサイトの場合はHTTP経由で、ローカル開発の場合はSTDIO経由で動作します。サインインにはWordPressアプリケーションパスワードを使用します。有効になると、Claude、ChatGPT、Cursor、VS CodeなどのMCPツールが機能を検出して使用できるようになります。

Abilities APIが重要なのはなぜですか？

Abilities APIは、AIがサイトに確実にアクセスできる方法を提供するため重要です。以前は標準がありませんでした。ツールはRESTルートをスキャンしたり、プラグインコードを読み取ったりして、何が可能かを推測する必要がありました。

今やその成果はシンプルです：

• 検出のための1つのレジストリ：ツールはすべての機能を1か所で見つけます。
• デフォルトで読み取り専用：ほとんどの機能はデータを読み取るだけなので、公開しても安全です。
• カスタムグルーは不要：プラグインがかつて必要としていた個別の統合をスキップできます。
• 一貫した安全性：すべての機能は同じ権限モデル内で実行されます。

サイトオーナーにとっては、AIにサイトに関する実際の質問をできるようになることを意味します。開発者にとっては、個別のSDKなしでプラグインがAIサポートを受けられることを意味します。

WordPressメールを今すぐ修正する

WP Mail SMTPはAbilities APIで何ができますか？

WP Mail SMTPはAbilities APIを使用して、AIツールがメールデータを読み取り専用で読み取れるようにします。接続されたアシスタントがメールアクティビティを確認し、質問に答えます。メールの送信、データの削除、設定の変更は一切行いません。

公開される機能は次のとおりです：

• ログに記録されたメールの閲覧とフィルタリング：ステータス、メーラー、日付、受信者別
• 個々のメールの詳細とコンテンツの取得：詳しく確認したい場合
• 送信統計情報の読み取り：レポートから
• デバッグイベントの確認：配信の問題の特定に役立ちます

これらの機能は、WP Mail SMTP Proの一部であるメールログとレポートから読み取ります。サイトにはWordPress 6.9以降、およびWP Mail SMTP 4.9以降が必要です。

接続すると、「今日のパスワードリセットメールは送信されましたか？」のような質問ができるようになります。実際に動作している様子を確認するには、AIでWordPressメールを監視する方法ガイドをお読みください。

WPFormsはどのようなAbilitiesを公開しますか？

WPFormsは、フォームエントリの読み取りおよび書き込み機能を公開します。AIアシスタントはフォームを作成したり、送信内容を読み取ったり、要約したり、それらに関する質問に答えたりできます。

これにより、迅速で役立つ質問が可能になります：

• 「今週、いくつエントリーがありましたか？」
• 「アンケートフォームからのフィードバックを要約してください。」
• 「どのフォームが最も多くの送信を受け取っていますか？」

WPFormsのルールはかなり異なります。オプションで書き込みアクセスを有効にすると、アシスタントがサイトでフォームを作成および管理できるようになります。作成したいフォームの種類を指定するプロンプトを与えるだけで、自動的に作成されます。

WP Mail SMTPでAbilities APIを使用する方法

AIアシスタントでWP Mail SMTPを使用するには、まずプラグインをバージョン4.9以降に更新する必要があります。次に、AIツールを接続します。WP Mail SMTPの手順は次のとおりです。

1. WordPress 6.9以降に更新します。
2. WP Mail SMTP 4.9以降に更新します。
3. WP Mail SMTP » ツールに移動し、AI MCPタブを開きます。
4. WPVibe をインストールして有効化し、AIアシスタントを接続してください。

これは簡単な説明です。スクリーンショット付きの完全な手順については、WP Mail SMTP を AI アシスタントに接続する方法のガイドに従ってください。

開発者はどのようにAbilityを登録しますか？

開発者は wp_register_ability() 関数を使用してアビリティを登録します。これは wp_abilities_api_init アクションにフックされた関数内で呼び出されます。簡単な例を以下に示します。

add_action( 'wp_abilities_api_init', 'myplugin_register_abilities' );

function myplugin_register_abilities() {
    wp_register_ability(
        'myplugin/get-recent-orders',
        array(
            'label'               => __( 'Get recent orders', 'myplugin' ),
            'description'         => __( 'Returns the 10 most recent orders.', 'myplugin' ),
            'category'            => 'myplugin',
            'input_schema'        => array(
                'type'       => 'object',
                'properties' => array(
                    'limit' => array( 'type' => 'integer' ),
                ),
            ),
            'output_schema'       => array( 'type' => 'array' ),
            'execute_callback'    => 'myplugin_get_recent_orders',
            'permission_callback' => function () {
                return current_user_can( 'manage_options' );
            },
        )
    );
}

wp_register_ability() はどのように見えますか？

この関数は、一意の名前と設定の配列の 2 つの引数を取ります。名前は ベンダー/アビリティ の形式を使用します。例: myplugin/get-recent-orders。設定配列が残りを定義します。

• label および description: アビリティの人間に読みやすい名前
• category: アビリティが属するグループ
• input_schema および output_schema: 入出力データの JSON スキーマ
• execute_callback: 処理を実行する関数
• permission_callback: アクセスを許可または拒否する関数

パーミッションコールバックはどのようにアビリティを安全に保ちますか？

パーミッションコールバックは、誰がアビリティを実行できるかを決定します。適切なユーザーのみが通過できるように、current_user_can() チェックを返す必要があります。上記の例では、アビリティを管理者に制限しています。

さらに 3 つのレイヤーがそれをサポートします。JSON スキーマは不正なタイプの入力を拒否します。メタデータフラグは、アビリティがデータを変更したときにツールに警告します。そして show_in_rest は、REST の公開を自動ではなくオプトインに保ちます。

次に、サイトを ChatGPT に接続する

これで、WordPress アビリティ API が何であるか、AI ツールにどのように到達するか、そしてプラグインがそれを介して何を公開するかを知ることができます。

次のステップは、それを使用することです。私のガイド「WordPress サイトを ChatGPT に接続する方法」では、コード不要で手順を説明しています。WP Mail SMTP の最新バージョンに更新し、WPVibe のようなコネクタを使用してサイトを接続したら、アシスタントにメールログについて平易な英語で質問できます。

WordPressメールを今すぐ修正する

フォームの作成準備はできましたか？最も簡単なWordPressフォームビルダープラグインで、今日から始めましょう。 WPForms Pro には、多くの無料テンプレートが含まれており、14日間の返金保証が付いています。

この記事がお役に立った場合は、より多くの無料WordPressチュートリアルやガイドを入手するために、 Facebook および Twitter でフォローしてください。