Technical Tutorials

أصبح توليد المعلومات المعزّز بالاسترجاع (RAG) المعيار الذهبي لتأصيل نماذج اللغة الكبيرة (LLMs) في البيانات الخاصة. ومع ذلك، عند نشر حلول RAG لمنصات SaaS، يظهر تحدي حاسم: عزل البيانات. في بيئة متعددة المستأجرين، ضمان عدم استرجاع المستأجر أ لمستندات المستأجر ب ليس مجرد ممارسة مثلى، بل هو متطلب أمني.

تعامل Weaviate مع هذا التحدي بشكل أصلي من خلال قدراتها على تعدد المستأجرين. على عكس النهج التقليدية حيث قد تقوم بإنشاء مجموعات منفصلة أو إدارة منطق تصفية معقد في طبقة التطبيق، تتيح لك Weaviate إنشاء "فضاءات أسماء" معزولة داخل مجموعة واحدة. تستكشف هذه المقالة كيفية تنفيذ هذه فضاءات المتجهات المعزولة بفعالية.

فهم تعدد المستأجرين في Weaviate

في Weaviate، تعمل المجموعة متعددة المستأجرين كحاوية لعدة مستأجرين. كل مستأجر هو في الأساس مقطع معزول من المجموعة. الفائدة المعمارية الرئيسية هي أن لكل مستأجر مجموعة خاصة به من المتجهات والبيانات الوصفية، مفصولة فيزيائياً على مستوى التخزين. وهذا يعني:

عزل الأداء: مجموعة بيانات كبيرة لمستأجر واحد لا تُبطئ الاستعلامات لمستأجر آخر.
الأمان: يجب أن تحدد الاستعلامات معرّف المستأجر صراحةً، مما يمنع تسرب البيانات بين المستأجرين عن طريق الخطأ.
قابلية التوسع: يمكنك إضافة أو إزالة المستأجرين بسهولة دون الحاجة إلى هجرة البيانات.

خطوات التنفيذ

1. تكوين المجموعة

لتفعيل تعدد المستأجرين، يجب عليك تكوين مخطط المجموعة مع خيار multiTenancyConfig. لاحظ أنه لا يمكن تغيير هذا الإعداد بعد إنشاء المجموعة.

import weaviate

client = weaviate.WeaviateClient(
    connection_params=weaviate.ConnectionParams(
        from_environment()
    )
)

schema = client.collections

# Create a multi-tenant collection
collection = schema.get_or_create(
    "KnowledgeBase",
    data=weaviate.classes.data.Config(
        vector_index_config=weaviate.classes.config.VectorIndexConfig(
            vector_index_type="hnsw"
        ),
        multi_tenancy_config=weaviate.classes.config.MultiTenancyConfig(
            enabled=True
        )
    )
)

2. إدخال بيانات محددة للمستأجر

عند إضافة البيانات، يجب عليك تحديد tenant_id. يضمن هذا تخزين المتجه في فضاء الأسماء المعزول الصحيح.

# Ingest data for Tenant A
collection.data.insert(
    {
        "content": "Tenant A's proprietary documentation...",
        "category": "manual"
    },
    tenant_id="tenant_a"
)

# Ingest data for Tenant B
collection.data.insert(
    {
        "content": "Tenant B's private user guides...",
        "category": "help"
    },
    tenant_id="tenant_b"
)

3. تنفيذ استعلامات معزولة

عند إجراء عمليات بحث بالمتجهات، يكون tenant_id معاملاً إلزامياً. إذا تركته، سيقوم الواجهة البرمجية (API) بإلقاء خطأ، مما يعمل كآلية فشل آمن.

# Query strictly within Tenant A's namespace
response = collection.query.near_text(
    query="How do I reset my password?",
    limit=5,
    tenant_id="tenant_a"
)

print(f"Results for Tenant A: {len(response.objects)}")
# This query will NEVER return Tenant B's data, even if it is semantically similar.

اعتبارات عملية لتطبيقات SaaS

بينما تتعامل Weaviate مع عزل المتجهات، يجب أن تتعامل معمارية تطبيقك مع سياق المستأجر بشكل صحيح. فيما يلي أفضل الممارسات:

تكامل الوسيط (Middleware): استخدم وسيط الواجهة البرمجية (API middleware) لاستخراج معرّف المستأجر من رمز المصادقة (مثل JWT) وحقنه في سياق عميل Weaviate. لا تسمح أبداً للمدخلات من جانب العميل بتحديد معرّف المستأجر للعمليات الحرجة أمنياً.
إدارة الفهرس: للمستأجرين ذوي الأحجام الكبيرة جداً، فكّر في التقسيم الإضافي باستخدام ميزات partitioning في Weaviate أو إدارة استراتيجيات التخزين الساخن/البارد.
اتساق التضمين (Embedding): تأكد من استخدام نموذج تضمين (embedding model) واحد لجميع المستأجرين. على الرغم من أن المتجهات معزولة، إلا أن عدم اتساق فضاءات التضمين بين المستأجرين قد يؤدي إلى استرجاع غير مثالي إذا كنت بحاجة يومياً إلى تحليلات عبر المستأجرين (والتي يجب أن تكون نادرة في سيناريوهات العزل الصارم).

الخلاصة

يوفر تعدد المستأجرين في Weaviate حلاً متيناً وأصلياً لبناء خطوط أنابيب RAG معزولة في بيئات SaaS. من خلال الاستفادة من فضاءات أسماء المستأجرين الأصلية، يمكن للمطورين تحقيق عزل صارم للبيانات، وتحسين أداء الاستعلامات، وتبسيط إدارة الموارد. عند توسيع تطبيقات RAG الخاصة بك، فإن اعتماد هذا النمط مبكراً سيوفر جهداً كبيراً في تصميم طبقات أمان مخصصة لاحقاً.

سواء كنت تبني روبوت دعم عملاء أو أداة بحث معرفي مؤسسية، تضمن Weaviate بقاء بيانات كل مستأجر آمنة وسريعة وقابلة للوصول فقط من قبل مالكيها.