إنتقل إلى المحتوى الرئيسي

دليل البدء السريع

أهلاً بك في Orki! هذا الدليل يأخذك خطوة بخطوة لإعداد أول وكيل ذكاء اصطناعي لك، باستخدام مثال حقيقي: Balloon Bliss، شركة متخصصة في تزيين البالونات.

في نهاية هذا الدليل، يكون عندك وكيل ذكاء اصطناعي:

  • يعرف نشاطك التجاري من الألف إلى الياء
  • يجاوب على أسئلة العملاء بدقة
  • شغّال على موقعك ويتعامل مع محادثات حقيقية

وش راح نبني؟​

راح ننشئ مساعداً ذكياً لشركة Balloon Bliss، وهي شركة لتزيين البالونات. وكيلنا سوف:

  • يجاوب على الأسئلة حول باقات البالونات والأسعار
  • يشرح خيارات التوصيل
  • يتعامل مع طلبات الحجز
  • يقدم معلومات عن التصاميم المخصصة

يلا نبدأ!

الخطوة 1: إكمال التهيئة الأولية​

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

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

الخطوة 2: تجربة الوكيل في ساحة التجربة (قبل إضافة المعرفة)​

بعد التهيئة الأولية، خل نشوف وش يقدر يسوي وكيلك من البداية.

  1. اذهب إلى الدردشات ← ساحة التجربة في الشريط الجانبي
  2. وكيلك الجديد لازم يكون محدّداً
  3. ابدأ محادثة

وش راح تلاحظ​

وكيلك يقدر يمسك محادثة طبيعية، لكن لاحظ وش يصير لما تسأله أسئلة محددة عن نشاطك:

جرّب تسأل:

  • "وش الباقات اللي تقدمونها للبالونات؟"
  • "كم سعر تجهيز عيد الميلاد؟"
  • "هل توصلون إلى منطقتي؟"

الوكيل راح يعطي ردوداً عامة لأنه ما عنده معلومات نشاطك التجاري لحد الآن. قد يقول شيء مثل "نقدم باقات متنوعة" بدل ما يسرد لك باقاتك الفعلية مع الأسعار.

وهذا متوقع! وكيلك ذكي، لكنه يحتاج بياناتك أنت عشان يعطي إجابات دقيقة.

الخطوة 3: إضافة المعرفة إلى وكيلك​

الحين خل نعطي وكيلك المعلومات اللي يحتاجها. راح نقوم بزحف موقع Balloon Bliss لاستخراج كل المحتوى.

  1. اذهب إلى قاعدة المعرفة في الشريط الجانبي
  2. أنشئ قاعدة معرفة (أو اختر واحدة موجودة)
  3. افتح المصادر ← المواقع
  4. اضغط على موقع جديد +
  5. أدخل رابط موقعك وأكّد

سوف يقوم Orki تلقائياً بـ:

  • زحف جميع صفحات موقعك
  • استخراج النصوص ومعلومات المنتجات والأسئلة الشائعة
  • معالجة وفهرسة كل شيء لذكائك الاصطناعي

انتظار المعالجة​

بعد إضافة المصادر:

  • راح تشاهد مؤشر تقدم المعالجة
  • المعالجة عادةً تأخذ بضع دقائق
  • الحالة تتغير إلى "جاهز" عند اكتمال المعالجة

ربط المعرفة بالوكيل​

بعد اكتمال المعالجة، لازم تربط قاعدة المعرفة بوكيلك:

  1. افتح الوكيل الذكي واذهب إلى تبويب المعرفة الخاص به
  2. اختر قاعدة المعرفة التي أضفت الموقع إليها
  3. احفظ التغييرات

بدلاً من ذلك، استخدم إجراء "إضافة للوكيل" على بطاقة قاعدة المعرفة.

الخطوة 4: جرّب مرة أخرى (مع المعرفة)​

الحين خل نشوف الفرق الكبير! ارجع إلى ساحة التجربة واسأل نفس الأسئلة:

اسأل: "وش الباقات اللي تقدمونها للبالونات؟"

قبل (بدون معرفة):

"نقدم باقات متنوعة لتزيين البالونات لمختلف المناسبات."

بعد (مع المعرفة):

"عندنا عدة خيارات! بالونات الحفلات الكلاسيكية تبدأ من 2.50 ر.ع.، وباقة Birthday Bash Bundle بـ 35 ر.ع. وتشمل كل ما تحتاجه للاحتفال، وباقة Wedding Elegance بـ 75 ر.ع.، وباقة Corporate Event Pack بـ 120 ر.ع. والتوصيل مجاني في مسقط للطلبات فوق 20 ر.ع..."

وكيلك صار يعطي معلومات دقيقة ومحددة مسحوبة مباشرةً من موقعك!

الخطوة 5: ربط تكامل الدردشة عبر الويب​

حان وقت تشغيل وكيلك الذكي على موقعك!

  1. اذهب إلى التكاملات ← الموقع الإلكتروني في الشريط الجانبي — تُفتح صفحة تكاملات الويب
  2. اضغط على تكامل جديد (New Integration)
  3. خصّص المظهر:
    • اختر الألوان المتناسقة مع علامتك التجارية
    • اختر نمط الدردشة وأيقونة المشغّل
    • أضف رسائل البدء
  4. احفظ التكامل

إضافة الكود إلى موقعك​

افتح نافذة التثبيت الخاصة بالتكامل واختر الطريقة المناسبة لموقعك:

  • HTML — انسخ مقطع الكود المُولَّد من النافذة والصقه قبل وسم </body> الختامي مباشرةً
  • Next.js / React — ثبّت حزمة npm الرسمية @orki/webchat-react وأضف المكوّن في تخطيطك الجذري
  • WordPress — ثبّت إضافة Orki Webchat والصق بياناتك في صفحة إعداداتها

الخطوة 6: شاهده يشتغل!​

وكيلك الذكي صار شغّال! خل نختبره على موقعك الفعلي.

  1. ادخل إلى موقعك
  2. اضغط على أداة الدردشة
  3. ابدأ محادثة
  4. شاهد ذكاءك الاصطناعي يتعامل معها بإتقان!

عرض المحادثات داخل Orki​

تظهر كل المحادثات في صندوق وارد المحادثات عندك:

  • شاهد الرسائل في الوقت الفعلي
  • راقب ردود الذكاء الاصطناعي
  • تدخّل بنفسك واستلم المحادثة وقت ما تحتاج
  • اعرض ملفات العملاء

أنت الآن في الهواء!​

مبروك! وكيلك الذكي صار:

  • مدرَّباً بمعرفة نشاطك التجاري
  • متصلاً بموقعك
  • يتعامل مع محادثات العملاء على مدار الساعة طيلة أيام الأسبوع

نتائج Balloon Bliss​

بعد الإعداد اللي خلصناه للتو، وكيل Balloon Bliss الذكي صار قادر على:

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

الخطوة التالية؟​

بعد ما صرت جاهزاً، استكشف هذه الميزات:

استكشاف الأخطاء وحلها​

الوكيل يعطي ردوداً عامة​

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

قاعدة المعرفة ما تتعالج​

  • تأكد أن رابط الموقع متاح
  • تحقق أن الموقع ما يحجب برامج الزحف
  • جرّب إضافة المحتوى يدوياً عبر المستندات أو الأسئلة الشائعة

أداة الدردشة ما تظهر​

  • تأكد من وضع كود التضمين في المكان الصحيح
  • تحقق من عدم وجود أخطاء JavaScript في وحدة تحكم المتصفح
  • تأكد أن الأداة مفعّلة في الإعدادات

الرسائل ما تظهر في المحادثات​

  • تحقق أن تكاملك متصل ومفعّل
  • تأكد أن وكيلك مخصَّص لهذه القناة
  • جرّب فصل التكامل وإعادة ربطه

تحتاج مساعدة؟​

تواصل مع فريق الدعم عبر واتساب أو زر orki.ai