كيف تبني محرك بحث ذكي لأي متجر: دليل البناء

قبل ما تبدؤون

وش بتبنون، وليش؟

المشكلة

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

وش بتبنون

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

لمين هذا الدليل

هذا الدليل لكم إذا كنتم مطورين أو قادة تقنيين في شركة عندها كتالوج منظم، ومعرّف ثابت لكل منتج، ومخزون لكل فرع، وسياسات مكتوبة للمخزون والتوافق والترتيب. هذي هي افتراضات المرجع، وكل السجلات والأسماء فيه خيالية. الأدوات المسماة فيه هي AI SDK لحلقة الأدوات، وبوابة OpenRouter للنماذج من الخادم، ومكتبة Zod للتحقق عند كل حد، وقاعدة Postgres لحالة الكتالوج والبحث، واستضافة ويب / بنية تحتية سحابية لتشغيل التطبيق. وكلها خيارات تعليمية تقدرون تستبدلونها. والمرجع يستبعد عمداً الدفع وإنشاء الطلب، والخدمات الحية لقراءة رقم الهيكل أو الهوية أو بيانات العميل، وأي تشخيص ميكانيكي أو طبي أو متعلق بالسلامة، وتعليمات تينغ وتكاملاتها الخاصة وترتيبها الإنتاجي.

01 · حدود المرجع

نمط بحث قابل لإعادة الاستخدام، مو بناء لفرع واحد

يغطي هذا المرجع المسار الأساسي لأي شركة عندها كتالوج منظم وأكثر من فرع: يفهم طلب الموظف أو العميل بالعربي أو الإنجليزي، ويحفظ أقل قدر مفيد من سياق الجلسة، ويستدعي أدوات معتمدة، ويطبق قواعد الكتالوج والمخزون والفروع ثابتة في الكود، ويسأل عن التفاصيل الناقصة، ويرجع منتجات مرتبة وقابلة للتتبع. السجلات خيالية والبنية تنفيذ مرجعي.

يشمل

بحث طبيعي بالمنتج أو SKU أو الصفات
فهم الطلب بالعربي والإنجليزي
أدوات مرتبطة بالكتالوج والمخزون والتوافق
تصفية وترتيب وأسئلة توضيحية بقواعد ثابتة في الكود

خارج النطاق

الدفع أو إنشاء الطلب
خدمة حية لقراءة رقم الهيكل أو الهوية أو بيانات العميل
تشخيص ميكانيكي أو طبي أو متعلق بالسلامة
تعليمات تينغ أو تكاملاتها الخاصة أو ترتيبها الإنتاجي

02 · تدفق التحكم

افهم واسترجع وتحقق ورتّب

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

خريطة المرجع · 003البحث الذكي من البداية للنهاية

الطلب

«فحمات فرامل أمامية لسيدان 2021 محرك 2.5، في جدة اليوم.»

بالعربي أو الإنجليزي

منسّق البحث

1يقرأ اللغة والنية والتفاصيل
2يسأل سؤال متابعة واحد إذا نقص السياق
3يستدعي أدوات الكتالوج والتوافق والمخزون المعتمدة

السياق كافي؟ إذا لا، يسأل ثم يعيد الفهم

القواعد والترتيب في الكود

الأهلية والتوافق
ترتيب بقواعد ثابتة

نتائج مرتبطة بالبيانات

معرّفات قطع معتمدة فقط
المخزون في كل فرع
خطوة تالية قابلة للتتبع

السعر والمخزون والتوافق والسياسة والتقييم والخصوصية تبقى خارج النموذج.

خريطة مرجعية. مخطط الحالات تحت يوضّح السلوك التنفيذي، ومعه المسار البديل.

مخطط الحالات: البحث

المصدر

stateDiagram-v2
    [*] --> IDLE
    IDLE --> INTERPRETING
    INTERPRETING --> NEEDS_CLARIFICATION: تفاصيل ناقصة
    NEEDS_CLARIFICATION --> INTERPRETING: تصحيح الطلب
    INTERPRETING --> RETRIEVING: هيكل بيانات متحقق منه
    RETRIEVING --> VALIDATING
    VALIDATING --> RANKING: نتائج مرتبطة بالبيانات
    VALIDATING --> NEEDS_CLARIFICATION: توافق غير مؤكد
    RANKING --> RESPONDING
    RESPONDING --> COMPLETE
    INTERPRETING --> FALLBACK: فشل المزود أو هيكل البيانات
    RETRIEVING --> FALLBACK: انتهاء المهلة
    FALLBACK --> COMPLETE: نتيجة بقواعد ثابتة
    FALLBACK --> FAILED: لا توجد نتيجة آمنة

03 · خيارات تعليمية

أدوات المرجع

يستخدم المرجع AI SDK لحلقة الأدوات، وبوابة OpenRouter للنماذج من الخادم، ومكتبة Zod للتحقق عند كل حد، وقاعدة Postgres لحالة الكتالوج والبحث، واستضافة ويب / بنية تحتية سحابية لتشغيل التطبيق. هذه خيارات تعليمية، وليست وصفاً لحزمة تينغ الإنتاجية.

AI SDK

تنسيق حلقة الأدوات بخطوات محدودة ومخرجات نموذج مكتوبة.

الوثائق الرسمية

OpenRouter

بوابة نماذج من الخادم مع نموذج معتمد وسياسة واضحة للمهلة والتكلفة والبديل.

الوثائق الرسمية

Zod

تحقق للطلبات والتفسير ومدخلات الأدوات والاستجابات العامة.

الوثائق الرسمية

Postgres

نسخة الكتالوج وجلسات البحث وإصدارات السياسات وحالات التقييم وأحداث التدقيق.

الوثائق الرسمية

استضافة ويب / بنية تحتية سحابية

تشغيل التطبيق وواجهة من نفس النطاق وتمرير الأسرار وقت التشغيل وفحوصات الصحة والتراجع.

الوثائق الرسمية

في دليل البناء الكامل

الإعداد والكود والاختبارات والنشر موجودة في الملف

هذه الصفحة تعرض النطاق والبنية والأدوات المرجعية مع وثائقها الرسمية. أقسام التنفيذ تحت موجودة في ملف دليل البناء الكامل: اكتبوا الاسم ورقم الجوال مرة وحدة وينزل لكم. وبعدها يبقى هذا الجهاز مفتوح لكل موارد تينغ المجانية.

04 · المشروع والإعدادفي الملف
05 · هياكل البيانات المتحقق منهافي الملف
06 · الأدوات والاسترجاعفي الملف
07 · القواعد والترتيبفي الملف
08 · هيكل الاستجابةفي الملف
09 · الواجهة والبديلفي الملف
10 · التقييم والاختباراتفي الملف
11 · النشر والمراقبةفي الملف
12 · قائمة الأمانفي الملف

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

أسئلة عن دليل البناء هذا

وش يغطي دليل البناء هذا؟

محرك بحث ذكي مرجعي لكتالوج منظم بين أكثر من فرع: بحث بكلام عادي بالمنتج أو SKU أو الصفات، وفهم الطلب بالعربي والإنجليزي، وأدوات مرتبطة بالكتالوج والمخزون والتوافق، وتصفية وترتيب وأسئلة توضيحية بقواعد ثابتة في الكود، مع بديل واضح إذا تعطل النموذج.

لمين هذا الدليل، ووش تحتاجون قبل ما تبدؤون؟

للمطورين والقادة التقنيين في شركة عندها كتالوج منظم وأكثر من فرع. يفترض المرجع وجود معرّف ثابت لكل منتج، ومخزون لكل فرع، وسياسات مكتوبة للمخزون والتوافق والترتيب، ومعها مفتاح OpenRouter داخل الخادم وقاعدة بيانات Postgres.

وش الأدوات اللي يستخدمها المرجع؟

مكتبة AI SDK لحلقة الأدوات، وبوابة OpenRouter للنماذج من الخادم، ومكتبة Zod للتحقق من كل طلب وتفسير ومدخل أداة واستجابة، وقاعدة Postgres لنسخة الكتالوج وحالة البحث، واستضافة ويب / بنية تحتية سحابية للتشغيل. هذه خيارات تعليمية، وليست وصفاً لحزمة تينغ الإنتاجية.

وين الكود والإعداد والاختبارات؟

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

هل هذا نظام تينغ الإنتاجي؟

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