اتصال Open WebUI به چابکان

Open WebUI می‌تواند درگاه چابکان را به‌عنوان یک اتصال OpenAI-compatible استفاده کند. این روش برای ساخت یک رابط گفت‌وگوی داخلی و انتخاب مدل‌های مختلف مناسب است.

Open WebUI چیست؟

Open WebUI یک پلتفرم هوش مصنوعی self-hosted و مستقل از provider است که رابطی شبیه نرم‌افزارهای گفت‌وگوی AI در اختیار کاربران قرار می‌دهد. سازمان می‌تواند آن را روی زیرساخت خود اجرا کند، اتصال مدل‌ها را در پنل مدیریت بسازد و دسترسی کاربران به مدل‌های مجاز را کنترل کند.

این ابزار برای پورتال گفت‌وگوی داخلی شرکت، دستیار دانش سازمانی، آزمایش چند مدل و ارائه یک UI مشترک به اعضای تیم مناسب است. چابکان در این معماری نقش provider مدل را دارد و Open WebUI مدیریت رابط، نشست‌ها و کاربران را انجام می‌دهد. ویژگی‌هایی مانند RAG، ابزارها یا جست‌وجو نیز باید جداگانه در Open WebUI پیکربندی و از نظر سازگاری مدل آزمایش شوند.

۱. آماده‌سازی

این اطلاعات را از پنل چابکان بردارید:

فیلد Open WebUI	مقدار
URL	https://ai.chabokan.net/v1
API Key	کلید فعال با پیشوند sk-chbk-
Model IDs	شناسه‌های دقیق مدل‌های موردنیاز

برای محیط اشتراکی، یک کلید اختصاصی با نامی مانند open-webui-production، سقف ماهانه و تاریخ انقضا بسازید.

۲. افزودن اتصال از رابط کاربری

این کار به دسترسی Administrator در Open WebUI نیاز دارد.

1. وارد Open WebUI شوید.
2. به Settings → Admin → Connections بروید.
3. در بخش Manage OpenAI API Connections روی Add Connection بزنید.
4. در URL مقدار https://ai.chabokan.net/v1 را وارد کنید.
5. در API Key کلید چابکان را paste کنید.
6. روی Verify Connection بزنید.
7. در Model IDs (Filter) فقط مدل‌هایی را اضافه کنید که کاربران باید ببینند.
8. تنظیم را ذخیره و connection را فعال نگه دارید.

درگاه چابکان مسیر /models دارد؛ بنابراین مدل‌ها معمولاً خودکار شناسایی می‌شوند. Filter اجباری نیست، اما برای جلوگیری از شلوغی فهرست و کنترل هزینه توصیه می‌شود.

۳. تنظیم هنگام اجرای کانتینر

اگر Open WebUI را خودتان اجرا می‌کنید، اتصال اصلی را می‌توان با environment تعریف کرد:

OPENAI_API_BASE_URL=https://ai.chabokan.net/v1
OPENAI_API_KEY=sk-chbk-کلید-واقعی-شما

نام دقیق متغیرها و رفتار persistence ممکن است بین نسخه‌های Open WebUI تغییر کند؛ تنظیم پنل Admin را مرجع نهایی همان نسخه در نظر بگیرید. secret را در فایل Compose عمومی یا مخزن Git قرار ندهید.

۴. آزمون اتصال

1. یک مدل چابکان را از model selector انتخاب کنید.

2. پیام ساده زیر را بفرستید:

   فقط عبارت «اتصال برقرار است» را پاسخ بده.

3. streaming پاسخ را بررسی کنید.

4. در پنل چابکان، درخواست متناظر را در «گزارش درخواست‌ها» پیدا کنید.

5. اگر قصد استفاده از Tools دارید، یک ابزار کم‌خطر و فقط‌خواندنی را جداگانه آزمایش کنید.

۵. انتخاب مدل برای کارهای مختلف

استفاده	معیار مدل
گفت‌وگوی عمومی	مدل متنی با هزینه و سرعت مناسب
Tools و Functions	وجود tools در supported_parameters
تحلیل تصویر	پشتیبانی ورودی image در مشخصات مدل
متن طولانی یا RAG	context_length متناسب با اندازه ورودی

قابلیت‌های UI لزوماً به معنی پشتیبانی همه مدل‌ها نیست. برای نمونه، فعال‌کردن Tools در Open WebUI نمی‌تواند مدل فاقد tool calling را سازگار کند.

۶. نکات محیط اشتراکی

• کلید شخصی خود را در instance عمومی قرار ندهید؛ کلید سرویس مجزا بسازید.
• Model Filter را به مدل‌های تأییدشده و اقتصادی محدود کنید.
• دسترسی Admin را فقط به مدیران بدهید؛ کاربر عادی نباید API Key را ببیند.
• برای محیط‌های development و production کلیدهای جدا بسازید.
• سقف مصرف کلید را متناسب با تعداد کاربران قرار دهید و گزارش درخواست‌ها را دوره‌ای بررسی کنید.

۷. عیب‌یابی

مشکل	راه‌حل
Verify با 401 شکست می‌خورد	کلید، فاصله ابتدا/انتها و فعال‌بودن آن را بررسی کنید
Verify با 404 شکست می‌خورد	URL را به‌صورت https://ai.chabokan.net/v1 وارد کنید؛ /chat/completions را به آن نچسبانید
هیچ مدلی دیده نمی‌شود	Model ID را عیناً در Model IDs (Filter) اضافه کنید
مدل دیده می‌شود اما درخواست 404 است	شناسه مدل قدیمی یا اشتباه است؛ دوباره از پنل کپی کنید
گفت‌وگو کار می‌کند اما Tool نه	مدلی انتخاب کنید که tools را پشتیبانی کند
همه کاربران به یک سقف می‌رسند	کلید مشترک همان سقف مشترک را دارد؛ کلید یا instanceها را تفکیک کنید

منبع: راهنمای رسمی اتصال OpenAI-compatible در Open WebUI