getAdminsByVectorSearch

بحث دلالي (متجه) عن المسؤولين.

الوصف

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

.getAdminsByVectorSearch(

, , ,

);

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

المخطط

body(required): IAdminsVectorSearch
نص جسم البحث المتجه
مثال:

{ queryText: "content manager" }

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 Admins.getAdminsByVectorSearch({ queryText: 'content manager' });

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

const response = await Admins.getAdminsByVectorSearch(
  {
    queryText: 'content manager',
    vectorDistanceThreshold: 0.3,
    maxHits: 50,
    debug: true,
  },
  'en_US',
  0,
  30,
);

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

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

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

المخطط: IAdminsResponse

items: IAdminEntity[]
مصفوفة من كائنات المسؤولين التي تم العثور عليها.

items.id: number
معرف الكائن.
مثال: 1764

items.attributeSetId: number | null
معرف مجموعة السمات المستخدمة.
مثال: 120

items.identifier: string
المعرف النصي لحقل السجل.
مثال: "admin1"

items.attributeSetIdentifier: string | null
معرف مجموعة السمات.
مثال: "admins"

items.position: number | null
رقم الموضع (للتصنيف).
مثال: 1

items.isSync: boolean
علامة فهرسة الصفحة (صحيح أو خطأ).
مثال: true

items.attributeValues: IAttributeValues
مصفوفة من قيم السمات من الفهرس (مقدمة كزوج من معرف سمة المستخدم: قيمة السمة).
مثال:

[
  {
    "marker": {
      "type": "string",
      "value": "Some value"
    }
  }
]

items.moduleFormConfigs: IFormConfig[]
مصفوفة من تكوينات نماذج الوحدة المرتبطة بالمسؤول.

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

total: number
إجمالي عدد السجلات التي تم العثور عليها.
مثال: 100

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

---