عملية التقديم
لربط Ace Data Cloud في AnythingLLM، انتقل أولًا إلى لوحة تحكم Ace Data Cloud، واحصل على API Token الخاص بك، واحتفظ به للاستخدام لاحقًا.
إذا لم تكن قد سجلت الدخول أو أنشأت حسابًا بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك إلى التسجيل وتسجيل الدخول، وبعد التسجيل وتسجيل الدخول ستعود تلقائيًا إلى الصفحة الحالية.
عند التقديم لأول مرة، سيتم منحك رصيد مجاني، ويمكنك تجربة خدمات نماذج Ace Data Cloud مجانًا.
تنزيل AnythingLLM
للاستخدام الشخصي، يمكنك تنزيل نسخة سطح المكتب، حيث تعمل قاعدة المتجهات (LanceDB) محليًا، ويكون البحث في المستندات دون اتصال بالكامل، ولا يتطلب الاتصال بالإنترنت إلا عند استدعاء النموذج؛ ولحالات الفرق متعددة المستخدمين، استخدم نشر Docker.إعداد نموذج المحادثة
شغّل AnythingLLM، وانتقل إلى Settings → LLM Preference، واختر OpenAI (Generic) كمزوّد Provider (لا تختر OpenAI العادي، لأنه يشير بشكل ثابت إلىapi.openai.com ولا يتيح Base URL مخصصًا). راجع الوثائق الرسمية في OpenAI (Generic) LLM Provider.
تعتمد قدرات النموذج والحد الأقصى للسياق على دليل النموذج الحالي.انتبه إلى قواعد مسار Base URL:
إعداد نموذج Embedding
جوهر AnythingLLM هو RAG، ويحتاج إلى نموذج تضمين لتحويل المستندات إلى متجهات. إن Embedding Preference وLLM Preference فيه مجموعتا إعدادات مستقلتان عن بعضهما—راجع نظرة عامة على إعدادات Embedder. يعمل AnythingLLM Embedder（Built-in / Native） المدمج مباشرةً محليًا، وهو جاهز للاستخدام دون إعدادات، وهو الخيار الافتراضي والموصى به: انتقل إلى Settings → Embedding Preference، واترك Provider على AnythingLLM Embedder الافتراضي، ولا حاجة لملء أي مفاتيح. سيُكمل تحويل المستندات إلى متجهات محليًا، ويتم تخزين كل من النص الأصلي والمتجهات في LanceDB محليًا، دون رفعها إلى السحابة.يتم ربط خيارات Embedder في AnythingLLM (السحابية: OpenAI / Azure OpenAI / Cohere؛ المحلية: Built-in وLM Studio وLocalAI وOllama) وفقًا للصيغة الثابتة الخاصة بكل منها. من بينها، يشير تضمين OpenAI السحابي بشكل ثابت إلىapi.openai.comولا يدعم Base URL مخصصًا؛ وإذا كنت ترغب في استخدام نقطة نهاية مخصصة، فيمكنك استخدام Embedder Generic OpenAI (والذي يحتوي أيضًا على حقل Base URL ويمكن توجيهه إلىtext-embedding-3-largeالخاص بـ Ace Data Cloud) أو Embedder LocalAI المحلي. يستخدم نموذج المحادثة في هذا المقال Ace Data Cloud، بينما يستخدم التضمين Embedder المحلي المدمج في AnythingLLM، ولا يؤثر أي منهما في الآخر.
اختيار النموذج
سيستمر تحديث دليل النماذج. أعطِ الأولوية لقائمة النماذج التي يحملها العميل تلقائيًا؛ وعند الحاجة إلى الإدخال اليدوي، اطلب أولًاGET https://api.acedata.cloud/v1/models للحصول على معرّف النموذج الحالي، ثم اختر وفقًا لقدرات السياق والصور واستدعاء الأدوات التي يدعمها العميل.
التحقق من الربط
إذا لم تكن متأكدًا مما إذا كانت المشكلة في AnythingLLM أو في الشبكة، فيمكنك أولًا استخدام curl للتحقق من نقطة النهاية مباشرةً (استبدل{token} بـ Token الخاص بك):
chat.completion متوافق مع OpenAI يعني أن Token ونقطة النهاية جاهزان؛ وإذا أُعيد HTTP 403 used_up فهذا يعني أن Token صالح لكن الرصيد غير كافٍ، ويمكنك إعادة الشحن من لوحة التحكم.
متقدم: Workspace والمحادثة مع المستندات
بعد إنشاء Workspace جديد، ارفع مستندات مثل PDF / Word / Markdown، وسيقوم AnythingLLM بتقسيمها حسب الفقرات، واستخدام Embedder المحلي لإنشاء المتجهات وتخزينها في LanceDB المحلي. أثناء المحادثة، سيسترجع أولًا المقاطع ذات الصلة، ثم يرسل المقاطع وسؤالك معًا إلى نموذج المحادثة (أي Ace Data Cloud) للإجابة، ويشير إلى مصادر الاقتباسات أسفل الإجابة. يمكن التبديل بين وضعي Query (الإجابة بناءً على المستندات فقط) وChat (دمج المعرفة العامة) في أعلى كل Workspace، ويوصى باستخدام وضع Query في السيناريوهات الجادة لتجنب الهلوسة. عند النشر باستخدام Docker، يمكن استخدام متغيرات البيئة مثلGENERIC_OPEN_AI_BASE_PATH وGENERIC_OPEN_AI_API_KEY وGENERIC_OPEN_AI_MODEL_PREF لإعداد نفس ربط نموذج المحادثة مسبقًا، وتمكين وضع تعدد المستخدمين.
الأسئلة الشائعة
ظهور 404 / connection fail
عادةً ما يكون Base URL مكتوبًا على شكل.../openai/v1 أو أن /v1 مفقود. غيّره إلى https://api.acedata.cloud/v1.
تعذّر إجراء محادثة بعد رفع المستند
يرجى التأكد من اختيار Embedder قابل للاستخدام في Settings → Embedding Preference (يمكن تشغيل AnythingLLM Embedder الافتراضي محليًا، ولا يحتاج إلى إعدادات إضافية)، ثم أعد رفع المستند لإنشاء المتجهات.ظهور 401 Unauthorized
يرجى التأكد من أن ما تم لصقه في API Key هو Token الخاص بـ Ace Data Cloud (دون بادئةBearer ودون مسافات إضافية)، وأن رصيد التطبيق التابع له كافٍ.