آموزش اتصال 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. هر دو از سایت مایندبیس قابل دریافت هستند:

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

مرحله اول: باز کردن config.yaml

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

کانفیگ جدید 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 و انتخاب مدل

  1. فایل را ذخیره کنید؛ Continue تغییرات را رصد می‌کند، اما برای اطمینان از سلکتور کانفیگ Reload config بزنید.
  2. در پنل چت، از انتخابگر مدل، MindBase را انتخاب کنید.
  3. یک درخواست فارسی بدهید — مثلاً «این فایل را بازبینی کن و باگ‌ها را بگو».

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

  • مدل در لیست چت نیست: اول فایل را ذخیره و 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 برای کارهای سنگین.