هوش مصنوعی، دستیار قدرتمند تولید محتوا

در دنیای دیجیتال، هوش مصنوعی به ابزاری کلیدی برای تولید محتوای سریع و باکیفیت تبدیل شده است. تابع call_deepseek_v3 با استفاده از API Deepseek-V3، این امکان را فراهم می‌کند تا با ارسال یک پِرامپت (Prompt) و تنظیم پارامترهایی مانند تعداد توکن‌ها (max_tokens)، محتوای حرفه‌ای و متناسب با نیاز خود را دریافت کنید. این تابع به ۱۱ بخش کلیدی تقسیم شده است که هر کدام نقش مهمی در فرآیند تولید محتوا ایفا می‌کنند. از تنظیمات اولیه و ارسال درخواست به API تا دریافت و نمایش پاسخ، همه‌چیز به شکلی امن و کاربردی پیاده‌سازی شده است. با استفاده از این راه‌حل، تولید محتوا دیگر یک چالش نیست، بلکه یک فرآیند ساده و لذت‌بخش است.

هدف تابع  call_deepseek_v3 چیست؟

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

این تابع و شورت‌کد به زبان PHP نوشته شده و هدفش اینه که با استفاده از API دیپ‌سیک (Deepseek-V3) به یک مدل هوش مصنوعی متصل بشه و پاسخ‌های متنی بگیره. حالا بیا تو ۴ خط بگم چه خبره:

1. درخواست به API: تابع call_deepseek_v3 یک درخواست POST به API دیپ‌سیک می‌فرسته و یک متن (پِرامپت) رو به عنوان ورودی به مدل هوش مصنوعی می‌ده. مدل هم بر اساس این متن، یک پاسخ تولید می‌کنه.
2. پردازش پاسخ: پاسخ API دریافت شده و بررسی می‌شه. اگر خطایی نباشه، متن پاسخ از JSON استخراج شده و برای نمایش آماده می‌شه.
3. قالب‌بندی و امنیت: پاسخ دریافتی با استفاده از wp_kses فیلتر می‌شه تا فقط تگ‌های HTML مجاز باقی بمونن و از حملات XSS جلوگیری بشه. بعدش هم با یک div قالب‌بندی می‌شه.
4. شورت‌کد: تابع deepseek_shortcode این امکان رو فراهم می‌کنه که کاربران داخل وردپرس با یک کد ساده مثل [deepseek prompt="متن شما"] از این قابلیت استفاده کنن و پاسخ هوش مصنوعی رو تو سایتشون نمایش بدن.

این تابع به چند قسمت کلی تقسیم شده است

این تابع به ۴ قسمت کلی تقسیم شده است:

1. ارسال درخواست به API
2. بررسی خطاها و پردازش پاسخ
3. قالب‌بندی و امنیت پاسخ
4. ایجاد شورت‌کد برای استفاده آسان

در حقیقت تابع
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 برای تولید محتوا در سایت وردپرس خود استفاده کنید. این روش نه‌تنها کارآمد است، بلکه با رعایت اصول امنیتی، از سایت شما در برابر حملات احتمالی محافظت می‌کند.

امیدوارم این مقاله برای شما مفید بوده باشد! اگر سوالی دارید، خوشحال می‌شوم کمک کنم. 😊