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

OpenHands (همان OpenDevin سابق) ایجنت خودمختار اجراکننده کد با ۶۰هزار ستاره است. اتصال به سرویس‌های سازگار با OpenAI در پنل تنظیماتش سه فیلد بیشتر نمی‌خواهد: کلید، Base URL و نام مدل با پیشوند openai/ — چون زیرساخت مدل‌هایش LiteLLM است.

پیش‌نیازها

  • OpenHands اجراشده (Docker یا نسخه ابری).
  • کلید API مایندبیس (گام صفر پایین).

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

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

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

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

مرحله اول: تنظیمات LLM

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

چرخ‌دنده Settings ← تب LLM ← کلید «see advanced settings» را روشن کنید تا فیلدهای پیشرفته باز شوند.

# Settings > LLM (Advanced روشن)
Custom Model : openai/MindBase
Base URL     : https://api.mindbase.ir/v1
API Key      : mb_xxxxxxxxxxxxxxxxxxxxxxxx
# Save Changes

مرحله دوم: ثبت مایندبیس

سه مقدار را این‌طور پر کنید — نام مدل حتماً با پیشوند لیتل‌ام:

مرحله سوم: اجرا

Save Changes بزنید. حالا ایجنت با MindBase کار می‌کند و با دستور /model بین پروفایل‌های ذخیره‌شده (حداکثر ۱۰) سوییچ می‌کنید.

نکات مهم

  • پیشوند openai/: OpenHands با LiteLLM مدل‌ها را صدا می‌زند؛ فرمت openai/MindBase همان مسیر OpenAI-compatible را انتخاب می‌کند.
  • پنجره بافتار: ایجنت برای ابزارها به ~۲۲ تا ۳۲ هزار توکن نیاز دارد؛ MindBase با پنجره بزرگ، آن را دارد.
  • پروفایل‌ها: پروفایل‌های LLM ذخیره‌شده معتبرند؛ با /model جابه‌جا شوید.

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

  • خطای مدل در اجرا: پیشوند openai/ را در Custom Model چک کنید.
  • ۴۰۱: کلید در همان تب Advanced ذخیره شده؟
  • قطع ابزارها: پنجره بافتار مدل ≥۳۲k باشد (MindBase دارد).

جمع‌بندی

OpenHands با Advanced Settings و سه مقدار — Base URL، کلید mb_، مدل openai/MindBase — روی مایندبیس اجرا می‌شود؛ ایجنت اجراکننده کد حالا به سرویس ایرانی وصل است.

سوالات متداول

پیشوند openai/ لازم است؟

بله — LiteLLM با آن، پروتکل OpenAI را برای سرویس شما برمی‌گزینید؛ بدون پیشوند خطای مدل می‌گیرید.

مدل‌های دیگر مایندبیس؟

پروفایل جدید با openai/GLM-5.3-Max بسازید؛ همان Base URL کافی است.

حافظه/بافتار کم است؟

ایجنت‌ها به ~۳۲k توکن نیاز دارند؛ مدل‌های بزرگ‌مقیاس مایندبیس پاسخ‌گویند.