آموزش اتصال API هوش مصنوعی Mindbase به FastGPT
FastGPT پلتفرم پایگاهدانشی و جریانسازی سبکتر از Dify است. مدلها با «کانال» اضافه میشوند: Protocol Type روی OpenAI، آدرس Base url و کلید. مستندات انگلیسی برچسبها را از i18n ریپو تأیید میکند (اسکرینشات رسمی هنوز چینی است).
پیشنیازها
- FastGPT خودمیزبان.
- کلید API مایندبیس (گام صفر پایین).
گام صفر: دریافت API Key و Base URL از مایندبیس
قبل از هر چیز به دو مقدار نیاز دارید: کلید API و Base URL. هر دو از سایت مایندبیس قابل دریافت هستند:
- وارد حساب کاربری خود در mindbase.ir شوید (ثبتنام رایگان است).
- از منوی پروفایل، بخش «کلیدهای API» را باز کنید.
- روی «+ کلید جدید» بزنید و یک نام دلخواه بدهید؛ مثلاً
FastGPTتا بعداً بدانید این کلید مال کدام ابزار است. - مقدار کلید را کپی کنید — این کلید با پیشوند
mb_شروع میشود. - Base URL نیز در همین صفحه نمایش داده میشود:
https://api.mindbase.ir/v1
در ادامه همین دو مقدار را در تنظیمات FastGPT جایگذاری میکنیم. اگر خواستید مدل دیگری هم امتحان کنید، لیست کامل مدلها (GLM-5.3 در سه سطح توان، مدل سبک سریع و Qwen3.8) در صفحه مدلهای مایندبیس قابل مشاهده است.
مرحله اول: پنل مدلها
ادمین ریشه ← Admin → System Resources → System Models ← تب «Model provider» (کانالها) ← Add Channel.
# واردات مدل:
{"scope":"system","type":"llm","provider":"Other","model":"MindBase","name":"MindBase",
"isActive":true,"config":{"maxContext":8192,"maxResponse":2048,"vision":false,"toolChoice":true}}
مرحله دوم: کانال OpenAI
در دیالوگ Channel configuration: Protocol Type = OpenAI، Base url = https://api.mindbase.ir/v1، API key = mb_…؛ مدلها را با Add Model و در صورت نیاز Model Mapping ثبت و New (ذخیره) بزنید.
مرحله سوم: تست
با Model Test ← Batch test، کانال را امتحان کنید. کاربران تیمی مسیر Account → Model provider را میروند.
نکات مهم
- برچسب: فیلد آدرس «Base url» است؛ i18n en ریپو مرجع است چون اسکرین رسمی انگلیسی منتشر نشده.
- پروتکل: برای کانال OpenAI انتخاب endpoint خودکار/OPENAI/OPENAI_STREAM.
- قابلیت: vision/toolChoice به ازای مدل در Model Configuration.
رفع مشکلات رایج
- ۴۰۴ تست: Base url با /v1.
- ۴۰۱: کلید mb_ در همان کانال.
- مدل نیست: Add Model + Mapping.
جمعبندی
FastGPT با کانال OpenAI (Base url + کلید mb_ + مدل MindBase) روی مایندبیس؛ پلتفرم دانشمحور سبک، حالا سرویس ایرانی دارد.
سوالات متداول
فقط OpenAI؟
Most providers OpenAI-protocol دارند؛ برای مایندبیس همین.
مدل Mapping؟
JSON: نام درخواستی→نام واقعی اپاستریم.
تست گروهی؟
Model Test → Batch test N models.