هوش مصنوعی در هسته وردپرس: WP AI Client

هوش مصنوعی وردپرس از نسخه ۷.۰ (۲۰ مه ۲۰۲۶) یک زیرساخت رسمی در هسته دارد: WP AI Client، یک API در PHP که به افزونه‌ها اجازه می‌دهد با یک رابط واحد به مدل‌های هوش مصنوعی پرامپت بفرستند و پاسخ بگیرند، بدون اینکه به ارائه‌دهنده خاصی وابسته باشند. خود هسته هیچ ارائه‌دهنده‌ای را همراه ندارد و تا وقتی مدیر سایت سرویسی را وصل نکند، هیچ درخواستی به مدل‌ها ارسال نمی‌شود.

نویسنده: تیم siloow (سیلو سولوشن) — آخرین به‌روزرسانی: آبان ۱۴۰۵

وضعیت تا آبان ۱۴۰۵: AI Client و Connectors API در وردپرس ۷.۰ «Armstrong» (۲۰ مه ۲۰۲۶) وارد هسته شدند. ارائه‌دهنده‌ها به‌صورت افزونه جدا عرضه می‌شوند؛ سه افزونه رسمی برای Anthropic، Google و OpenAI وجود دارد. کلیدهای API ذخیره‌شده در دیتابیس طبق اعلام تیم هسته رمزنگاری نمی‌شوند و فقط در رابط کاربری پوشانده می‌شوند.

در این مقاله توضیح می‌دهیم WP AI Client دقیقاً چیست، صفحه Connectors چه کاری می‌کند، یک افزونه چطور از آن استفاده می‌کند و مهم‌تر از همه، این قابلیت برای مدیران سایت چه فرصت‌ها و چه ریسک‌هایی در حریم خصوصی و امنیت دارد.

هوش مصنوعی وردپرس (WP AI Client) چیست؟

WP AI Client یک API مستقل از ارائه‌دهنده در هسته وردپرس است که افزونه‌ها از طریق آن متن، تصویر، صدا یا ویدیو را از مدل‌های هوش مصنوعی درخواست می‌کنند. طبق معرفی رسمی AI Client در وردپرس ۷.۰، این API دو لایه دارد:

• PHP AI Client: یک SDK مستقل (wordpress/php-ai-client) که ارتباط با ارائه‌دهنده، انتخاب مدل و یکسان‌سازی پاسخ‌ها را انجام می‌دهد.
• لایه وردپرسی: کلاس WP_AI_Client_Prompt_Builder که قراردادهای وردپرس مثل بازگرداندن WP_Error، استفاده از HTTP API وردپرس، هوک‌ها و اتصال به Abilities API و Connectors را اضافه می‌کند.

نقطه شروع برای توسعه‌دهنده تابع wp_ai_client_prompt() است. پیش از این، هر افزونه هوش مصنوعی باید کلاینت اختصاصی خودش را برای هر سرویس می‌نوشت و مدیر سایت برای هر افزونه کلید جداگانه وارد می‌کرد؛ حالا یک لایه مشترک وجود دارد.

بخش	کار اصلی	چه کسی با آن کار می‌کند
AI Client	ارسال پرامپت و دریافت پاسخ با رابط واحد	توسعه‌دهنده افزونه
Connectors (تنظیمات › Connectors)	اتصال به ارائه‌دهنده و مدیریت کلید API	مدیر سایت
افزونه ارائه‌دهنده	پیاده‌سازی ارتباط با یک سرویس مشخص	نصب توسط مدیر سایت
Abilities API	تعریف قابلیت‌های سایت به شکل قابل استفاده برای ابزارها و اتوماسیون	توسعه‌دهنده

صفحه Connectors و افزونه‌های ارائه‌دهنده چطور کار می‌کنند؟

صفحه Connectors در مسیر «تنظیمات › Connectors» جایی است که مدیر سایت سرویس‌های خارجی، از جمله ارائه‌دهنده‌های هوش مصنوعی، را وصل می‌کند و کلید API را وارد می‌کند. اطلاعیه رسمی وردپرس ۷.۰ می‌گوید این صفحه سه گزینه پیش‌فرض دارد و امکان افزودن اتصال‌های دیگر هم وجود دارد.

طبق معرفی Connectors API، وردپرس کلید هر ارائه‌دهنده را به این ترتیب جستجو می‌کند:

1. متغیر محیطی سرور با الگوی {PROVIDER_ID}_API_KEY، مثلاً ANTHROPIC_API_KEY.
2. ثابت PHP با همان نام در wp-config.php.
3. تنظیم ذخیره‌شده در دیتابیس که از صفحه Connectors وارد شده است.

ارائه‌دهنده‌ها در هسته نیستند و به‌صورت افزونه نگهداری می‌شوند. سه افزونه رسمی AI Provider for Anthropic، AI Provider for Google و AI Provider for OpenAI هستند و هر کسی می‌تواند افزونه ارائه‌دهنده دیگری بسازد که در رجیستری PHP AI Client ثبت شود. این یعنی از نظر فنی امکان اتصال به مدل‌های دیگر، از جمله مدلی که روی سرور خودتان اجرا می‌شود، با یک افزونه ارائه‌دهنده مناسب وجود دارد.

توسعه‌دهنده افزونه هوش مصنوعی چطور از AI Client استفاده می‌کند؟

توسعه‌دهنده افزونه هوش مصنوعی با wp_ai_client_prompt() یک سازنده پرامپت می‌گیرد، تنظیمات را با متدهای زنجیره‌ای اضافه می‌کند و در پایان یکی از متدهای generate_* را صدا می‌زند. افزونه هرگز کلید API را نمی‌بیند یا مدیریت نمی‌کند؛ فقط نیازش را توصیف می‌کند.

<?php
// پیشنهاد خلاصه برای یک نوشته با AI Client وردپرس ۷.۰+
function siloow_suggest_excerpt( $post_id ) {
    $content = wp_strip_all_tags( get_post_field( 'post_content', $post_id ) );

    $builder = wp_ai_client_prompt( 'یک خلاصه دو جمله‌ای فارسی بنویس:' )
        ->with_text( $content )
        ->using_max_tokens( 200 );

    // اگر هیچ ارائه‌دهنده‌ای تنظیم نشده، رابط AI را نشان نده
    if ( ! $builder->is_supported_for_text_generation() ) {
        return new WP_Error( 'no_ai', 'سرویس هوش مصنوعی تنظیم نشده است.' );
    }

    $text = $builder->generate_text();
    if ( is_wp_error( $text ) ) {
        return $text;
    }
    return sanitize_textarea_field( $text );
}

چند متد مهم این API:

• generate_text()، generate_image() و generate_speech_result() برای تولید متن، تصویر و صدا.
• using_system_instruction()، using_temperature() و using_max_tokens() برای تنظیم رفتار مدل.
• using_model_preference() برای اعلام فهرست مدل‌های ترجیحی؛ اگر هیچ‌کدام در دسترس نباشد، اولین مدل سازگار انتخاب می‌شود.
• is_supported_for_text_generation() و متدهای مشابه برای بررسی اینکه اصلاً سرویسی تنظیم شده یا نه؛ این متدها هیچ درخواست شبکه‌ای نمی‌فرستند.

تیم هسته صراحتاً توصیه کرده که افزونه‌ها فرض نکنند صرف نصب وردپرس ۷.۰ یعنی هوش مصنوعی در دسترس است؛ قبل از نمایش هر دکمه یا رابط AI باید با متدهای is_supported_* بررسی شود. اگر با مفهوم مدل‌ها و توکن آشنا نیستید، مقاله مدل زبانی بزرگ (LLM) چیست نقطه شروع خوبی است.

فرصت‌های هوش مصنوعی وردپرس برای صاحبان سایت چیست؟

بزرگ‌ترین فرصت هوش مصنوعی وردپرس این است که افزونه‌های مختلف می‌توانند از یک اتصال مشترک استفاده کنند و مدیر سایت ارائه‌دهنده را یک‌بار و در یک جا انتخاب می‌کند. کاربردهایی که با این زیرساخت ساده‌تر می‌شوند:

• کمک به تولید محتوا: پیشنهاد عنوان، خلاصه (excerpt) و ساختار نوشته که نویسنده بازبینی و ویرایش می‌کند. اطلاعیه ۷.۰ به افزونه جداگانه AI اشاره می‌کند که تولید و ویرایش تصویر، ساخت عنوان و خلاصه و پیشنهاد متن جایگزین تصویر را ارائه می‌دهد.
• دسترس‌پذیری: پیشنهاد متن alt برای تصاویر کتابخانه رسانه، که برای سایت‌های قدیمی با هزاران تصویر بدون alt ارزشمند است.
• اتوماسیون مدیریت: ترکیب AI Client با Abilities API تا ابزارهای هوشمند بتوانند کارهای تعریف‌شده سایت را انجام دهند؛ مفهومی نزدیک به ایجنت هوش مصنوعی.
• تعویض ارائه‌دهنده بدون بازنویسی: اگر قیمت یا کیفیت یک سرویس تغییر کند، مدیر سایت ارائه‌دهنده را عوض می‌کند و افزونه‌ها بدون تغییر کد کار می‌کنند.

ریسک‌های حریم خصوصی و امنیت WP AI Client کدام‌اند؟

مهم‌ترین ریسک هوش مصنوعی وردپرس این است که هر متنی که افزونه در پرامپت می‌گذارد، از سرور شما به سرور ارائه‌دهنده خارجی ارسال می‌شود. معرفی رسمی AI Client هیچ توضیحی درباره نوع داده ارسالی، نگهداری یا مدت ذخیره آن ندارد؛ این موضوع به سیاست ارائه‌دهنده انتخابی و رفتار هر افزونه بستگی دارد.

ریسک	توضیح	اقدام پیشنهادی
ارسال داده شخصی به سرویس خارجی	افزونه ممکن است متن نوشته، نظرات یا اطلاعات کاربران را در پرامپت بگذارد	بررسی رفتار افزونه، ارسال نکردن داده کاربران و به‌روزرسانی سیاست حریم خصوصی سایت
کلید API رمزنگاری‌نشده	کلید ذخیره‌شده در دیتابیس فقط در رابط پوشانده می‌شود و رمزنگاری نمی‌شود	نگهداری کلید در متغیر محیطی یا ثابت wp-config و تعیین سقف هزینه در پنل ارائه‌دهنده
دسترسی همه افزونه‌ها به کلید	کلید یک تنظیم سایت است و هر افزونه نصب‌شده می‌تواند آن را بخواند	نصب نکردن افزونه نال یا ناشناس و بازبینی افزونه‌ها
مصرف پیش‌بینی‌نشده و هزینه	هر فراخوانی generate هزینه توکن دارد	محدود کردن نقش‌های مجاز با فیلتر و پایش مصرف
خروجی نادرست یا ناامن	مدل ممکن است اطلاعات غلط یا HTML ناخواسته تولید کند	بازبینی انسانی و پاک‌سازی خروجی با توابع escape وردپرس

برای محدود کردن ارسال پرامپت، وردپرس فیلتر wp_ai_client_prevent_prompt را ارائه می‌دهد. وقتی این فیلتر یک پرامپت را مسدود کند، هیچ درخواستی ارسال نمی‌شود، متدهای is_supported_* مقدار false برمی‌گردانند و generate_* یک WP_Error برمی‌گرداند:

<?php
// فقط مدیران اجازه ارسال پرامپت داشته باشند
add_filter( 'wp_ai_client_prevent_prompt', function ( $prevent ) {
    if ( ! current_user_can( 'manage_options' ) ) {
        return true;
    }
    return $prevent;
} );

و برای اینکه کلید در دیتابیس ذخیره نشود، آن را در سطح سرور تعریف کنید:

<?php
// wp-config.php : کلید را بیرون از دیتابیس نگه دارید
// (مقدار واقعی را از متغیر محیطی سرور بخوانید)
define( 'OPENAI_API_KEY', getenv( 'OPENAI_API_KEY' ) );

نکته: پیش از فعال کردن هر قابلیت AI روی سایتی که اطلاعات مشتری (فرم، سفارش، نوبت) دارد، مشخص کنید چه داده‌ای به ارائه‌دهنده می‌رود و این موضوع را در صفحه حریم خصوصی سایت شفاف بنویسید.

نسخه جاوااسکریپت AI Client (پکیج wp-ai-client) هم به یک قابلیت (capability) سطح بالا نیاز دارد که به‌طور پیش‌فرض فقط به مدیران داده می‌شود. تیم هسته استفاده از آن را برای افزونه‌های توزیع‌شده توصیه نمی‌کند و پیشنهاد می‌دهد به جای آن از endpointهای REST اختصاصی با بررسی دقیق دسترسی استفاده شود. برای مرور کلی امنیت، چک‌لیست امنیت وردپرس در ۲۰۲۶ را ببینید.

محدودیت‌ها: هوش مصنوعی وردپرس برای سایت‌های ایرانی چه وضعیتی دارد؟

AI Client فقط یک لایه اتصال است و دسترسی واقعی به مدل‌ها به ارائه‌دهنده بستگی دارد. سه ارائه‌دهنده رسمی (OpenAI، Anthropic و Google) فهرست کشورهای پشتیبانی‌شده دارند و ایران در فهرست‌های اعلام‌شده آن‌ها قرار ندارد؛ جزئیات و منابع را در مقاله محدودیت دسترسی کاربران ایرانی به ابزارهای هوش مصنوعی آورده‌ایم. محدودیت‌های دیگر:

• هسته وردپرس هیچ ارائه‌دهنده‌ای ندارد؛ بدون نصب افزونه ارائه‌دهنده و تنظیم آن، قابلیت‌های AI عملاً غیرفعال هستند.
• کیفیت خروجی فارسی به مدل انتخابی بستگی دارد و باید پیش از استفاده در تولید محتوا آزموده شود.
• راه قانونی جایگزین برای سایت‌هایی که نمی‌خواهند داده به سرویس خارجی برود، اجرای مدل‌های اوپن‌ویت روی سرور خود و اتصال آن از طریق یک افزونه ارائه‌دهنده سازگار است؛ این مسیر به سخت‌افزار و نگهداری بیشتر نیاز دارد.

از تجربه تیم siloow

تیم siloow در پروژه‌های وردپرسی و وب‌اپ‌های مدیریت تیم (وردپرس + React) قابلیت‌های هوش مصنوعی را بیشتر برای کارهای کمکی مثل پیشنهاد متن و دسته‌بندی محتوا به کار برده است. تجربه ما این بود که مشکل اصلی پروژه‌ها کد اتصال نبود، بلکه تصمیم‌گیری درباره داده بود: کدام فیلدها اجازه ارسال دارند، چه کسی دکمه AI را می‌بیند و خروجی قبل از انتشار توسط چه کسی بازبینی می‌شود. وجود یک لایه استاندارد مثل AI Client کار فنی را ساده می‌کند، اما این سه تصمیم همچنان باید قبل از نوشتن اولین خط کد گرفته شوند. در ویرایشگر جدید هم دکمه‌های AI داخل بلاک‌ها باید با محیط iframe سازگار باشند؛ جزئیات را در راهنمای Block API v3 نوشته‌ایم.

جمع‌بندی

• WP AI Client از وردپرس ۷.۰ یک API استاندارد و مستقل از ارائه‌دهنده برای ارسال پرامپت از افزونه‌ها است.
• مدیر سایت ارائه‌دهنده و کلید را در «تنظیمات › Connectors» یا با متغیر محیطی و ثابت PHP تعریف می‌کند.
• هسته هیچ ارائه‌دهنده‌ای ندارد و بدون تنظیم آن، درخواستی به مدل‌ها ارسال نمی‌شود.
• کلیدهای ذخیره‌شده در دیتابیس رمزنگاری نمی‌شوند؛ متغیر محیطی گزینه امن‌تری است.
• با فیلتر wp_ai_client_prevent_prompt می‌توان ارسال پرامپت را به نقش‌های مشخص محدود کرد.

اگر می‌خواهید قابلیت هوش مصنوعی را با رعایت حریم خصوصی و کنترل هزینه به سایت وردپرسی یا وب‌اپلیکیشن خود اضافه کنید، خدمات توسعه وب و یکپارچه‌سازی هوش مصنوعی siloow را ببینید. خبرهای بعدی وردپرس را هم در مگ siloow دنبال کنید.

منابع

• Introducing the AI Client in WordPress 7.0 — Make WordPress Core
• Introducing the Connectors API in WordPress 7.0 — Make WordPress Core
• WordPress 7.0 “Armstrong” — WordPress.org News

سوالات متداول درباره هوش مصنوعی وردپرس