getProductsByVectorSearch

Tìm kiếm sản phẩm theo ngữ nghĩa (vector).

Mô tả

Phương thức này thực hiện tìm kiếm ngữ nghĩa (vector) cho các sản phẩm từ một truy vấn bằng ngôn ngữ tự nhiên - nó khớp với ý nghĩa thay vì từ khóa chính xác. Nó trả về một Promise mà khi hoàn thành sẽ trả về một mảng các đối tượng IProductsEntity.

Products.getProductsByVectorSearch(

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

);

Sơ đồ tham số

Sơ đồ

body(bắt buộc): IVectorSearchProducts
Nội dung tìm kiếm vector. Ví dụ: { queryText: "giày chạy màu đỏ" }

body.queryText(bắt buộc): string
Truy vấn tìm kiếm bằng ngôn ngữ tự nhiên.
ví dụ: "giày chạy màu đỏ"

body.vectorDistanceThreshold: number
Khoảng cách vector tối đa cho một kết quả.
ví dụ: 0.5

body.maxHits: number
Số lượng kết quả tối đa để trả về.
ví dụ: 50

body.debug: boolean
Bao gồm thông tin gỡ lỗi trong phản hồi.
ví dụ: false

langCode: string
Mã ngôn ngữ. Mặc định: "en_US"
ví dụ: "en_US"

offset: number
Tham số cho phân trang. Mặc định: 0
ví dụ: 0

limit: number
Tham số cho phân trang. Mặc định: 30
ví dụ: 30

Ví dụ

Ví dụ tối thiểu

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

Ví dụ với các thuộc tính

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

Phản hồi ví dụ

[
  {
    "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
  }
]

Sơ đồ phản hồi

Sơ đồ: IProductsEntity[]

[]: IProductsEntity
Một thực thể sản phẩm.

[].id: number
Định danh duy nhất.
ví dụ: 12345

[].localizeInfos: ILocalizeInfo
Tên sản phẩm đã được địa phương hóa.
ví dụ: { "title": "Giày chạy màu đỏ" }

[].price: number | null
Giá sản phẩm trên trang sản phẩm lấy từ chỉ mục.
ví dụ: 100

[].sku: string | null
SKU sản phẩm (Đơn vị lưu kho), có thể là null.
ví dụ: "SKU_12345"

[].attributeValues: IAttributeValues
Mảng các giá trị thuộc tính từ chỉ mục.

[].statusIdentifier: string | null
Định danh trạng thái trang sản phẩm (có thể là null).
ví dụ: "còn hàng"

[].isVisible: boolean
Một dấu hiệu về tính khả dụng của trang.
ví dụ: true

[].position: number
Số thứ tự mục (để sắp xếp).
ví dụ: 1

---