ادموزش اتصال API هوش مصنوعی Mindbase به Khoj

Khoj دستیار شخصی جستجو روی یادداشت‌ها و اسناد شماست. در نسخه خودمیزبان، سرویس مدل از ادمن سرور ساخته می‌شود: AI Model API با «Api base url» — همان هوک رسمی برای پروکسی‌های OpenAI-compatible طبق مستندات LiteLLM خودشان.

پیش‌نیازها

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

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

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

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

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

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

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

ادمن localhost:42110/server/admin/ (KHOJ_ADMIN_EMAIL/PASSWORD) ← AI Model API.

# UI/DB — ادمن:
AiModelApi   : { name: "MindBase", api_key: "mb_...", api_base_url: "https://api.mindbase.ir/v1" }
ChatModelOptions: { chat_model: "MindBase", model_type: "openai" }

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

Name = MindBase، Api key = mb_…، Api base url = https://api.mindbase.ir/v1. سپس Chat Model Options: Chat model = MindBase، Model type = OpenAI، در صورت نیاز Vision enabled.

مرحله سوم: پیش‌فرض

Server Chat Settings ← Default ← مدل جدید. نسخه ابری app.khoj.dev فیلد base-url ندارد؛ این مسیر فقط سلف‌هاست.

نکات مهم

  • فقط سلف‌هاست: کلاد Khoj فیلد base-url کاربری ندارد.
  • Tokenizer: برای مدل OpenAI خالی بگذارید.
  • پرچم استریم: در این مسیر ندارد؛ رفتار کلاینت.

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

  • خطای سرویس: Api base url با /v1 و model_type openai.
  • ۴۰۱: Api key mb_.
  • پاسخ طولانی: chat model را با نام دقیق سرویس بگذارید.

جمع‌بندی

Khoj خودمیزبان با Api base url در ادمن — سرویس مدل‌هایش را به مایندبیس می‌دهد؛ جستجوی شخصی روی مدل ایرانی.

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

Api base url؟

فیلد رسمی برای «پروکسی OpenAI-compatible دیگر» — مستندات و admin.py مرجع‌اند.

Vision؟

پرچم Vision enabled برای مدل‌های تصویری سازگار.

مدل‌های GLM؟

AiModelApi جدید یا chat model با model_type openai.