پرش به مطلب اصلی

اتصال Cherry Studio به چابکان

Cherry Studio رابط دسکتاپ برای کار با مدل‌ها و دستیارهای AI است. برای چابکان، یک provider سفارشی سازگار با OpenAI تعریف کنید.

آماده‌سازی و نصب​

کلید فعال، اعتبار مصرف و Model ID را طبق آماده‌سازی چابکان دریافت کنید. برنامه را از لینک دانلود یا Releases در مخزن رسمی برای سیستم‌عامل خود نصب کنید.

افزودن provider​

  1. تنظیمات را باز و بخش Model Provider / Model Service را انتخاب کنید.
  2. افزودن provider سفارشی را بزنید و نام Chabokan AI را وارد کنید.
  3. نوع اتصال را OpenAI یا گزینهٔ سازگار با Chat Completions قرار دهید.
  4. کلید سرویس AI چابکان را در فیلد API Key وارد کنید.
  5. آدرس API را با توجه به قالب بخش بعد تعیین کنید.
  6. از مدیریت مدل‌ها، مدل‌ها را دریافت و به فهرست اضافه کنید؛ اگر فهرست دریافت نشد، Model ID دقیق پنل را دستی اضافه کنید.
  7. provider را فعال و آزمون اتصال را اجرا کنید.

فرایند افزودن، مدیریت مدل و فعال‌کردن provider در راهنمای رسمی provider سفارشی آمده است. کلید مدیریت hub یا نام نمایشی مدل جایگزین کلید AI و Model ID نیست.

آدرس API و مسیر نهایی​

Cherry Studio می‌تواند بخش باقی‌ماندهٔ مسیر را خودکار اضافه کند. برای مسیر استاندارد، از آدرس زیر استفاده کنید:

https://ai.chabokan.net

اگر از حالت آدرس پایه با اسلش پایانی استفاده می‌کنید:

https://ai.chabokan.net/v1/

طبق راهنمای رسمی تنظیمات provider، آدرس معمولی مسیر /v1/chat/completions را دریافت می‌کند؛ آدرس با / پایانی فقط chat/completions را دریافت می‌کند. مقصد هر دو شکل بالا باید این باشد:

https://ai.chabokan.net/v1/chat/completions

در نسخه‌ای که مسیر درخواست را نشان می‌دهد، آن را بررسی کنید؛ خطای /v1/v1/ یا تکرار chat/completions معمولاً از تنظیم آدرس است. برای این راهنما نوع اتصال Chat Completions را انتخاب کنید.

آزمون گفت‌وگو​

یک گفت‌وگوی جدید باز کنید، provider چابکان و مدل اضافه‌شده را انتخاب کنید و پیام کوتاهی بفرستید. نتیجه و مصرف را در لاگ درخواست‌های چابکان بررسی کنید.

اگر آزمون اتصال موفق نیست، مدل انتخاب‌شده برای آزمون، کلید و مسیر نهایی را بررسی کنید. مدل اضافه‌شده اما provider غیرفعال، ممکن است در انتخاب‌گر گفت‌وگو ظاهر نشود.

امکاناتی مثل ابزارخوانی، تصویر، جست‌وجو و پایگاه دانش به قابلیت مدل و تنظیمات جداگانهٔ برنامه وابسته‌اند. اگر بخش دیگری مدل embedding می‌خواهد، صرف اتصال یک مدل چت کافی نیست. برای شروع، فقط گفت‌وگوی متنی را آزمایش کنید و سپس قابلیت بعدی را جدا اضافه کنید.

برای خطای 401، اعتبار ناکافی یا مدل نامعتبر، عیب‌یابی AI را ببینید.