الانتقال إلى المحتوى الرئيسي
LlamaIndex هو إطار عمل للبيانات لبناء خطوط أنابيب RAG والوكلاء ومحركات الاستعلام فوق بياناتك الخاصة. يعمل Venice كخلفية متوافقة مع OpenAI — وجّه عملاء LLM والتضمينات في OpenAILike إلى عنوان URL الأساسي لـ Venice واستمر في استخدام بقية واجهة LlamaIndex كالمعتاد.

المتطلبات المسبقة

الإعداد

ثبّت LlamaIndex مع تكاملات LLM والتضمينات المتوافقة مع OpenAI:
أضف مفتاح Venice API إلى البيئة:
احتفظ بمفاتيح API خارج نظام التحكم بالمصدر. فضّل استخدام متغيرات البيئة أو مدير أسرار في الإنتاج.

تهيئة Venice كنموذج LLM

يتحدث Venice بواجهة OpenAI Chat Completions API. استخدم OpenAILike مع عنوان URL الأساسي لـ Venice واضبط is_chat_model=True:
اضبط context_window ليطابق النموذج الذي تختاره — لا يستطيع OpenAILike استنتاجه لمعرفات النماذج غير الخاصة بـ OpenAI. اضبط is_function_calling_model=True فقط للنماذج التي تدعم استدعاء الدوال.

رسائل الدردشة

البث المباشر

الإعدادات الافتراضية العامة عبر Settings

اضبط نماذج Venice مرة واحدة عبر Settings وسيستخدمها كل فهرس ومحرك استعلام ووكيل:

التضمينات

خط أنابيب RAG

ابنِ محرك استعلام مدعوم بالاسترجاع فوق مستنداتك. يستخدم هذا Settings.llm وSettings.embed_model المُهيَّأَين أعلاه:
لتحميل ملفاتك الخاصة من مجلد بدلاً من ذلك، استخدم SimpleDirectoryReader:

الوكلاء والأدوات

استخدم FunctionAgent لمنح نماذج Venice وصولاً إلى الأدوات. اختر نموذجاً يدعم استدعاء الدوال:

المخرجات المنظمة

غلّف نموذج LLM باستخدام as_structured_llm للتحقق من الإجابة النهائية مقابل نموذج Pydantic:
تصفّح النماذج التي تدعم الاستجابات المنظمة قبل الاعتماد على المخرجات المنظمة في الإنتاج.

المعاملات الخاصة بـ Venice

مرّر الخيارات الخاصة بـ Venice عبر additional_kwargs باستخدام extra_body. على سبيل المثال، فعّل البحث المدمج على الويب باستخدام venice_parameters:
يمكنك أيضاً تمرير extra_body لكل طلب:
راجع مواصفات API للاطلاع على قائمة venice_parameters الكاملة (تجريف الويب، الاستشهادات، الشخصيات، عناصر التحكم بالتفكير، ومفاتيح التشفير من طرف إلى طرف).

النماذج الموصى بها

معرفات النماذج تتغير مع مرور الوقت — تأكد من المعرفات الحالية عبر GET /models أو نظرة عامة على النماذج.

ميزة الخصوصية

يُستخدم LlamaIndex عادةً لبناء أنظمة RAG فوق المستندات الخاصة وقواعد المعرفة الداخلية وبيانات المستخدمين. اقترانه بـ Venice يُبقي هذا الخط على استدلال خاص وغير خاضع للرقابة:
  • عدم الاحتفاظ بالبيانات على النماذج الخاصة — لا يتم الاحتفاظ بالمطالبات ولا بالأجزاء المسترجعة ولا بحمولات الأدوات بعد الطلب
  • تحليل غير خاضع للرقابة عندما قد تتسبب بياناتك أو أسئلتك في تفعيل فلاتر مزودين آخرين
  • بنية متوافقة مع OpenAI حتى تتمكن من ترحيل تطبيقات LlamaIndex الحالية باستبدال عملاء LLM والتضمينات بـ OpenAILike

استكشاف الأخطاء وإصلاحها

تأكد من ضبط VENICE_API_KEY في العملية التي تشغّل تطبيقك. أعد تشغيل الصدفة أو العملية بعد تغيير متغيرات البيئة.
استخدم معرّف نموذج حالياً من صفحة النماذج. اضبط api_base إلى https://api.venice.ai/api/v1 بدون مسار زائد — يضيف LlamaIndex /chat/completions تلقائياً.
لا يستطيع OpenAILike استنتاج نافذة السياق لمعرفات النماذج غير الخاصة بـ OpenAI. اضبط context_window صراحةً ليطابق النموذج الذي تستخدمه.
اضبط is_function_calling_model=True واختر نموذجاً يدعم استدعاء الدوال. اجعل سلاسل توثيق الأدوات دقيقة — يبني LlamaIndex مخططات JSON من التواقيع والتوثيق.

توثيق LlamaIndex

الفهارس ومحركات الاستعلام والوكلاء وسير العمل

نماذج Venice

تصفح النماذج والقدرات المدعومة