عملية التقديم
لتوصيل Ace Data Cloud في Open WebUI، انتقل أولًا إلى وحدة تحكم Ace Data Cloud، واحصل على API Token الخاص بك، واحتفظ به للاستخدام لاحقًا.
إذا لم تكن قد سجلت الدخول أو أنشأت حسابًا بعد، فسيتم إعادة توجيهك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك إلى التسجيل وتسجيل الدخول، وبعد التسجيل وتسجيل الدخول ستعود تلقائيًا إلى الصفحة الحالية.
عند التقديم لأول مرة، سيتم منحك رصيد مجاني، ويمكنك تجربة خدمات نماذج Ace Data Cloud مجانًا.
نشر وإعداد Ace Data Cloud
يتصل Open WebUI بنقطة نهاية متوافقة مع OpenAI عبر متغيرات البيئة، ويمكن نشره باستخدام أمر Docker واحد (استبدل{token} بالـ Token الخاص بك):
افتح
http://IPالخادم_الخاص_بك:3000، وسيصبح أول حساب يتم تسجيله مسؤولًا تلقائيًا. انتبه إلى قواعد مسار Base URL:
بعد تسجيل الدخول، انتقل إلى Admin Panel → Settings → Connections وانقر على «Verify Connection» للتحقق؛ وفي Settings → Models يمكنك تصفية النماذج المستخدمة كثيرًا وتثبيتها.
بالإضافة إلى استخدام متغيرات البيئة، يدعم Open WebUI أيضًا إضافة اتصال مباشرة من الواجهة: انتقل إلى Admin Settings → Connections، وانقر على ➕ وأدخل URL (https://api.acedata.cloud/v1) وAPI Key، وسيستدعي Open WebUI تلقائيًا/modelsلجلب قائمة النماذج. راجع الوثائق الرسمية Starting With OpenAI-Compatible Servers للتفاصيل.
يُستخدمMODEL_IDفقط لعرض allow list اختياري؛ وعند تركه فارغًا، ستُعرض جميع النماذج التي يعيدها/models.
اختيار نموذج
سيستمر تحديث دليل النماذج. استخدم قائمة النماذج التي يحمّلها العميل تلقائيًا بشكلٍ أساسي؛ وعند الحاجة إلى الإدخال اليدوي، اطلب أولًاGET https://api.acedata.cloud/v1/models للحصول على معرفات النماذج الحالية، ثم اختر وفقًا للسياق والصور وقدرات استدعاء الأدوات التي يدعمها العميل.
التحقق من التكامل
إذا لم تكن متأكدًا مما إذا كانت المشكلة في Open WebUI أو في الشبكة، يمكنك أولًا استخدام curl للتحقق مباشرة من نقطة النهاية (استبدل{token} بالـ Token الخاص بك):
chat.completion متوافقًا مع OpenAI، فهذا يعني أن الـ Token ونقطة النهاية جاهزان؛ وإذا أعاد HTTP 403 used_up، فهذا يعني أن الـ Token صالح لكن الرصيد غير كافٍ، ويمكنك إعادة الشحن من وحدة التحكم.
متقدم: قاعدة المعرفة وتعدد المستخدمين
تستخدم قاعدة المعرفة (RAG) في Open WebUI افتراضيًا ChromaDB لتخزين المتجهات، ويمكن تعيين نموذج التضمين إلىtext-embedding-3-large (عبر Ace Data Cloud)، ولا تُخزّن النصوص الأصلية للمستندات إلا على خادمك، ولا تُرسل إلى النموذج سوى المقاطع المطابقة. في Admin Panel → Users يمكنك إدارة أدوار المستخدمين (Pending / User / Admin)؛ ويوصى بتعيين «Default User Role» إلى pending، بحيث يحتاج المستخدمون الجدد إلى مراجعة قبل أن يتمكنوا من الاستخدام، لتجنب تسجيل الغرباء واستهلاك الرصيد بشكل عشوائي. إذا كنت تستخدم وكيل nginx العكسي، فأضف proxy_buffering off; وclient_max_body_size 100M;.
الأسئلة الشائعة
ظهور Connection error / 404
عادةً ما يكونOPENAI_API_BASE_URL مكتوبًا كـ .../openai/v1 أو يفتقد إلى /v1۔ غيّره إلى https://api.acedata.cloud/v1.
تعذر إجراء محادثة بعد رفع مستند
في إعدادات RAG ضمن Admin Panel، اختر نموذج التضمينtext-embedding-3-large (موفر OpenAI).
فقدان البيانات بعد إعادة تشغيل الحاوية
يجب تحميل وحدة بيانات عند التشغيل:-v open-webui:/app/backend/data.