آموزش اتصال API هوش مصنوعی Mindbase به AnythingLLM

AnythingLLM محبوب‌ترین اپ دسکتاپ/خودمیزبان RAG و چت با پایگاه‌دانشی است. پروایدر آماده‌اش برای سرویس‌های ایرانی Generic OpenAI است: Base URL (ریشه API)، کلید و نام مدل — در Settings → AI Providers.

پیش‌نیازها

  • AnythingLLM دسکتاپ یا نسخه Docker.
  • کلید API مایندبیس (گام صفر پایین).

گام صفر: دریافت API Key و Base URL از مایندبیس

قبل از هر چیز به دو مقدار نیاز دارید: کلید API و Base URL. هر دو از سایت مایندبیس قابل دریافت هستند:

  1. وارد حساب کاربری خود در mindbase.ir شوید (ثبت‌نام رایگان است).
  2. از منوی پروفایل، بخش «کلیدهای API» را باز کنید.
  3. روی «+ کلید جدید» بزنید و یک نام دلخواه بدهید؛ مثلاً AnythingLLM تا بعداً بدانید این کلید مال کدام ابزار است.
  4. مقدار کلید را کپی کنید — این کلید با پیشوند mb_ شروع می‌شود.
  5. Base URL نیز در همین صفحه نمایش داده می‌شود: https://api.mindbase.ir/v1
دریافت کلید API و Base URL از پنل کاربری مایندبیس

در ادامه همین دو مقدار را در تنظیمات AnythingLLM جای‌گذاری می‌کنیم. اگر خواستید مدل دیگری هم امتحان کنید، لیست کامل مدل‌ها (GLM-5.3 در سه سطح توان، مدل سبک سریع و Qwen3.8) در صفحه مدل‌های مایندبیس قابل مشاهده است.

مرحله اول: Generic OpenAI را انتخاب کنید

محیط واقعی AnythingLLM — آموزش تنظیم اتصال به مایندبیس

Settings (Instance Settings) ← AI Providers ← بخش LLM ← Generic OpenAI (زیرنویس: اتصال به هر سرویس OpenAI-compatible).

# فقط Docker — Desktop فایل env ویرایش نکند:
GENERIC_OPEN_AI_MODEL_TOKEN_LIMIT="8192"
GENERIC_OPEN_AI_MAX_TOKENS="4096"
GENERIC_OPENAI_STREAMING_DISABLED=1  # فقط اگر سرویس استریم نداشت

مرحله دوم: مقادیر مایندبیس

در فیلد Base URL آدرس ریشه با /v1 بدهید (https://api.mindbase.ir/v1 — نه مسیر کامل chat/completions)، کلید mb_ و در Selected Model نام دقیق MindBase. context/max در صورت نیاز؛ Save changes.

مرحله سوم: استفاده

در چت یا Workspace، مدل فعال می‌شود. برای نسخه Docker تنظیمات عمیق‌تر با env است (فقط Generic OpenAI را تحت تاثیر می‌گذارد).

نکات مهم

  • نام فیلد: برچسب رسمی «Base URL» است — اگر جایی «Base Path» دیدید مربوط به ابزار دیگر است.
  • مخاطب: مستندات Generic OpenAI را provider توسعه‌دهنده‌محور می‌نامد؛ برای تیم، مدل پیش‌فرض را ست کنید.
  • Embedding جداست: برای پایگاه‌دانشی، مدل امبدینگ مسیر خودش را دارد (OpenAI/Azure/…)؛ صفحه Generic OpenAI ندارد.

رفع مشکلات رایج

  • پاسخ نمی‌آید: Base URL باید با /v1 ختم شود.
  • ۴�۱: کلید mb_ در همان فرم LLM.
  • پاسخ طولانی: GENERIC_OPEN_AI_MAX_TOKENS را بالا ببرید (Docker).

جمع‌بندی

AnythingLLM با Generic OpenAI در سه فیلد — ریشه /v1، کلید mb_ و مدل MindBase — به مایندبیس وصل می‌شود؛ چت روی مدارک شما حالا روی مدل ایرانی اجرا می‌شود.

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

Generic OpenAI یا Local AI؟

برای سرویس راه دور ایرانی فقط Generic OpenAI؛ Local AI برای سرویس‌های محلی است.

استریم خاموش؟

متغیر GENERIC_OPENAI_STREAMING_DISABLED فقط روی همین provider اثر دارد — مایندبیس به آن نیازی ندارد.

مدل GLM؟

در Selected Model نام دقیق بگذارید؛ هر مدل سازگار-OpenAI می‌پذیرد.