وش بتبنون، وليش؟
المشكلة
أغلب رحلات المنتجات مبنية حول الكتالوج، مو حول العميل. العميل هو اللي لازم يحوّل احتياجه الحقيقي إلى نفس الأسماء والتصنيفات والفلاتر اللي تستخدمها الشركة. وكثير من العملاء يقدرون يشرحون النتيجة اللي يبغونها بدون ما يعرفون أي منتج أو باقة أو خدمة تحققها لهم. الفلاتر تفيد بس اللي فاهم من البداية الفروقات الموجودة داخل الكتالوج، والكتالوج الكبير يبطّئ القرار لما تكون الفروقات والتنازلات مو واضحة. والبحث بالكلمات المفتاحية ممكن يطلع صفحات فيها نفس الكلمات، ومع ذلك يفوّت الهدف اللي يحاول العميل يوصل له. وبالوقت نفسه، فرق المبيعات والدعم عندكم تجاوب على نفس أسئلة الاكتشاف كل مرة عشان تحدد الخيار المناسب.
وش بتبنون
هذا الدليل يمشي معكم خطوة بخطوة في بناء مساعد مرجعي لاكتشاف المنتجات بالذكاء الاصطناعي، يبدأ من الاحتياج بدل الكلمة المفتاحية. يفهم الطلب المكتوب بكلام عادي، ويحفظ الحقائق المفيدة من الرسائل السابقة، وإذا ما قدر يقرر للحين يسأل عن أهم معلومة ناقصة وحدة بس. ولما يصحح العميل معلومة، يحل التصحيح محل المعلومة القديمة بدل ما تبقى الثنتين جنب بعض. المساعد يبحث في كتالوج معتمد فقط، ويوضح ليش كل خيار يناسب، ويقارن بين الخيارات المناسبة، ويرجع بطاقات منتجات مرتبة مع خطوة تالية واضحة: استفسار أو حجز أو شراء أو تحويل لموظف، وكل هذا بعد موافقة العميل. والاحتياج اللي ما يغطيه الكتالوج يرجع له رد صريح إنه ما فيه تطابق، بدل ما يطلع له منتج مخترع. خادم التطبيق هو المسؤول عن السياق والوصول للكتالوج والتحقق وهيكل الاستجابة، والمتصفح للعرض بس. ويبقى الكتالوج هو المصدر الوحيد للمنتجات: النموذج يساعد في فهم اللغة، لكنه ما يقدر ينشئ منتجات أو معلومات من عنده.
لمين هذا الدليل
هذا الدليل لكم إذا كنتم مطورين أو قادة تقنيين أو فريق منتجات، وتبغون عملاءكم يلقون المنتج المناسب بمجرد ما يوصفون احتياجهم، من كتالوجكم أنتم، مو من صندوق محادثة يخمّن. تحتاجون تكونون مرتاحين مع مشروع خادم JavaScript أو TypeScript حديث. كل الأمثلة مبنية على كتالوج خيالي لقطع غيار المصانع، عشان تتابعون كل قرار قبل ما تلمسون أي بيانات حقيقية. والمرجع يسمّي حزمة تعليمية وحدة: OpenRouter، LangChain، LangGraph، LangSmith، مع كتالوج أو مخزن بيانات معتمد واستضافة ويب / بنية تحتية سحابية، وتقدرون تستبدلون أي وحدة منها. هو مرجع للتعلم، مو مساعد تينغ الإنتاجي: تعليمات تينغ وترتيبها وربطها الخاص وبيانات عملائها مو جزء منه.
وش يغطي هذا المرجع؟
يركز المرجع على النمط الظاهر للزائر: يفهم الاحتياج، يحفظ السياق المفيد، يبحث في كتالوج معتمد، يشرح التطابق، ويوجّه للخطوة التالية.
يشمل
- واجهة المحادثة وهيكل الرسالة
- هيكلة كتالوج خيالي
- قواعد تصحيح السياق
- اختيار السؤال حسب الاحتياج
- مطابقة مرتبطة بالكتالوج
- استجابات منتجات منظمة
- مسار احتياطي بقواعد ثابتة
- حدود العزل والتحقق
خارج النطاق
- مساعد تينغ الحقيقي
- تعليمات أو ترتيب إنتاجي
- ربط خاص
- بيانات عملاء أو CRM حقيقية
- اختيارات تينغ الإنتاجية للمزود
- تفاصيل أمان إنتاجية قابلة للاستغلال
البنية المرجعية
خل واجهة المتصفح للعرض والتفاعل. خادم التطبيق هو المسؤول عن فهم السياق، الوصول للكتالوج، التحقق، وهيكلة الاستجابة.

«مضخة P-204 في مصنعنا ترجع تسرّب من مانع التسرّب. أي مانع نطلب؟»
بالعربي أو الإنجليزي وبكلام العميل نفسه- 1يستخرج الحقائق والتصحيحات
- 2يسأل السؤال اللي يفرّق بين الخيارات
- 3يسترجع الخيارات من الكتالوج المعتمد
ما يسأل مرة ثانية إلا إذا نقصت معلومة تحسم القرار
- كل منتج من الكتالوج نفسه
- كل معلومة مقابل سجلها
- 2 إلى 3 منتجات معتمدة
- ليش كل واحد يناسب
- الخطوة التالية: عرض سعر أو تحويل لموظف
الكتالوج هو المصدر الوحيد للمنتجات. الأسعار والمخزون من أنظمتك، والتحويل لموظف يحتاج موافقة العميل.
المصدر
flowchart LR
A["Conversation UI"] --> B["Application Server"]
B --> C["Conversation State"]
B --> D["Intent & Requirement Extraction"]
D --> E["Approved Local Catalogue"]
E --> F["Retrieval & Match Layer"]
F --> G["Validation Layer"]
G --> H["Structured Response"]
H --> Aأدوات عملية لبناء المرجع
يستخدم هذا المرجع أدوات OpenRouter، LangChain، LangGraph، LangSmith عشان يكون التنفيذ واضحاً. هذه خيارات تعليمية مرجعية، وليست وصفاً لحزمة تينغ الإنتاجية.
OpenRouter
بوابة نماذج لواجهة النموذج المرجعية. اختر نموذجاً يناسب لغة مشروعك وسرعته واحتياجه للمخرجات المنظمة.
LangChain
يوفر موصلات النماذج والأدوات وتركيب التعليمات والمخرجات المنظمة المتحقق منها بالمخطط.
LangGraph
يشغّل سير العمل ذي الحالة: تحديث الحقائق، استرجاع الخيارات، اختيار السؤال، التوصية، ثم التحقق.
LangSmith
يضيف التتبّع ومجموعات الاختبار والتقييمات وفحوصات تمنع رجوع الأخطاء، بدون ما يصير مصدر حقيقة المنتجات.
كتالوج معتمد / مخزن بيانات
ملف JSON له إصدارات يكفي محلياً. في الإنتاج تقدر تستخدم قاعدة بيانات معتمدة أو مصدر بيانات أعمال خلف نفس واجهة المستودع المتحقق منها.
استضافة ويب / بنية تحتية سحابية
تشغّل واجهة الخادم، وتمرّر الأسرار بأمان، وتوفر فحوصات الصحة والتسجيل والمراقبة والتراجع.
المصدر
flowchart LR
UI["Conversation UI"] --> API["Application API"]
API --> GRAPH["LangGraph Workflow"]
GRAPH --> CHAIN["LangChain Tools and Structured Output"]
CHAIN --> ROUTER["OpenRouter"]
GRAPH --> CATALOG["Approved Product Catalogue"]
GRAPH --> TRACE["LangSmith Tracing and Evaluation"]
API --> HOST["Web Hoster / Cloud Infrastructure"]الإعداد والكود والاختبارات والنشر موجودة في الملف
هذه الصفحة تعرض النطاق والبنية والأدوات المرجعية مع وثائقها الرسمية. أقسام التنفيذ تحت موجودة في ملف دليل البناء الكامل: اكتبوا الاسم ورقم الجوال مرة وحدة وينزل لكم. وبعدها يبقى هذا الجهاز مفتوح لكل موارد تينغ المجانية.
- 02.2 · هيكل المشروعفي الملف
- 02.3 · الإعدادفي الملف
- 03 · نموذج الكتالوجفي الملف
- 04 · سياق المحادثةفي الملف
- 05 · منطق الأسئلةفي الملف
- 06 · الاسترجاع والمطابقةفي الملف
- 07 · هيكل الاستجابةفي الملف
- 07.1 · تنفيذ TypeScriptفي الملف
- 08 · خطوات البناءفي الملف
- 08.1 · التشغيل المحليفي الملف
- 09 · حدود الأمانفي الملف
- 09.1 · التقييمفي الملف
- 10 · قائمة الإنتاجفي الملف
- 10.1 · النشرفي الملف
- 11 · الحدودفي الملف
