تنظیمات رایگان عامل هوش مصنوعی (AI Agent)
صفحه تنظیمات → پیشرفته در Gratis AI Agent امکان پیکربندی سطح مدیر را برای یکپارچهسازیهای بکاند که در نسخه v1.5.0 معرفی شدهاند، فراهم میکند. این صفحه مستند کردن فیلدهای نقطه پایانی بازخورد (Feedback Endpoint) و فرمت مورد انتظار آنها است.
دسترسی به تنظیمات
۱. در پنل مدیریت وردپرس، به مسیر Gratis AI Agent → Settings بروید. ۲. روی تب Advanced کلیک کنید.
پیکربندی نقطه پایانی بازخورد (Feedback Endpoint)
نقطه پایانی بازخورد درخواستهای POST را از عامل هوش مصنوعی دریافت میکند؛ این اتفاق زمانی رخ میدهد که کاربر از طریق دکمه "لایک نکردن" (thumbs-down)، بنر پیشنهاد خودکار، یا دستور /report-issue بازخورد ارسال کند.
| فیلد | توضیحات |
|---|---|
| Feedback Endpoint URL | آدرس اینترنت که دریافت کننده ارسالهای بازخورد به صورت درخواست HTTP POST با بدنه JSON است. |
| Feedback API Key | یک توکن همراه (bearer token) که در هدر Authorization هر درخواست بازخورد ارسال میشود. اگر نقطه پایانی شما نیازی به احراز هویت ندارد، این فیلد را خالی بگذارید. |
محموله JSON مورد انتظار (Expected JSON Payload)
نقطه پایانی بازخورد شما باید یک بدنه JSON با حداقل فیلدهای زیر را بپذیرد:
{
"message_id": "msg_abc123",
"conversation_id": "conv_xyz789",
"feedback_text": "The answer was incorrect about pricing.",
"triage_category": "factual_error"
}
بسته به زمینه مکالمه، ممکن است فیلدهای دیگری نیز در محموله وجود داشته باشند.
مقادیر triage_category
لایه طبقهبندی هوش مصنوعی (AI triage layer) قبل از ارسال محموله، یکی از مقادیر زیر را به triage_category اختصاص میدهد:
| مقدار | معنی |
|---|---|
factual_error | دستیار اطلاعات واقعی اشتباهی ارائه داده است. |
unhelpful_answer | پاسخ از نظر فنی درست بوده اما مفید نبوده است. |
inappropriate_content | پاسخ حاوی محتوایی بوده که نباید به کاربران نمایش داده شود. |
other | بازخورد با هیچ دستهبندی شناختهشدهای مطابقت ندارد. |
احراز هویت (Authentication)
ئەگەر کۆتایی پۆنتەکەت پێویستی بە ڕێگەپێدان (authentication) هەبێت، فیلدی Feedback API Key دەربکەوێت بە bearer tokenی خۆت. ئەژمارەکە دەنێرێت:
Authorization: Bearer <your-api-key>
ئەگەر فیلدی Feedback API Key خاوەنی بێت، هیچ سەردانی Authorization headerێک نێردراوە.
دەستکەوتنی کۆکردنەوەی فیدبیک (Disabling Feedback Collection)
هەردوو فیلدی Feedback Endpoint URL و Feedback API Key بە خاڵ ڕابنرێن. دۆشی پاشەکەوت (thumbs-down button) و واچووری فیدبیک بۆ بەکارهێنەران دەمێننەوە، بەڵام داواکارییەکان بۆ هیچ خزمانی دەرەکییەک نەنێردرێت.
Brave Search API Key
شێوەزادا لەناو تابلۆی Advanced (ناوەندی پێشکەوتوو)، فیلدی Brave Search API Key دەگونجێنێت بە توانای گەڕان لە ئینتەرنێت (Internet Search) یاری بکات.
| فیلد | وەسفکردن |
|---|---|
| Brave Search API Key | کلێی API (API key) یەکێکە لە داشبۆردار دزڤەرەکانی Brave Search. پێویستە بۆ چالاککردنی گەڕان لە ئینتەرنێت لە یارمەتیدەرەکەدا. |
ناوەکانی فیلد لینکێکی کارپێکراو بۆ لاگینی (sign-up) APIی Brave Search دەگرێتەوە. بۆ ئەوەی گەڕان لە ئینتەرنێت بێت، بە خاڵ ڕابنرێن.
بۆ زیاتر زانیارییەکانی بەکارهێنەر، سەردانی Internet Search بکە.
Feature Flags (پلانکەکانی تایبەتمەندی)
وەک پێشتر لە v1.9.0دا پێشکەش کرا، تابلۆی Settings → Feature Flags پۆڵەکان بۆ ئەو کارانەی کە ئاسایی نین، دەگرێتەوە. هەر پلەیە یان چالاک دەکەیت یان نادەکریت بە شێوەیەکی گشتی لەسەر هەموو شوێنێک؛ لە ئێستادا هیچ ڕێگای تایبەت بۆ هەر شوێنێک نییە کە ئەمە بگۆڕێت.
دەستگەیشتن بە Feature Flags
- لە ئامێر ADMINISTRATORی WordPress، بچۆ بۆ Gratis AI Agent → Settings.
- تابلۆی Feature Flags بکە بەسەردا.
Feature Flags ی کۆنترۆڵی دەستگەیشتن (Access Control Flags)
| پرچم | پیشفرض | توضیحات |
|---|---|---|
| محدود کردن به مدیران | خاموش (Off) | وقتی فعال شود، فقط کاربرانی که نقش administrator دارند میتوانند پنل چت عامل هوش مصنوعی را باز کنند. سایر کاربران پیام "با مدیر خود تماس بگیرید" را خواهند دید. |
| محدود کردن به مدیران شبکه | خاموش (Off) | در یک شبکه چند سایت، وقتی این گزینه فعال باشد، فقط سوپر ادمینها میتوانند از عامل استفاده کنند. مدیران هر سایت به صورت جداگانه مسدود میشوند. اگر هر دو گزینه فعال باشند، این تنظیم اولویت دارد و بر "محدود کردن به مدیران" غلبه میکند. |
| اجازه دسترسی مشترکین | خاموش (Off) | وقتی فعال شود، کاربران با نقش subscriber میتوانند از رابط چت استفاده کنند اما محدود به قابلیتهای فقط خواندنی هستند (نمیتوانند پست ایجاد یا تنظیمات را تغییر دهند). |
| غیرفعال کردن برای غیرعضوها | خاموش (Off) | این گزینه با وضعیت عضویت Ultimate Multisite کار میکند. وقتی فعال شود، چت برای سایتهایی که عضویت فعالی ندارند مخفی میشود. |
پرچمهای برندینگ (Branding Flags)
| پرچم | پیشفرض | توضیحات |
|---|---|---|
| پنهان کردن فوتر "Powered by Gratis AI Agent" | خاموش (Off) | این خط مربوط به نام تجاری که در پایین ویجت چت نمایش داده میشود را حذف میکند. برای استقرار با برند شخصی توصیه میشود. |
| نام عامل سفارشی | (خالی) | برچسب پیشفرض "Gratis AI Agent" در هدر چت و منوی ادمین با نام محصول خود جایگزین میشود. اگر خالی بگذارید، از مقدار پیشفرض استفاده کنید. |
| پنهان کردن انتخاب عامل (Agent Picker) | خاموش (Off) | وقتی فعال شود، کاربران نمیتوانند بین پنج عامل داخلی جابجا شوند. عامل فعلی به تنظیمات → عمومی در بخش Settings → General که به عنوان پیشفرض تنظیم شده است، ثابت میماند. |
| استفاده از آیکون سایت به عنوان آواتار چت | خاموش (Off) | آیکون هوش مصنوعی پیشفرض در هدر ویجت چت با آیکون سایت وردپرس جایگزین میشود (این تنظیم در Appearance → Customize → Site Identity قرار دارد). |
اعمال تغییرات
بعد از تغییر هر پرچمی، روی Save Settings کلیک کنید. تغییرات بلافاصله اعمال میشوند — نیازی به پاک کردن کش یا فعالسازی مجدد پلاگین نیست.