آموزش اتصال API هوش مصنوعی Mindbase به Continue.dev
Continue محبوبترین افزونه متنباز دستیار AI برای VS Code (و JetBrains) است که برخلاف دستیارهای بسته، مدلهایش را شما انتخاب میکنید: از فایل کانفیگ config.yaml. برای همین یکی از بهترین مسیرها برای استفاده از مدلهای مایندبیس داخل ادیتور است — با تعریف یک مدل از نوع openai و آدرس apiBase مایندبیس، همان مدل در چت، ویرایش و اعمال تغییرات (Apply) در دسترس میشود.
پیشنیازها
- افزونه Continue نصبشده در VS Code (از بازارچه افزونهها) یا JetBrains.
- کلید API مایندبیس (گام صفر پایین).
گام صفر: دریافت API Key و Base URL از مایندبیس
قبل از هر چیز به دو مقدار نیاز دارید: کلید API و Base URL. هر دو از سایت مایندبیس قابل دریافت هستند:
- وارد حساب کاربری خود در mindbase.ir شوید (ثبتنام رایگان است).
- از منوی پروفایل، بخش «کلیدهای API» را باز کنید.
- روی «+ کلید جدید» بزنید و یک نام دلخواه بدهید؛ مثلاً
Continue. - مقدار کلید را کپی کنید — این کلید با پیشوند
mb_شروع میشود. - Base URL نیز در همین صفحه نمایش داده میشود:
https://api.mindbase.ir/v1
مرحله اول: باز کردن config.yaml
کانفیگ جدید Continue فایل YAML است و در این مسیر زندگی میکند:
- ویندوز:
%USERPROFILE%\.continue\config.yaml - مک/لینوکس:
~/.continue/config.yaml
از خود VS Code هم میتوانید بازش کنید: آیکون Continue را در نوار کناری بزنید و از سلکتور کانفیگ (پایین پنل) گزینه Configure را انتخاب کنید.
مرحله دوم: تعریف مدل MindBase
این بلوک را به بخش models فایل اضافه کنید:
name: MindBase Assistant
version: 0.0.1
schema: v1
models:
- name: MindBase
provider: openai
model: MindBase
apiBase: https://api.mindbase.ir/v1
apiKey: mb_xxxxxxxxxxxxxxxxxxxxxxxx
roles:
- chat
- edit
- apply
نکات این فایل:
provider: openaiیعنی «کلاینت باز-سازگار»؛ Continue درخواستها را بهapiBaseشما میفرستد و مسیر/chat/completionsرا خودش میچسباند — برای همینapiBaseباید با/v1تمام شود.modelباید شناسه دقیق مدل مایندبیس باشد:MindBase. برای مدلهای دیگر همین بلوک را با شناسههای صفحه مدلها تکرار کنید (مثلاًGLM-5.3-Max).rolesتعیین میکند مدل در کجاها استفاده شود:chatبرای چت،editبرای ویرایش درونخطی وapplyبرای اعمال پیشنهادها. اگر مدل دیگری را فقط برای چت میخواهید، همانroles: [chat]بماند.
اگر میخواهید برای ایندکسسازی @Codebase هم از مایندبیس استفاده کنید، یک مدل دیگر با roles: [embed] اضافه کنید — مایندبیس اندپوینت Embeddings استاندارد دارد:
- name: MindBase Embed
provider: openai
model: MindBase
apiBase: https://api.mindbase.ir/v1
apiKey: mb_xxxxxxxxxxxxxxxxxxxxxxxx
roles:
- embed
مرحله سوم: Reload و انتخاب مدل
- فایل را ذخیره کنید؛ Continue تغییرات را رصد میکند، اما برای اطمینان از سلکتور کانفیگ Reload config بزنید.
- در پنل چت، از انتخابگر مدل،
MindBaseرا انتخاب کنید. - یک درخواست فارسی بدهید — مثلاً «این فایل را بازبینی کن و باگها را بگو».
رفع مشکلات رایج
- مدل در لیست چت نیست: اول فایل را ذخیره و Reload config کنید؛ بعد ساختار YAML (تودرتوی models و تیرهها) را چک کنید.
- خطای ۴۰۴: apiBase بدون
/v1است؛ آدرس کاملhttps://api.mindbase.ir/v1بدهید. - خطای ۴۰۱: کلید اشتباه است؛ کلید
mb_را دوباره از پروفایل مایندبیس کپی کنید. برای امنیت بیشتر میتوانید کلید را از متغیر محیطی هم بخوانید و در فایل فقط ارجاع بدهید. - کیفیت تکمیل خودکار (Tab): نقش autocomplete در مسیر openai روی
/chat/completionsاجرا میشود (نه فرمت FIM)؛ کار میکند اما کیفیتش پایینتر از مدلهای مخصوص تکمیل است. برای شروع، نقش autocomplete را به مدل چت ندهید و از مدل پیشفرض Tab استفاده کنید.
جمعبندی
Continue با یک بلوک پنجخطی YAML به مایندبیس وصل میشود: provider از نوع openai، شناسه مدل MindBase، apiBase با /v1، کلید mb_ و نقشهای دلخواه. بعد از آن چت، ویرایش و اعمال تغییرات — و حتی جستجوی معنایی کد با Embeddings — همه روی مدلهای مایندبیس اجرا میشود.
سوالات متداول
فایل کانفیگ قدیمی config.json چه میشود؟
اگر هر دو فایل موجود باشند، Continue فایل config.yaml را ترجیح میدهد؛ کانفیگ JSON قدیمی را میتوانید طبق راهنمای مهاجرت رسمی به YAML ببرید.
چرا provider را ollama یا مقدار openai-compatible نمیگذاریم؟
در Continue چنین Providerای به نام openai-compatible وجود ندارد؛ راه رسمی، provider: openai همراه با apiBase است. اگر مقدار ناشناخته بدهید، Continue مدل را بیصدا نادیده میگیرد — تعجب نکنید، همین را اصلاح کنید.
آیا حالت Agent (ایجنت) هم با مدل مایندبیس کار میکند؟
بله؛ مدل MindBase فراخوانی ابزار (Tool Calling) استاندارد را پشتیبانی میکند و برای حالت ایجنت Continue مناسب است.
میتوانم چند مدل مایندبیس را همزمان تعریف کنم؟
بله؛ برای هر شناسه یک بلوک جدا بسازید و نقشها را بینشان تقسیم کنید — مثلاً MindBase برای چت و GLM-5.3-Max برای کارهای سنگین.