معرفی و پیشخوان
اتصال هوش مصنوعی چیست، در کدام افزونه‌ها هست، منویش کجا می‌آید و هر تب چه کاری می‌کند.
این صفحه می‌گوید اتصال هوش مصنوعی چیست، چرا افزونه‌ی جدا نیست، منوی آن در وردپرس کجا دیده می‌شود، هشت تب آن چه می‌کنند و پیشخوان، لایسنس و راهنمای آن چه نشان می‌دهند.
اتصال هوش مصنوعی چیست
اتصال هوش مصنوعی تنها دروازه‌ی افزونه‌های FlowSense به ارائه‌دهنده‌های هوش مصنوعی (OpenAI، Anthropic، Google Gemini و …) است. افزونه‌ای که به هوش مصنوعی نیاز دارد، کلید شما را نمی‌بیند؛ پرسش را به اتصال می‌دهد و اتصال با کلید رمزشده‌ی شما آن را می‌فرستد، هزینه را می‌شمارد، سقف‌ها را می‌سنجد و خطا را به زبان ساده توضیح می‌دهد. علاوه بر این، ایندکس محتوا (یافتن بخش درست از نوشته‌ها و محصولات سایت) هم در همین‌جا ساخته می‌شود.
چند ویژگی ثابت:
- کلید خودتان: هیچ حساب، لایسنس یا سرویسی از ما در کار نیست؛ با ارائه‌دهنده‌ای که خودتان انتخاب می‌کنید و با کلید خودتان کار می‌کنید و هزینه را مستقیم به او می‌پردازید.
- کلید رمزشده: کلید پس از ذخیره رمزنگاری می‌شود و هیچ صفحه‌ای آن را دوباره نشان نمی‌دهد (فقط چهار نویسه‌ی آخر). ذخیره‌ی امن کلید به کتابخانه‌ی libsodium روی سرور نیاز دارد.
- تماس بیرونی شفاف: فهرست کامل مقصدهایی که افزونه می‌تواند به آن‌ها چیزی بفرستد در تب تشخیص آمده است.
نکته: در این بخش از آموزش، «ارائه‌دهنده» یعنی شرکتی که مدل هوش مصنوعی را می‌دهد (مثلاً OpenAI) و «افزونه‌ی مصرف‌کننده» یعنی افزونه‌ای که از اتصال پاسخ می‌خواهد (مثلاً سلیار).
کدام افزونه‌ها آن را دارند
اتصال هوش مصنوعی افزونه‌ی مستقل و جدا نیست؛ ماژولی مشترک است که یک‌به‌یک (بایت‌به‌بایت) داخل این افزونه‌ها تعبیه شده است:
- سلیار (دستیار فروش ووکامرس)
- کامنت‌یار (مدیریت دیدگاه)
- نوشتیار (محتوای هوش مصنوعی)
پوشیار و نسخه‌های Pro به اتصال جدا نیاز ندارند. اگر چند حامل با هم نصب باشند، وردپرس فقط تازه‌ترین نسخه‌ی تعبیه‌شده را راه می‌اندازد و بقیه خاموش می‌مانند؛ پس همیشه یک منو، یک مجموعه کلید و یک ایندکس دارید، و اگر یکی از حامل‌ها حذف شود، دیگری با همان داده‌ها ادامه می‌دهد. اگر نسخه‌ی تازه‌تری داده را ذخیره کرده ولی نسخه‌ی قدیمی‌تری اجرا شود، یک اعلان در پیشخوان وردپرس می‌گوید سلیار، کامنت‌یار یا نوشتیار را به‌روز کنید؛ همه‌چیز تا آن زمان کار می‌کند.
منو در وردپرس کجاست
یک منوی سطح‌بالا با نام «اتصال هوش مصنوعی» (نشانی admin.php?page=wp-ai-connect) در منوی کناری مدیریت وردپرس ساخته می‌شود. فقط کاربری که مجوز manage_options (مدیر سایت) دارد آن را می‌بیند و باز می‌کند. همین منو در هر سه حامل یکی است. در افزونه‌ی نوشتیار علاوه بر منو، یک دکمه‌ی «باز کردن اتصال هوش مصنوعی» در صفحه‌ی خود نوشتیار هست که همین صفحه را باز می‌کند. در فهرست افزونه‌ها هم پیوند «ارائه‌دهنده‌ها» کنار افزونه می‌نشیند.
بالای صفحه نام، شماره‌ی نسخه، «سازنده: FlowSense» و جمله‌ی «یک دروازه‌ی امن میان افزونه‌های شما و هوش مصنوعی» و زیر آن نوار تب‌ها دیده می‌شود.
تب‌های اتصال
| تب | شناسه | چه می‌کند | آموزش |
|---|---|---|---|
| پیشخوان | dashboard |
وضعیت کلی، راه‌اندازی سریع، گزینه‌ی حذف داده | همین صفحه |
| ارائه‌دهنده‌ها | providers |
روشن‌کردن ارائه‌دهنده، کلید، مدل، آزمون | ارائه‌دهنده‌ها |
| مصرف | usage |
هزینه، سقف‌ها، کش، پشتیبان، قیمت‌ها، تماس‌های اخیر | مصرف و سقف‌ها |
| ایندکس | index |
ایندکس محتوا و جست‌وجوی معنایی | ایندکس محتوا |
| دسترسی | access |
چت بازدیدکننده‌ها، توکن، محدودیت‌ها | دسترسی بازدیدکننده‌ها |
| لایسنس | license |
وضعیت Pro افزونه‌های خانواده | همین صفحه |
| تشخیص | diagnostics |
گزارش، انتقال تنظیمات، تماس‌های بیرونی، شکست‌ها | تشخیص و عیب‌یابی |
| راهنما | help |
پرسش‌های رایج، افزونه‌های خانواده، نکته‌ی توسعه‌دهنده | همین صفحه |
اگر نشانی تب ناشناخته باشد، پیشخوان باز می‌شود.
نوار «ذخیره همه تنظیمات»
در تب‌های مصرف، ایندکس و دسترسی یک نوار پایین صفحه هست با دکمه‌ی «ذخیره همه تنظیمات». ذخیره بدون بارگذاری مجدد صفحه انجام می‌شود و حالت‌ها این پیام‌ها را نشان می‌دهند:
- «تنظیمات ذخیره‌نشده دارید» وقتی چیزی را عوض کرده‌اید و ذخیره نکرده‌اید؛
- «در حال ذخیره تنظیمات...» در حین ذخیره؛
- «تنظیمات بدون بارگذاری مجدد صفحه ذخیره شد.» پس از موفقیت؛
- «ذخیره تنظیمات انجام نشد.» اگر خطایی پیش بیاید.
هر تنظیم روشن/خاموش در این افزونه یک کلید (toggle) است، نه تیک‌باکس. تب ارائه‌دهنده‌ها دکمه‌ی «ذخیره» خودش را روی هر کارت دارد.
پیشخوان
تب پیشخوان (dashboard) پیش‌فرض است و این بخش‌ها را دارد:
چهار شاخص بالا: «ارائه‌دهنده‌ی آماده» (شمار ارائه‌دهنده‌هایی که روشن‌اند و کلید قابل‌استفاده دارند)، «ارائه‌دهنده‌ی پیش‌فرض» (یا «انتخاب نشده»)، «نگهداری کلید» («رمزشده» یا «در دسترس نیست» اگر libsodium نباشد) و «شکست‌های اخیر». اگر شکستی ثبت شده باشد، یک جمله آخرین تماس ناموفق را (ارائه‌دهنده و کد) نام می‌برد و به «همهٔ شکست‌ها را در تشخیص ببینید» پیوند می‌دهد.
راه‌اندازی سریع
تا وقتی هیچ ارائه‌دهنده‌ای آماده نیست، پیشخوان کارت «راه‌اندازی سریع» را نشان می‌دهد: ارائه‌دهنده را از فهرست انتخاب می‌کنید، «کلید API» را می‌چسبانید و «راه‌اندازی و آزمون» را می‌زنید. اتصال به‌ترتیب: کلید را رمزشده ذخیره می‌کند، ارائه‌دهنده را روشن می‌کند، با یک پرسش بسیار کوچک آزمایش می‌کند، اگر آزمون موفق بود آن را پیش‌فرض می‌کند و ساخت ایندکس محتوا را شروع می‌کند (ساخت ایندکس کلید نمی‌خواهد). هر گام نتیجه‌اش را نشان می‌دهد؛ اگر آزمون ناموفق باشد همان‌جا می‌ایستد و علت را می‌گوید («کلید ذخیره شد، ولی آزمون ناموفق بود …»). ارائه‌دهنده‌هایی که نشانی لازم دارند (Ollama، سرویس سفارشی، Cloudflare) در این فهرست نیستند و در کارت خودشان در تب ارائه‌دهنده‌ها تنظیم می‌شوند. دکمه‌ی «کلید را از کجا بگیرم؟» به تب راهنما می‌رود.
وقتی دست‌کم یک ارائه‌دهنده آماده باشد، به‌جای آن کارت «شروع کار» با سه گام کوتاه (کلید را بچسبانید، «بررسی اتصال» و «آزمون با یک پرسش» را بزنید، افزونه‌های دیگر از اتصال استفاده می‌کنند) و دکمه‌ی «پرسش‌های رایج» می‌آید.
داده‌های شما: حذف داده با حذف افزونه
کلید «با حذف افزونه، همه‌ی داده‌های اتصال هوش مصنوعی (از جمله کلیدهای ذخیره‌شده) پاک شود» (گزینه‌ی delete_data_on_uninstall) پیش‌فرض خاموش است. خاموش: حذف حامل‌ها کلیدها و تنظیمات را نگه می‌دارد و با نصب دوباره همه‌چیز برمی‌گردد. روشن: با حذف، همه‌ی داده‌ها از جمله کلیدها پاک می‌شود.
هشدار: این کلید با ذخیره‌ی فوری اعمال می‌شود. اگر قصد حذف دائمی دارید و می‌خواهید هیچ ردی نماند آن را روشن کنید؛ در غیر این صورت خاموش بگذارید.
لایسنس
تب لایسنس (license) فقط نشان می‌دهد هر محصول خانواده (سلیار، کامنت‌یار، پوشیار، نوشتیار) روی این سایت در چه حالتی است. خود اتصال هوش مصنوعی لایسنس ندارد و این صفحه فیلد کلید ندارد؛ هیچ‌چیز به بیرون فرستاده نمی‌شود و صفحه فقط می‌بیند چه افزونه‌هایی روی سایت هست. جدول سه ستون دارد: «افزونه»، «Pro» و «چه کار کنم».
| وضعیت نمایش‌داده‌شده | یعنی | دکمه |
|---|---|---|
| نصب نیست | افزونه‌ی رایگان آن نصب نیست | «نخست افزونه‌ی رایگان را نصب کنید.» |
| هنوز Pro ندارد | رایگان هست، Pro نصب نیست | «خرید Pro» (سایت فارسی) یا «درخواست Pro» (سایر زبان‌ها) |
| Pro نصب است ولی روشن نیست | Pro نصب شده و فعال نیست | «روشن‌کردن در افزونه‌ها» |
| Pro روشن است و منتظر به‌روزرسانی افزونه‌ی رایگان است | رایگان قدیمی است | «افزونه‌ی رایگان را به‌روز کنید» |
| Pro روشن است و منتظر لایسنس | Pro روشن ولی لایسنس وارد نشده | «باز کردن صفحه‌ی لایسنس آن» |
| Pro فعال است | همه‌چیز آماده | «باز کردن صفحه‌ی لایسنس آن» |
خرید با دکمه‌ی همین صفحه انجام می‌شود: برای سایت فارسی از ژاکت (لایسنس برای یک نشانی سایت است و در صفحه‌ی لایسنس همان Pro وارد می‌شود)، و برای سایر زبان‌ها از طریق درخواست در صفحه‌ی سازنده.
راهنما
تب راهنما (help) سه بخش دارد:
- پرسش‌های رایج: پاسخ کوتاه به پرسش‌هایی مثل کلید را از کجا بگیرم، هزینه چقدر است، محتوای من به کجا می‌رود، آیا کسی کلید را می‌خواند، چرا آزمون «در دسترس نیست» می‌گوید و آیا افزونه با بیرون تماس می‌گیرد. شرح بیشتر همین‌ها در پرسش‌ها هست.
- افزونه‌های خانواده: جدول «افزونه»، «نسخه»، «حداقل نسخه‌ی لازم» و «وضعیت» (نصب نیست / با این اتصال کار می‌کند / نیاز به به‌روزرسانی / نصب است ولی هنوز از اتصال استفاده نمی‌کند). زیر جدول کلید
pushyar_alertsاست: «به مدیران از راه پوشیار اطلاع بده وقتی سقف هزینه به ۵۰، ۸۰ یا ۱۰۰ درصد می‌رسد یا ارائه‌دهنده کلید را نمی‌پذیرد». پیش‌فرض خاموش است (چون به آدم‌ها پیام می‌دهد) و تا وقتی پوشیار راه‌اندازی نشده و در نسخه‌ی سازگار نباشد غیرفعال می‌ماند. - برای توسعه‌دهنده‌های افزونه‌های دیگر: هر افزونه‌ی دیگر (مثلاً افزونه‌ی ووکامرس) می‌تواند از اتصال استفاده کند، بی‌آنکه کلید را ببیند؛ مصرفش در تب مصرف با سقف خودش دیده می‌شود. نمونه‌ی کد همان‌جا هست (ثبت افزونه با
wpaic_register_consumer، بررسی آمادگی باwpaic_is_readyو پرسش باwpaic_chat) و افزونه باید بدون اتصال هم کار کند.