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

RAGFlow موتور RAG سازمانی با استراتزی‌های عمیق سند است. مدل‌ها از User settings → Model providers → OpenAI-API-Compatible اضافه می‌شوند: این스턴س با Base URL و کلید، و مدل سفارشی با نام دقیق و سوئیچ Tool calling.

پیش‌نیازها

  • RAGFlow اجراشده.
  • کلید API مایندبیس (گام صفر پایین).

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

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

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

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

مرحله اول: پروایدر

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

آواتار بالا-راست ← User settings ← Model providers ← لیست «Available models» ← OpenAI-API-Compatible → ساخت این스턴س.

# UI-only:
Base URL : https://api.mindbase.ir/v1
API Key  : mb_xxxxxxxxxxxxxxxxxxxxxxxx
Model    : MindBase (Tool calling: on)

مرحله دوم: Base URL و کلید

در کارت: Instance name (MindBase)، API Key = mb_…، Base URL = https://api.mindbase.ir/v1 (نام فیلد در UI فعلی Base URL است نه api_base).

مدل و تایید

Models → Add custom model: Model name = MindBase، Model type، Max context length، سوئیچ Tool calling؛ Confirm، سپس Verify/Verify all models و Save. پیش‌فرض‌ها را با Set default models ست کنید.

نکات مهم

  • برچسب: نام فیلد Base URL است؛ api_base در بک‌اند.
  • Tool calling: روشن کنید اگر مدل پشتیبانی می‌کند — مدل‌های مایندبیس tools استاندارد دارند.
  • استریم: کلاینت داخلی مدیریت می‌کند؛ پرچم کاربری ندارد.

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

  • Verify رد شد: پیشوند /v1 و key mb_.
  • مدل نیست: Model name دقیق API.
  • جواب طولانی: Max context length مدل را بزرگ ست کنید.

جمع‌بندی

RAGFlow با OpenAI-API-Compatible — Base URL، کلید mb_، مدل MindBase با Tool calling — موتور RAG سازمانی روی مایندبیس می‌نشیند.

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

OpenAI-API-Compatible؟

همان سازگار-OpenAI؛ هر سرویس OpenAI-style با آن ثبت می‌شود.

مدل‌های GLM؟

Add custom model جدید با نام دقیق؛ Tool calling را روشن بگذارید.

پیش‌فرض

Set default models برای LLM/Embedding.