getProductsByVectorSearch

البحث الدلالي (التماثلي) عن المنتجات.

الوصف

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

Products.getProductsByVectorSearch(

body*, body.queryText*, body.vectorDistanceThreshold, body.maxHits, body.debug, langCode, offset, limit

);

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

المخطط

body(required): IVectorSearchProducts
جسم البحث التماثلي. مثال: { queryText: "أحذية جري حمراء" }

body.queryText(required): string
استعلام البحث بلغة طبيعية.
مثال: "أحذية جري حمراء"

body.vectorDistanceThreshold: number
أقصى مسافة تماثلية للنتيجة.
مثال: 0.5

body.maxHits: number
أقصى عدد من النتائج لإرجاعها.
مثال: 50

body.debug: boolean
تضمين معلومات التصحيح في الاستجابة.
مثال: false

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

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

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

أمثلة

مثال بسيط

const response = await Products.getProductsByVectorSearch({ queryText: 'red running shoes' });

مثال مع السمات

const response = await Products.getProductsByVectorSearch(
  {
    queryText: 'red running shoes',
    vectorDistanceThreshold: 0.5,
    maxHits: 50,
  },
  'en_US',
  0,
  30,
);

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

[
  {
    "id": 1764,
    "localizeInfos": {
      "title": "Red running shoes"
    },
    "price": 100,
    "additional": {
      "prices": {
        "min": 0,
        "max": 100
      }
    },
    "isVisible": true,
    "isSync": true,
    "sku": "0-123",
    "attributeValues": {},
    "attributeSetIdentifier": "my-set",
    "statusIdentifier": "in_stock",
    "statusLocalizeInfos": {
      "title": "In stock"
    },
    "position": 1
  }
]

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

المخطط: IProductsEntity[]

[]: IProductsEntity
كائن منتج.

[].id: number
المعرف الفريد.
مثال: 12345

[].localizeInfos: ILocalizeInfo
الاسم المحلي للمنتج.
مثال: { "title": "أحذية جري حمراء" }

[].price: number | null
سعر صفحة المنتج المأخوذ من الفهرس.
مثال: 100

[].sku: string | null
SKU المنتج (وحدة حفظ المخزون)، قد يكون فارغًا.
مثال: "SKU_12345"

[].attributeValues: IAttributeValues
مصفوفة من قيم السمات من الفهرس.

[].statusIdentifier: string | null
معرف حالة صفحة المنتج (قد يكون فارغًا).
مثال: "in_stock"

[].isVisible: boolean
علامة على رؤية الصفحة.
مثال: true

[].position: number
رقم العنصر (لترتيب النتائج).
مثال: 1

---