كيف تضيف دردشة بالذكاء الاصطناعي إلى تطبيق React Native
ثبّت SDK Sell Whisper AI لـReact Native، وأنشئ عميلاً (client) بمعرّف الأداة، واعرض شاشة الدردشة في تطبيقك على iOS وAndroid.
نفّذها بالترتيب
ثبّت الحزم
أضف @sellwhisper/chat-client و@sellwhisper/react-native من npm. يدعم SDK الإصدار React Native 0.73 أو أحدث، وExpo SDK 53 أو أحدث، وiOS 15.1 أو أحدث، وAndroid API level 24 أو أحدث.
انسخ معرّف الأداة
في لوحة التحكم، افتح الوكيل، وانتقل إلى النشر (Deploy) وافتح أداة الدردشة الخاصة بالوكيل. معرّف الأداة (Widget ID) في إعداداتها هو نفسه الذي يستخدمه تضمين الموقع، فيتشارك التطبيق الوكيل نفسه وإعدادات الأداة نفسها.
أنشئ العميل وغلّف تطبيقك
أنشئ SellWhisperClient بمعرّف الأداة (Widget ID) ومحوّل تخزين مثل AsyncStorage لتبقى المحادثات محفوظة بين مرات التشغيل، ثم غلّف تطبيقك بـSellWhisperProvider.
اعرض شاشة الدردشة
أضف SellWhisperChatScreen حيث ينبغي أن تظهر الدردشة. تفعّل خصائصه (props) الترويسة وسجل المحادثات والمرفقات والملاحظات الصوتية؛ وتتطلب المرفقات والملاحظات الصوتية تثبيت حزمتَي منتقي الملفات والصوت الاختياريتين.
حزمتان
| الحزمة | تُستخدم لـ |
|---|---|
@sellwhisper/chat-client | العميل بلا واجهة (headless): المحادثات والرسائل والأحداث، دون اعتماد على React Native |
@sellwhisper/react-native | المزوّد (provider) والخطافات (hooks) وشاشة الدردشة الجاهزة لـReact Native وExpo |
ثبّت الحزمتين للحصول على الشاشة الجاهزة. وثبّت العميل وحده لبناء واجهتك الخاصة.
ما يتشاركه التطبيق مع موقعك
يتصل التطبيق بمعرّف الأداة (Widget ID) نفسه الذي يستخدمه تضمين موقعك. وهذا يعني وكيلًا واحدًا وقاعدة معرفة واحدة ومجموعة واحدة من قواعد التصعيد، وأن أي تغيير في معرفة الوكيل أو تعليماته يصل إلى التطبيق دون إصدار جديد.
الميزات الاختيارية وما تحتاج إليه
| الميزة | تحتاج إلى |
|---|---|
| سجل المحادثات بين مرات التشغيل | محوّل تخزين مثل AsyncStorage |
| المرفقات | حزمة لاختيار الصور أو المستندات |
| الملاحظات الصوتية | حزمة لتسجيل الصوت |
| المساعد الصوتي | حزمة صوت ونسخة تطوير (development build)؛ ولا يعمل في Expo Go |
| الإشعارات الفورية | إعداد الإشعارات الفورية في تطبيقك، وتسجيل الجهاز لدى SDK |
قبل الإصدار
- اختبر على جهاز. شغّل نسختك على جهاز iOS وجهاز Android حقيقيين، لا في المحاكي فقط.
- أضف المعرفة أولًا. فائدة الشاشة من فائدة الوكيل الذي يقف خلفها. اطّلع على كيف تدرّب وكيل ذكاء اصطناعي على موقعك.
- اضبط التصعيد. الدردشة المباشرة مع فريقك تعمل في التطبيق؛ حدّد متى تبدأ بالاستعانة بدليل كيف تحيل محادثات الذكاء الاصطناعي إلى موظف بشري.
تجد أوامر التثبيت وخصائص المكوّنات (props) ومثالًا كاملًا في React Native SDK.