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

FastGPT پلتفرم پایگاه‌دانشی و جریان‌سازی سبک‌تر از Dify است. مدل‌ها با «کانال» اضافه می‌شوند: Protocol Type روی OpenAI، آدرس Base url و کلید. مستندات انگلیسی برچسب‌ها را از i18n ریپو تأیید می‌کند (اسکرین‌شات رسمی هنوز چینی است).

پیش‌نیازها

  • FastGPT خودمیزبان.
  • کلید API مایندبیس (گام صفر پایین).

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

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

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

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

مرحله اول: پنل مدل‌ها

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

ادمین ریشه ← 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.