DuetG AI Connector

سوالات متداول

چگونه ثبت گزارش اشکال‌زدایی را فعال کنم؟

برای فعال کردن ثبت گزارش اشکال‌زدایی، مورد زیر را به wp-config.php خود اضافه کنید:

define('DUETGAICON_DEBUG', true);

وقتی فعال باشد، اطلاعات اشکال‌زدایی در گزارش اشکال‌زدایی سرور شما نوشته می‌شود (معمولاً wp-content/debug.log). این شامل موارد زیر است:
* جزئیات درخواست/پاسخ برای فراخوانی‌های API هوش مصنوعی
* وضعیت ثبت ارائه‌دهنده
* اطلاعات پردازش‌کننده مدل

توجه: برای جلوگیری از تأثیر بر عملکرد و افزایش حجم فایل گزارش، ثبت گزارش اشکال‌زدایی را در محیط‌های عملیاتی غیرفعال کنید.

آیا این افزونه بدون وردپرس 7.0 کار می‌کند؟

خیر، این افزونه به وردپرس 7.0 یا بالاتر نیاز دارد زیرا از Connectors API داخلی برای مدیریت کلید API استفاده می‌کند.

چرا تعداد پیشنهادها و یادداشت‌ها گاهی با هم مطابقت ندارند؟

هنگام استفاده از Review Notes، ممکن است متوجه شوید که تعداد پیشنهادهای بازگردانده‌شده توسط هوش مصنوعی دقیقاً با تعداد یادداشت‌های نمایش‌داده‌شده در ویرایشگر یکسان نیست.

این رفتار مورد انتظار است و دو دلیل دارد:

1. پیشنهادهای چنددسته‌ای: بعضی مدل‌های هوش مصنوعی یک پیشنهاد واحد برمی‌گردانند که برای چند دسته بازبینی کاربرد دارد (مثلاً review_type: "seo, accessibility"). افزونه این موارد را به همان شکل حفظ می‌کند، بنابراین ممکن است یک پیشنهاد در چند دسته یادداشت در مشتری هوش مصنوعی وردپرس نمایش داده شود.

2. قالب پاسخ مدل: مدل هوش مصنوعی تعداد پیشنهادهایی را که برمی‌گرداند کنترل می‌کند و مشتری هوش مصنوعی وردپرس تعیین می‌کند آن‌ها چگونه نمایش داده و دسته‌بندی شوند. افزونه پاسخ مدل را بدون تغییر در تعداد، به‌درستی منتقل می‌کند.

اگر به نتایج سازگارتر نیاز دارید، از مدلی استفاده کنید که JSON ساختاریافته را با پیشنهادهای مجزا برای هر دسته‌بندی به‌طور قابل‌اعتماد برمی‌گرداند.

چگونه Base URL ارائه‌دهنده هوش مصنوعی خود را پیدا کنم؟

• Ollama (محلی): http://localhost:11434/v1
• LM Studio (محلی): http://localhost:1234/v1
• MiniMax: https://api.minimax.io/v1
• Moonshot: https://api.moonshot.ai/v1
• DeepSeek: https://api.deepseek.com/v1
• SiliconFlow: https://api.siliconflow.cn/v1
• سایر ارائه‌دهندگان: مستندات آن‌ها را بررسی کنید

آیا به کلید API نیاز دارم؟

بعضی ارائه‌دهندگان به کلید API نیاز دارند. برای نصب‌های محلی (مانند Ollama) که به احراز هویت نیاز ندارند، می‌توانید هر رشته ساختگی‌ای (مثلاً “not-required”) را به‌عنوان کلید API وارد کنید.

چرا مدل‌های استدلالی/فکری محلی گاهی با timeout مواجه می‌شوند؟

مدل‌های استدلالی محلی (مانند Gemma 4، QwQ و غیره) که روی Ollama اجرا می‌شوند، پیش از تولید پاسخ نهایی خود زنجیره‌های طولانی «تفکر» ایجاد می‌کنند. این فرایند می‌تواند 30 تا 60 ثانیه یا بیشتر طول بکشد که ممکن است timeout ناشی از حداقل سرعت cURL را فعال کند (به‌طور پیش‌فرض 30 ثانیه).

مدل‌های ابری معمولاً خوب کار می‌کنند – بیشتر ارائه‌دهندگان API ابری (DeepSeek، MiniMax، Moonshot و غیره) بدون مشکل timeout سریع پاسخ می‌دهند. اگر یک مدل ابری مکرراً با timeout مواجه می‌شود، ممکن است زنجیره‌های تفکر غیرمعمولاً طولانی داشته باشد؛ یک مدل دیگر را امتحان کنید.

راه‌حل‌های پیشنهادی برای مدل‌های محلی:

1. برای قابلیت‌های هوش مصنوعی محلی از مدل‌های غیر استدلالی استفاده کنید. برای Ollama، مدل‌هایی مانند qwen2.5:7b، llama3.2:3b یا phi3 بدون مشکل timeout به‌خوبی کار می‌کنند.

2. Ollama را طوری پیکربندی کنید که مدل‌ها را بارگذاری‌شده نگه دارد:
   bash
export OLLAMA_KEEP_ALIVE=-1 # Keep model in memory

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

چگونه از یک ارائه‌دهنده هوش مصنوعی محلی (مثل Ollama یا LM Studio) استفاده کنم؟

وردپرس به‌طور پیش‌فرض برای امنیت (محافظت SSRF)، درخواست‌ها به localhost و نشانی‌های IP خصوصی را مسدود می‌کند. اگر از یک ارائه‌دهنده هوش مصنوعی محلی استفاده می‌کنید، می‌توانید این محافظت را با افزودن مورد زیر به wp-config.php خود غیرفعال کنید:

define('DUETGAICON_ALLOW_LOCAL_URLS', true);

هشدار: غیرفعال کردن محافظت SSRF، درخواست‌ها به IPهای خصوصی/محلی را مجاز می‌کند. فقط زمانی این گزینه را فعال کنید که به ارائه‌دهنده هوش مصنوعی محلی خود اعتماد دارید و سرور شما مستقیماً از اینترنت در دسترس نیست.

این تنظیم هنگام استفاده از ارائه‌دهندگان هوش مصنوعی محلی، هم برای مدل‌های متنی و هم برای مدل‌های تصویری اعمال می‌شود.

نکته: هنگامی که DUETGAICON_ALLOW_LOCAL_URLS فعال باشد، ابزار آزمون اتصال شبکه در صفحه Test AI (ابزارها > Test AI) ظاهر می‌شود. می‌توانید از آن برای بررسی این‌که سرور وردپرس شما پیش از اجرای آزمون‌های واقعی قابلیت‌های هوش مصنوعی به ارائه‌دهنده هوش مصنوعی محلی شما دسترسی دارد یا نه، استفاده کنید. این مورد به‌ویژه برای اشکال‌زدایی مشکلات اتصال در نصب‌های محلی Ollama یا LM Studio مفید است.

چگونه از این در کد خود استفاده کنم؟

use WordPress\AiClient\AiClient;

$registry = AiClient::defaultRegistry();

// Text Generation
$model = $registry->getProviderModel('duetgaicon_text', 'gpt-4');
$result = $model->generateTextResult([
    new \WordPress\AiClient\Messages\DTO\UserMessage([
        new \WordPress\AiClient\Messages\DTO\MessagePart('Your prompt here')
    ])
]);
echo $result->toText();

// Image Generation
$model = $registry->getProviderModel('duetgaicon_image', 'dall-e-3');
$result = $model->generateImageResult([
    new \WordPress\AiClient\Messages\DTO\UserMessage([
        new \WordPress\AiClient\Messages\DTO\MessagePart('Your prompt here')
    ])
]);
$files = $result->toImageFiles();