getDiscountsByVectorSearch

البحث الدلالي (التماثلي) عن الخصومات.

الوصف

تقوم هذه الطريقة بإجراء بحث دلالي (تماثلي) عن الخصومات من استعلام بلغة طبيعية - حيث تتطابق على المعنى بدلاً من الكلمات الرئيسية الدقيقة. تعيد Promise التي تحل إلى كائن IDiscountsResponse - حاوية تحتوي على items (الخصومات) و total.

.getDiscountsByVectorSearch(

, , ,

);

مخطط المعاملات

المخطط

body(required): IDiscountsVectorSearch
نص البحث التماثلي
مثال:

{ queryText: "winter sale" }

body.queryText(required): string
استعلام البحث بلغة طبيعية.
مثال: "تخفيضات الشتاء"

body.vectorDistanceThreshold: number
تجاوز عتبة المسافة الكونية (0..2).
مثال: 0.3

body.maxHits: number
أعلى K من المرشحين الذين تم جلبهم قبل التصفح. الافتراضي: 100. الحد الأقصى: 500.
مثال: 10

body.debug: boolean
عند التفعيل، يحصل كل عنصر تم إرجاعه على حقل distance.
مثال: false

langCode: string
رمز اللغة. الافتراضي: "en_US"
مثال: "en_US"

offset: number
معامل للتصفح. الافتراضي: 0
مثال: 0

limit: number
معامل للتصفح. الافتراضي: 30
مثال: 30

أمثلة

مثال بسيط

const response = await Discounts.getDiscountsByVectorSearch({ queryText: 'winter sale' });

مثال مع الخصائص

const response = await Discounts.getDiscountsByVectorSearch(
  {
    queryText: 'winter sale',
    vectorDistanceThreshold: 0.3,
    maxHits: 50,
    debug: true,
  },
  'en_US',
  0,
  30,
);

مثال على الاستجابة

{
  "items": [],
  "total": 0,
  "indexReady": false
}

مخطط الاستجابة

المخطط: IDiscountsResponse

items: IDiscountsEntity[]
مصفوفة من كائنات الخصومات.

items.id: number
المعرف الفريد للخصم.

items.attributeSetId: number | null
معرف مجموعة الخصائص المرتبطة بالخصم، أو null عندما لا تكون هناك مجموعة مرتبطة.

items.localizeInfos: ILocalizeInfo
اسم الخصم.

items.version: number
إصدار الخصم.

items.identifier: string
معرف الخصم.

items.type: IDiscountType
نوع الخصم.

items.startDate: string
تاريخ بدء الخصم.

items.endDate: string
تاريخ انتهاء الخصم.

items.discountValue: IDiscountValue
قيمة الخصم، بما في ذلك نوعه وحدود المبلغ.

items.conditionLogic: string
منطق الخصم. القيم الممكنة هي "AND" | "OR".

items.conditions: IDiscountCondition[]
شروط الخصم.

items.exclusions: Record<string, unknown> | null
استثناءات الخصم.

items.gifts: Record<string, unknown> | null
الهدايا المرتبطة بالخصم.

items.giftsReplaceCartItems: boolean
ما إذا كانت الهدايا تحل محل عناصر السلة.

items.userGroups: Record<string, unknown> | null
مجموعات المستخدمين المرتبطة بالخصم.

items.userExclusions: Record<string, unknown> | null
استثناءات المستخدمين المرتبطة بالخصم.

items.attributeValues: IAttributeValues
قيم الخصائص المرتبطة بالخصم.

items.attributeSetIdentifier: string
معرف مجموعة الخصائص.

items.bonusEvent: Record<string, unknown>
تهيئة حدث المكافأة.

items.position: number
رقم الموضع للفرز.
مثال: 1

items.total: number | string
إجمالي عدد الإدخالات ذات الصلة.
مثال: "1"

items.distance: number
المسافة الكونية للاستعلام. يتم إرجاعها فقط من نقطة نهاية البحث الدلالي (التماثلي) عندما يتم تمرير debug: true في نص البحث.
مثال: 0.12

total: number
إجمالي عدد الخصومات.

ℹ️ البحث الدلالي يتطابق على المعنى، وليس على النص الحرفي. لاستخدام مطابقة الكلمات الرئيسية عبر كل نوع كائن مرة واحدة، استخدم globalSearch().

---