تشخیص و عیب‌یابی
گزارش تشخیصی، انتقال تنظیمات به سایت دیگر، فهرست تماس‌های بیرونی، شکست‌های اخیر، کدهای خطا با راه‌حل و پرسش‌های رایج.
این صفحه تب تشخیص (admin.php?page=wp-ai-connect&tab=diagnostics) را شرح می‌دهد و هر خطایی را که اتصال نشان می‌دهد با معنا و راه‌حلش فهرست می‌کند.
تب تشخیص
این تب چهار بخش دارد: «گزارش»، «بردن تنظیمات به سایت دیگر»، «هر تماس بیرونی» و «شکست‌های اخیر».
گزارش
جعبه‌ی «گزارش» وضعیت اتصال را برای ارسال به پشتیبانی آماده می‌کند. فقط می‌گوید کلید ثبت شده یا نه (بله/خیر)، نه اینکه کلید چیست. هنگام درخواست کمک «کپی گزارش» را بزنید و متن را بفرستید.
بردن تنظیمات به سایت دیگر
با «دریافت فایل تنظیمات» یک فایل JSON می‌گیرید و با «خواندن فایل تنظیمات» آن را روی سایت دیگر می‌خوانید (تا ۲۵۶ کیلوبایت؛ سایت قبل از جایگزین‌کردن می‌پرسد). فایل حاوی این‌هاست: ارائه‌دهنده‌هایی که استفاده می‌کنید و مدل‌هایشان، سقف‌های هزینه، ارائه‌دهنده‌های پشتیبان، انتخاب‌های کش و ایندکس و قیمت‌ها.
- هرگز کلید در فایل نیست؛ در سایت مقصد کلیدها را دوباره وارد کنید.
- نشانی ارائه‌دهنده‌ها از فایل تنظیم نمی‌شود؛ فقط نشان داده می‌شود تا اگر مطمئن‌اید دستی بگذارید.
- پوشاندن داده‌ی شخصی، تماس‌های عمومی خودتان، پروکسی‌های مورد اعتماد، هشدارها و کلید حذف داده برای هر سایت جدا می‌مانند.
پس از خواندن، خلاصه می‌آید: «خوانده شد: … تنظیم تغییر کرد، … ارائه‌دهنده، … قیمت.»، به‌همراه «تغییر کرد، بررسی کنید:»، «نشانی‌های درون فایل، تنظیم‌نشده …»، «کلید را دوباره وارد کنید برای:» و «خوانده نشد (این‌جا ناشناخته):». سپس صفحه را دوباره بارگذاری کنید پیش از ذخیره‌ی هر چیز دیگر.
هر تماس بیرونی
جدول «مقصد / چه چیزی فرستاده می‌شود / کی و چرا» فهرست کامل جاهایی است که افزونه می‌تواند چیزی به آن‌ها بفرستد. چیز دیگری نیست: نه بررسی لایسنس، نه آمار، نه سرویس به‌روزرسانی از ما.
| مقصد | چه چیزی | کی |
|---|---|---|
| میزبان‌های ارائه‌دهنده‌های بالا | متن درخواست افزونه، نام مدل و کلید (در سربرگ، نه در نشانی) | فقط وقتی افزونه‌ای پاسخ بخواهد یا دکمه‌ی آزمون را بزنید؛ هرگز زمان‌بندی خودکار |
| نشانی Ollama یا سرویس سفارشی | همان، به سرویس انتخابی شما | فقط برای سرویسی که خودتان تنظیم کرده‌اید |
| ارائه‌دهنده‌ی جست‌وجوی معنایی | متن تکه‌های عمومی ایندکس و واژه‌های جست‌وجو | فقط با روشن‌کردن جست‌وجوی معنایی؛ پس‌زمینه و پرسش‌ها برای یک روز کش می‌شوند |
| ارائه‌دهنده‌ی چت بازدیدکننده | آنچه بازدیدکننده نوشته (داده‌ی شخصی پوشانده)، چند پیام آخر و تکه‌های صفحه‌های عمومی پیداشده | فقط وقتی بازدیدکننده در چتی که روشن کرده‌اید بنویسد |
| نشانی اصلی ارائه‌دهنده | هیچ (درخواست خالی بدون کلید) | فقط با «بررسی اتصال» |
شکست‌های اخیر
جدول «زمان / ارائه‌دهنده / کد / پیام» آخرین تماس‌های ناموفق را نشان می‌دهد (در شاخص پیشخوان هم شمرده می‌شود). «پاک‌کردن فهرست» آن را خالی می‌کند. اگر شکستی نیست: «شکستی ثبت نشده است.»
کدهای خطا و راه‌حل
وقتی «آزمون با یک پرسش» ناموفق شود سه بخش می‌بینید: «پیام ارائه‌دهنده»، «یعنی چه» و «راه حل»؛ کد در تب تشخیص و در جدول مصرف هم دیده می‌شود. کدها:
| کد | معنا | چه کنم |
|---|---|---|
wpaic_auth_failed |
ارائه‌دهنده کلید را نپذیرفت | کلید تازه از صفحه‌ی ارائه‌دهنده بسازید، بدون فاصله بچسبانید، «ذخیره» و «آزمون با یک پرسش». اشتراک ChatGPT/Claude کلید API نیست |
wpaic_model_not_found |
ارائه‌دهنده این مدل را نمی‌شناسد | «بارگذاری مدل‌ها» را بزنید و از فهرست انتخاب کنید |
wpaic_rate_limited |
درخواست‌ها زیاد است یا اعتبار حساب تمام شده است | اگر اعتبار تمام شده در صفحه‌ی صورت‌حساب ارائه‌دهنده اعتبار اضافه کنید (کلید عوض نمی‌شود) یا ارائه‌دهنده‌ی دارای سطح رایگان بگذارید؛ در غیر این صورت یک دقیقه صبر کنید |
wpaic_timeout |
ارائه‌دهنده به‌موقع پاسخ نداد | دوباره امتحان یا مدل سریع‌تر؛ اگر همیشه رخ می‌دهد «بررسی اتصال» |
wpaic_network_blocked |
سرور نتوانست به ارائه‌دهنده برسد | میزبان از اتصال خروجی جلوگیری می‌کند (بیشتر در ایران)؛ از میزبان بخواهید باز کند یا پروکسی بگذارد، یا ارائه‌دهنده‌ای انتخاب کنید که میزبانتان می‌رسد. در مشکل گواهی SSL از میزبان بخواهید فهرست گواهی را به‌روز کند |
wpaic_bad_response |
ارائه‌دهنده با خطا پاسخ داد | چند دقیقه بعد دوباره؛ اگر ادامه داشت صفحه‌ی وضعیت ارائه‌دهنده را ببینید یا گزارش تشخیص را کپی کنید |
wpaic_invalid_request |
درخواست معتبر نیست | معمولاً مدل یکی از تنظیم‌ها را نمی‌پذیرد؛ مدل دیگری با «بارگذاری مدل‌ها» انتخاب کنید |
wpaic_bad_url |
این نشانی قابل استفاده نیست | نشانی کامل را مثل https://example.com/v1 بنویسید (http برای سرویس روی اینترنت پذیرفته نیست) و «ذخیره» |
wpaic_no_provider |
هنوز هیچ ارائه‌دهنده‌ی هوش مصنوعی راه‌اندازی نشده است | در تب ارائه‌دهنده‌ها یکی را روشن، کلید را بچسبانید، «ذخیره» و آزمون کنید |
wpaic_no_key |
این ارائه‌دهنده کلید قابل‌استفاده ندارد | کلید ذخیره نیست یا باز نمی‌شود (مثلاً بعد از انتقال سایت)؛ کلید را دوباره بچسبانید و «ذخیره» |
wpaic_content_filtered |
ارائه‌دهنده این را به دلیل ایمنی مسدود کرد | کلید مشکلی ندارد؛ دوباره امتحان کنید یا آنچه افزونه می‌پرسد را عوض کنید |
wpaic_truncated |
پاسخ پیش از کامل‌شدن بریده شد | پاسخ کوتاه‌تر بخواهید یا در افزونه‌ی پرسنده توکن بیشتر مجاز کنید |
wpaic_budget_exceeded |
سقف هزینه‌ای که خودتان در اتصال گذاشته‌اید پر شده، پس درخواستی فرستاده نشد | سقف را در تب مصرف بالا ببرید یا تا شروع روز/ماه بعد صبر کنید. همین کد وقتی برآورد هزینه‌ی تماس از باقی‌مانده‌ی سقف بیشتر است یا هزینه شمرده نمی‌شود هم برمی‌گردد |
علت‌های تشخیصی که کنار پیام می‌آید شامل این‌هاست: شکست اتصال امن (گواهی SSL قدیمی یا فیلتر میانی؛ از میزبان بپرسید)، نرسیدن سرور به ارائه‌دهنده، رد سرور پیش از دیدن کلید (صفحه‌ی ساده‌ی Forbidden که معمولاً یعنی نشانی یا کشور سرور مسدود است)، تمام‌شدن اعتبار حساب، و زیادی درخواست در زمان کوتاه (یک دقیقه صبر کنید).
نکته: اگر برای تماسی چند ارائه‌دهنده امتحان شده باشد، تلاش‌های قبلی در داده‌ی خطا ثبت می‌شود. ارائه‌دهنده‌ی پشتیبان فقط خطاهایی را جبران می‌کند که ارائه‌دهنده‌ی دیگر می‌تواند درمان کند.
پرسش‌های رایج
کلید را از کجا بگیرم؟
از پنل خود ارائه‌دهنده؛ در تب ارائه‌دهنده‌ها روی کارتش «کلید را از کجا بگیرم» را بزنید. Groq، Gemini، OpenRouter، Cerebras، SambaNova و GitHub Models سطح رایگان دارند و Ollama بی کلید روی رایانه‌ی خودتان اجرا می‌شود.
هزینه چقدر است؟
خود اتصال رایگان است و سرویسی از ما در کار نیست؛ فقط به ارائه‌دهنده پول مصرفتان را به نرخ خودش می‌دهید. تب مصرف هزینه را از روی توکن و فهرست قیمت برآورد می‌کند و سقف روزانه و ماهانه پیش از گذشتن از مبلغ تنظیم‌شده جلوی تماس را می‌گیرند.
محتوای من به کجا می‌رود؟
فقط به ارائه‌دهنده‌ای که انتخاب کرده‌اید، و فقط وقتی افزونه‌ای پاسخ بخواهد یا دکمه‌ی آزمون را بزنید. ایندکس روی سرور خودتان ساخته می‌شود و چیزی نمی‌فرستد؛ جست‌وجوی معنایی فقط در صورت روشن‌کردن تکه‌های عمومی ایندکس را برای ارائه‌دهنده می‌فرستد.
کسی می‌تواند کلید را بخواند؟
نه. پس از ذخیره هیچ صفحه، اسکریپت یا پاسخی آن را ندارد؛ رمزشده روی سرور نگه داشته می‌شود و فقط چهار نویسه‌ی آخرش دیده می‌شود. افزونه‌های دیگر فقط پاسخ می‌خواهند و کلید را نمی‌بینند. چت بازدیدکننده توکن دسترسی جدا دارد که کلید نیست.
آزمون می‌گوید «در دسترس نیست»؛ کلیدم غلط است؟
لزوماً نه. «بررسی اتصال» فقط می‌پرسد این سرور اصلاً به ارائه‌دهنده می‌رسد یا نه. بعضی میزبان‌ها (مثلاً در ایران) بعضی ارائه‌دهنده‌ها را می‌بندند؛ ارائه‌دهنده‌ی دیگری انتخاب کنید یا در ورودی «سرویس سازگار با OpenAI» نشانی پروکسی بگذارید. «آزمون با یک پرسش» کلید ردشده را از مشکل شبکه جدا می‌کند.
افزونه می‌گوید هوش مصنوعی آماده نیست؛ چه کم است؟
دست‌کم یک ارائه‌دهنده باید روشن باشد و کلیدی داشته باشد که باز می‌شود (تب ارائه‌دهنده‌ها)، و سقف هزینه‌ی همان افزونه پر نشده باشد (تب مصرف، «به‌تفکیک افزونه»).
بازدیدکننده‌ها خودشان با هوش مصنوعی حرف می‌زنند؟
فقط از راه افزونه‌ای که چت دارد و فقط پس از اینکه در تب دسترسی روشنش کنید، با محدودیت‌هایی که همان‌جا می‌گذارید. هر چت در ابتدا خاموش است.
آیا اتصال با بیرون تماس می‌گیرد یا لایسنس می‌خواهد؟
نه. لایسنس، آمار یا سرویس به‌روزرسانی از ما در کار نیست؛ به‌روزرسانی به روش عادی وردپرس (از طریق افزونه‌ی حامل) می‌آید.
کدام افزونه‌ام اتصال را می‌برد و چرا دو منو نیست؟
اتصال داخل سلیار، کامنت‌یار و نوشتیار تعبیه است و فقط تازه‌ترین نسخه‌ی تعبیه‌شده راه می‌افتد؛ پس هرچند حامل نصب باشد، یک منو، یک مجموعه کلید و یک ایندکس هست. ببینید معرفی.