ForHosting KIT · البحث الدلالي

تحويل نص إلى embeddings

حوّل النص إلى أرقام تعبّر عن معناه، فتقترب عبارة «إلغاء خطتي» من «إنهاء الاشتراك» رغم أنهما لا تشتركان في أي كلمة. استخدم النتيجة للبحث أو كشف التكرار أو التوصيات. ادفع حسب الاستخدام، دون رسوم شهرية.

● مستقرةلكل طلب · لكل 1,000 token$0.002

تشغيل — $0.002 + $0.0015/1,000 token اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

شغّلها أونلاين

شغّل هذه المهمة على خوادمنا باستخدام حسابك. الأدوات المجانية تعمل داخل متصفحك، أما هذه فتُخصم من رصيدك في KIT حسب السعر الموضّح أعلاه.

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

ما هو الـembedding

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

كيف تُستخدم المتجهات وما الذي يجب الانتباه إليه

نادرًا ما يكون المتجه هو الهدف النهائي، فهو عادةً الخطوة الأولى قبل بحث بالتشابه أو تجميع أو مصنِّف يُدرَّب على المتجهات. تحوّل المساعدات التي تجيب من مستنداتك كل سؤال وارد وتقارنه بالمقاطع المخزنة لاختيار السياق المناسب، وتقارن فرق الدعم التذاكر الجديدة بالحديثة لكشف التكرار، وتحوّل المتاجر أوصاف منتجاتها مرة واحدة وتعيد استخدامها لأشهر. والخطأ الشائع توقع أن يبحث المتجه وحده، بينما يجب تخزينه ومقارنته.

ما الفرق بين التضمين والبحث الجاهز

هذه القدرة لا تبحث ولا تفهرس بنفسها؛ تقتصر مهمتها على تحويل النص إلى متجه رقمي تخزّنه في قاعدة بياناتك الخاصة أو في فهرس KIT عبر أدوات أخرى. من يحتاج بحثًا جاهزًا فوق ملفاته مباشرة يستخدم أدوات الفهرسة والبحث الدلالي، بينما من يبني نظامه الخاص فوق متجهات خام يبدأ من هنا.

حدود الطلب الواحد

يقبل الطلب الواحد حتى 20,000 رمز نصي؛ للنصوص الأطول يُقسَّم النص إلى مقاطع قبل الإرسال، أو تُستخدم النسخة الجماعية التي تعالج آلاف النصوص في طلب واحد. جودة المتجه تعتمد على وضوح النص المرسَل نفسه أكثر من طوله.

أين يُستخدم المتجه بعد إنتاجه

يُخزَّن المتجه في قاعدة بياناتك الخاصة لبناء بحث دلالي مستقل، أو يُستخدم مباشرة لمقارنة نصين وحساب تشابههما، أو كمدخل لنظام تصنيف وتجميع تبنيه بنفسك فوق بياناتك. الأداة نفسها لا تحتفظ بنسخة من المتجه بعد تسليمه لك.

حالات الاستخدام

فريق تقني في شركة الخليج الرقمية

يبني مطوّرو شركة الخليج الرقمية محرك بحث خاصًا بمنتجاتهم، فيحوّلون وصف كل منتج إلى متجه ويخزّنونه في قاعدتهم الخاصة، بدل الاعتماد على بحث حرفي بالكلمة المفتاحية فقط.

تطبيق توصيات محتوى ناشئ

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

الأسئلة الشائعة

ما الفرق بين هذه القدرة وبين البحث الدلالي الجاهز؟

هذه القدرة تنتج المتجه الخام فقط لتستخدمه في نظامك الخاص؛ أما البحث الدلالي الجاهز فيفهرس نصوصك ويبحث فيها مباشرة دون أن تبني شيئًا بنفسك.

هل يُحفظ نصي بعد إنتاج المتجه؟

لا؛ يُستخدم النص لإنتاج المتجه فحسب، ولا يُخزَّن ولا يُشارَك مع أي جهة أخرى بعد تسليم النتيجة.

ما أقصى طول للنص في الطلب الواحد؟

حتى 20,000 رمز؛ النصوص الأطول تُقسَّم أو تُرسَل عبر النسخة الجماعية التي تعالج آلاف النصوص دفعة واحدة.

لماذا يفوت البحث بالكلمات المفتاحية نتائج تجدها embeddings؟

لأنه يطابق الحروف لا المقاصد. فالبحث عن «إلغاء خطتي» لا يجد مستندًا يقول فقط «إنهاء الاشتراك»، بينما تقترب متجهات العبارتين لأن معناهما واحد.

هل يمكن تحويل عدة نصوص في طلب واحد؟

نعم. أرسل قائمة نصوص بدل نص واحد فتحصل على متجه لكل نص. ويصل كل متجه مع سجل استخدام يوضح ما استهلكه كل تحويل.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/search/embed

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/search/embed \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"El gato está en la alfombra."}'

const res = await fetch("https://api.kit.forhosting.com/search/embed", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "El gato está en la alfombra."
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/search/embed",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "El gato está en la alfombra."
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/search/embed", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"El gato está en la alfombra."}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"El gato está en la alfombra."}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/embed", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "text": "El gato está en la alfombra."
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "search.embed",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

لكل 1,000 token$0.0015

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`max_chunks`	10000
`max_tokens`	20000

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

كيف تصل إلى المتجه

لا حاجة إلى حساب أو اشتراك: تدفع مقابل ما تستهلكه فقط، بحساب دقيق لعدد الرموز المرسَلة. ترسل النص عبر الموقع أو الـAPI، وتحصل على مصفوفة أرقام تمثّل معناه خلال ثوانٍ، مصحوبة برقم مهمة task_id للتتبع.

حالات التكامل

شركة برمجيات تدمج بحثًا داخل تطبيقها

تحتاج مؤسسة النخيل للمقاولات ميزة بحث ذكية داخل تطبيقها الداخلي لإدارة المستندات، فيرسل مطوّروها كل مستند إلى الـAPI ليحصلوا على متجهه، ثم يبنون طبقة البحث فوقه بأنفسهم.

أسئلة تقنية

كم تكلفة تحويل نص إلى متجه؟

$0.002 لكل طلب زائد $0.0015 لكل ألف رمز؛ نص من 2,000 رمز يكلف نحو $0.005 فقط.

هل أحتاج إلى معرفة برمجية لاستخدام هذه القدرة؟

التعامل مع المتجه الناتج يفترض غالبًا فريقًا تقنيًا يخزّنه ويستخدمه في نظامه؛ الإرسال نفسه ممكن من الموقع مباشرة أو عبر الـAPI بلا تعقيد.

هل تتوفر هذه القدرة عبر قنوات أخرى غير الموقع والـAPI؟

اليوم عبر الموقع والـAPI فقط، وستنضم إليهما قريبًا تطبيقات الجوال والبريد الإلكتروني وتيليجرام.

اطّلع على توثيق KIT الكامل ←