راهنمای کاربری سامانه

۱. شروع کار

1. وارد پنل مدیریت شوید.
2. در صفحه «مجوز»، مجوز دریافت‌شده را بارگذاری کنید.
3. فقط صفحه‌های خریداری‌شده نمایش داده می‌شوند.
4. رمز پیش‌فرض مدیر را در اولین نصب تغییر دهید.

۲. بارگذاری سند

در «دانش و اتصال‌ها»، نوع فضای داده و روش بازیابی را انتخاب کنید و فایل‌های MD، TXT، PDF، Word یا PowerPoint را بارگذاری کنید.

۳. انتخاب روش جست‌وجو

• برداری: مناسب پرسش‌های معنایی.
• گراف: مناسب واژه‌ها و ارتباط‌های ساختاریافته.
• ترکیبی: ترکیب نتایج برداری و گراف؛ انتخاب پیشنهادی.

سندها با بخش‌های هم‌پوشان ذخیره می‌شوند تا جمله‌های مرزی ناقص نشوند.

۴. API و استریم

کلید API فقط یک‌بار نمایش داده می‌شود. آن را فقط در سرور یا Secret Manager نگه دارید.

• /integrations/v1/chat پاسخ JSON
• /integrations/v1/chat/stream پاسخ SSE
• /integrations/v1/mcp ابزارهای MCP

۵. ربات‌ها

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

۶. وب‌سایت و وردپرس

هنگام ورود هر کاربر به اتاق چت، backend سایت باید شناسه داخلی کاربر و اتاق را به مسیر /integrations/v1/embed/session بفرستد و embed_url پاسخ را داخل iframe قرار دهد. ترکیب یکسان کاربر/اتاق به همان تاریخچه متصل می‌شود و هر ورود یک توکن تازه با اعتبار حداکثر هفت روز می‌گیرد. کلید API باید در backend بماند و هرگز در HTML، JavaScript یا shortcode قرار نگیرد.

۷. محدودیت مصرف

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

۸. رفع مشکل

• صفحه دیده نمی‌شود: مجوز آن قابلیت را بررسی کنید.
• API خطای 401 می‌دهد: کلید را بررسی یا دوباره صادر کنید.
• Origin رد می‌شود: دامنه دقیق HTTPS را در فهرست مجاز ثبت کنید.
• سند پاسخ نمی‌دهد: فضای داده، روش بازیابی و کیفیت متن استخراج‌شده را بررسی کنید.