آموزش اتصال 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. هر دو از سایت مایندبیس قابل دریافت هستند:
- وارد حساب کاربری خود در mindbase.ir شوید (ثبتنام رایگان است).
- از منوی پروفایل، بخش «کلیدهای API» را باز کنید.
- روی «+ کلید جدید» بزنید و یک نام دلخواه بدهید؛ مثلاً
RAGFlowتا بعداً بدانید این کلید مال کدام ابزار است. - مقدار کلید را کپی کنید — این کلید با پیشوند
mb_شروع میشود. - Base URL نیز در همین صفحه نمایش داده میشود:
https://api.mindbase.ir/v1
در ادامه همین دو مقدار را در تنظیمات RAGFlow جایگذاری میکنیم. اگر خواستید مدل دیگری هم امتحان کنید، لیست کامل مدلها (GLM-5.3 در سه سطح توان، مدل سبک سریع و Qwen3.8) در صفحه مدلهای مایندبیس قابل مشاهده است.
مرحله اول: پروایدر
آواتار بالا-راست ← 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.