هوش مصنوعی، دستیار قدرتمند تولید محتوا
در دنیای دیجیتال، هوش مصنوعی به ابزاری کلیدی برای تولید محتوای سریع و باکیفیت تبدیل شده است. تابع call_deepseek_v3 با استفاده از API Deepseek-V3، این امکان را فراهم می‌کند تا با ارسال یک پِرامپت (Prompt) و تنظیم پارامترهایی مانند تعداد توکن‌ها (max_tokens)، محتوای حرفه‌ای و متناسب با نیاز خود را دریافت کنید. این تابع به ۱۱ بخش کلیدی تقسیم شده است که هر کدام نقش مهمی در فرآیند تولید محتوا ایفا می‌کنند. از تنظیمات اولیه و ارسال درخواست به API تا دریافت و نمایش پاسخ، همه‌چیز به شکلی امن و کاربردی پیاده‌سازی شده است. با استفاده از این راه‌حل، تولید محتوا دیگر یک چالش نیست، بلکه یک فرآیند ساده و لذت‌بخش است.
هدف تابع call_deepseek_v3 چیست؟
با استفاده از هوش مصنوعی Deepseek-V3 و وردپرس، تولید محتوای حرفه‌ای و سئو فرندلی را خودکار کنید. در این راهنما، مراحل ایجاد محتوای باکیفیت را به سادگی یاد بگیرید.
این تابع و شورت‌کد به زبان PHP نوشته شده و هدفش اینه که با استفاده از API دیپ‌سیک (Deepseek-V3) به یک مدل هوش مصنوعی متصل بشه و پاسخ‌های متنی بگیره. حالا بیا تو ۴ خط بگم چه خبره:
- درخواست به API: تابع
call_deepseek_v3یک درخواست POST به API دیپ‌سیک می‌فرسته و یک متن (پِرامپت) رو به عنوان ورودی به مدل هوش مصنوعی می‌ده. مدل هم بر اساس این متن، یک پاسخ تولید می‌کنه. - پردازش پاسخ: پاسخ API دریافت شده و بررسی می‌شه. اگر خطایی نباشه، متن پاسخ از JSON استخراج شده و برای نمایش آماده می‌شه.
- قالب‌بندی و امنیت: پاسخ دریافتی با استفاده از
wp_ksesفیلتر می‌شه تا فقط تگ‌های HTML مجاز باقی بمونن و از حملات XSS جلوگیری بشه. بعدش هم با یک div قالب‌بندی می‌شه. - شورت‌کد: تابع
deepseek_shortcodeاین امکان رو فراهم می‌کنه که کاربران داخل وردپرس با یک کد ساده مثل[deepseek prompt="متن شما"]از این قابلیت استفاده کنن و پاسخ هوش مصنوعی رو تو سایتشون نمایش بدن.
این تابع به چند قسمت کلی تقسیم شده است
این تابع به ۴ قسمت کلی تقسیم شده است:
- ارسال درخواست به API
- بررسی خطاها و پردازش پاسخ
- قالب‌بندی و امنیت پاسخ
- ایجاد شورت‌کد برای استفاده آسان
در حقیقت تابع
function call_deepseek_v3($prompt, $max_tokens = 50)
به 11 گام تقسیم شده است
تولید محتوا در ۱۱ گام: نحوه استفاده از هوش مصنوعی برای تولید محتوا با Deepseek-V3
در این مقاله، به بررسی کامل یک تابع PHP می‌پردازیم که از API هوش مصنوعی Deepseek-V3 برای تولید محتوا استفاده می‌کند. این تابع به ۱۱ بخش تقسیم شده است که هر کدام وظیفه خاصی را انجام می‌دهند. در ادامه، هر بخش را به همراه توابع مربوطه و توضیحات کامل بررسی می‌کنیم.
۱. تنظیم کلید API و آدرس
- توابع مربوطه: ندارد (تنظیم دستی متغیرها).
- توضیحات:
در این بخش، کلید API ($api_key) و آدرس API ($api_url) تنظیم می‌شوند. این اطلاعات برای ارتباط با سرویس Deepseek-V3 ضروری هستند. کلید API مانند یک رمز عبور عمل می‌کند و آدرس API مشخص می‌کند که درخواست‌ها به کجا ارسال شوند.
۲. آماده‌سازی داده‌ها برای ارسال به API
- توابع مربوطه:
json_encode. - توضیحات:
در این بخش، داده‌هایی که قرار است به API ارسال شوند، آماده می‌شوند. این داده‌ها شامل مدل مورد استفاده (deepseek-chat)، پیام‌های کاربر و سیستم، و تنظیمات دیگر مانندmax_tokensوstreamهستند. تابعjson_encodeاین داده‌ها را به فرمت JSON تبدیل می‌کند تا برای ارسال به API مناسب باشند.
۳. ارسال درخواست POST به API
- توابع مربوطه:
wp_remote_post. - توضیحات:
در این بخش، درخواست POST به API ارسال می‌شود. تابعwp_remote_postدر وردپرس برای ارسال درخواست‌های HTTP استفاده می‌شود. این تابع شامل هدرها (مانندAuthorizationوContent-Type) و بدنه درخواست (داده‌های JSON) است.
۴. بررسی خطاهای ارتباطی
- توابع مربوطه:
is_wp_error. - توضیحات:
پس از ارسال درخواست، بررسی می‌شود که آیا خطایی در ارتباط با API رخ داده است یا خیر. تابعis_wp_errorبررسی می‌کند که آیا پاسخ دریافتی حاوی خطا است. اگر خطایی وجود داشته باشد، آن را در فایل لاگ ثبت می‌کند و یک پیام خطا به کاربر نمایش می‌دهد.
۵. دریافت پاسخ از API
- توابع مربوطه:
wp_remote_retrieve_body. - توضیحات:
در این بخش، پاسخ دریافتی از API استخراج می‌شود. تابعwp_remote_retrieve_bodyبدنه پاسخ (Response Body) را به صورت یک رشته متنی برمی‌گرداند. این پاسخ معمولاً به فرمت JSON است.
۶. بررسی خطاهای JSON
- توابع مربوطه:
json_decode,json_last_error,json_last_error_msg. - توضیحات:
پاسخ دریافتی از API به فرمت JSON است و باید به یک آرایه یا شیء PHP تبدیل شود. تابعjson_decodeاین کار را انجام می‌دهد. اگر در این فرآیند خطایی رخ دهد، توابعjson_last_errorوjson_last_error_msgبرای تشخیص و ثبت خطا استفاده می‌شوند.
۷. بررسی خطاهای پاسخ API
- توابع مربوطه: ندارد (بررسی دستی کلید
errorدر آرایه). - توضیحات:
در این بخش، بررسی می‌شود که آیا پاسخ API حاوی خطا است یا خیر. اگر کلیدerrorدر پاسخ وجود داشته باشد، پیام خطا ثبت شده و به کاربر نمایش داده می‌شود.
۸. استخراج محتوای پاسخ
- توابع مربوطه: ندارد (دسترسی به آرایه با کلید
choices). - توضیحات:
اگر پاسخ API معتبر باشد، محتوای تولید شده توسط هوش مصنوعی از آرایهchoicesاستخراج می‌شود. این محتوا در متغیر$contentذخیره می‌شود.
۹. فیلتر و قالب‌بندی HTML برای امنیت
- توابع مربوطه:
wp_kses. - توضیحات:
برای جلوگیری از حملات XSS و اطمینان از امنیت، محتوای دریافتی با تابعwp_ksesفیلتر می‌شود. این تابع فقط تگ‌های HTML مجاز را حفظ می‌کند و بقیه را حذف می‌کند.
۱۰. اضافه کردن قالب‌بندی CSS
- توابع مربوطه: ندارد (قالب‌بندی دستی با HTML).
- توضیحات:
محتوای فیلتر شده در یک div با کلاسdeepseek-responseقرار می‌گیرد تا بتوان آن را با CSS قالب‌بندی کرد. این کار باعث می‌شود محتوا به زیبایی در صفحه نمایش داده شود.
۱۱. ایجاد شورت‌کد و تنظیم پارامترهای پیش‌فرض
- توابع مربوطه:
shortcode_atts,add_shortcode. - توضیحات:
در این بخش، یک شورت‌کد برای استفاده آسان در وردپرس ایجاد می‌شود. تابعshortcode_attsپارامترهای پیش‌فرض (مانندpromptوmax_tokens) را تنظیم می‌کند. سپس با تابعadd_shortcode، شورت‌کد[deepseek]به وردپرس اضافه می‌شود تا کاربران بتوانند از آن استفاده کنند.
function call_deepseek_v3($prompt, $max_tokens = 50) {
$api_key = 'sk-d727111111111112ef6295e72'; // کلید API
$api_url = 'https://api.deepseek.com/chat/completions'; // آدرس API
//1- ارسال درخواست به API
$response = wp_remote_post($api_url, array(
'headers' => array(
'Content-Type' => 'application/json',
'Authorization' => 'Bearer ' . $api_key
),
//۲- آماده‌سازی داده‌ها برای ارسال به API
'body' => json_encode(array(
'model' => 'deepseek-chat', // نام مدل
'messages' => array(
array(
'role' => 'system',
'content' => 'You are a helpful assistant.'
),
//۳. ارسال درخواست POST به API
array(
'role' => 'user',
'content' => $prompt // متن درخواست کاربر
)
),
'max_tokens' => (int) $max_tokens, // محدودیت تعداد توکن‌ها
'stream' => false // غیرفعال کردن استریم
)),
'timeout' => 30 // زمان انتظار برای پاسخ
));
// 4- بررسی خطاها
if (is_wp_error($response)) {
error_log('Error connecting to Deepseek-V3: ' . $response->get_error_message());
return 'خطا در ارتباط با Deepseek-V3: ' . $response->get_error_message();
}
//5- پردازش پاسخ
$body = wp_remote_retrieve_body($response);
error_log('API Response: ' . $body); // ذخیره پاسخ API در فایل لاگ
$data = json_decode($body, true);
//6- بررسی خطای JSON
if (json_last_error() !== JSON_ERROR_NONE) {
error_log('JSON Decode Error: ' . json_last_error_msg());
return 'خطا در پردازش پاسخ API';
}
//7- بررسی وجود خطا API در پاسخ
if (isset($data['error'])) {
error_log('API Error: ' . $data['error']['message']);
return 'خطا از سمت API: ' . $data['error']['message'];
}
//8- بررسی ساختار پاسخ و بازگرداندن محتوا
if (isset($data['choices'][0]['message']['content'])) {
$content = $data['choices'][0]['message']['content'];
// تعریف تگ‌های مجاز برای قالب‌بندی HTML
$allowed_tags = array(
'p' => array(),
'h1' => array(),
'h2' => array(),
'h3' => array(),
'h4' => array(),
'h5' => array(),
'h6' => array(),
'ul' => array(),
'ol' => array(),
'li' => array(),
'strong' => array(),
'em' => array(),
'a' => array(
'href' => array(),
'title' => array(),
'target' => array(),
),
'div' => array(
'class' => array(),
),
'span' => array(
'class' => array(),
),
'br' => array(),
'hr' => array(),
);
//9- اعمال wp_kses برای امنیت و قالب‌بندی HTML
$formatted_content = wp_kses($content, $allowed_tags);
//10- اعمال قالب‌بندی CSS
$formatted_content = '<div class="deepseek-response">' . $formatted_content . '</div>';
return $formatted_content;
} else {
error_log('Invalid API Response: ' . print_r($data, true));
return 'پاسخ نامعتبر از API';
}
}
//11- ایجاد یک شورت‌کد برای استفاده آسان
function deepseek_shortcode($atts) {
// تنظیم پارامترهای پیش‌فرض
$atts = shortcode_atts(array(
'prompt' => 'لطفاً یک متن وارد کنید.', // متن پیش‌فرض درخواست
'max_tokens' => 50 // تعداد پیش‌فرض توکن‌ها
), $atts, 'deepseek');
// فراخوانی تابع و بازگرداندن نتیجه
return call_deepseek_v3($atts['prompt'], $atts['max_tokens']);
}
add_shortcode('deepseek', 'deepseek_shortcode');نتیجه‌گیری
این تابع به ۱۱ بخش تقسیم شده است که هر کدام وظیفه خاصی را انجام می‌دهند. از تنظیم کلید API و ارسال درخواست تا دریافت پاسخ و نمایش آن، همه‌چیز به‌صورت ساختارمند و ایمن انجام می‌شود. با استفاده از این تابع، می‌توانید به راحتی از هوش مصنوعی Deepseek-V3 برای تولید محتوا در سایت وردپرس خود استفاده کنید. این روش نه‌تنها کارآمد است، بلکه با رعایت اصول امنیتی، از سایت شما در برابر حملات احتمالی محافظت می‌کند.
امیدوارم این مقاله برای شما مفید بوده باشد! اگر سوالی دارید، خوشحال میشوم کمک کنم. 😊
