دمج عنوان URL لملفات CSV
استورد المستندات مباشرة من ملفات CSV المتاحة للجمهور عبر عنوان URL إلى قاعدة المعرفة لمساعدك الذكي.
البداية السريعة
ابدأ في 3 خطوات:
- انتقل: الإدارة → مساعدي → [اسم المساعد] → التكاملات → عنوان URL لملف CSV
- أضف عنوان URL: أدخل عنوان URL لملف CSV العام الخاص بك واختر نوع الاستيراد (أسئلة شائعة/منتج/افتراضي)
- استيراد: انقر على "إضافة عنوان URL" وتابع الحالة
نصيحة: اختبر باستخدام ملف CSV صغير أولاً لتتعرف على العملية.

ما يمكنك فعله
- ✅ استيراد من عناوين URL لملفات CSV العامة عبر HTTP/HTTPS
- ✅ استيراد جماعي لعدة عناوين URL في وقت واحد
- ✅ الكشف التلقائي عن هيكل ملف CSV (أسئلة شائعة، منتج، أو عام)
- ✅ تعيين الفئات ورسم الأعمدة المخصصة
- ✅ تتبع حالة الاستيراد والتاريخ
المتطلبات الأساسية
- وصول إداري إلى مساعدك الذكي SmartTalk
- ملفات CSV متاحة للجمهور (لا يتطلب مصادقة)
- هيكل CSV صحيح مع رؤوس الأعمدة
- يوصى باستخدام ترميز UTF-8
أنواع الاستيراد
1. استيراد الأسئلة الشائعة
الأفضل لـ: وثائق الدعم، قواعد المعرفة
الأعمدة المطلوبة:
questionanswer
مثال:
question,answer
"كيف يمكنني إعادة تعيين كلمة المرور الخاصة بي؟","انقر على 'نسيت كلمة المرور' واتبع التعليمات."
"ما هي ساعات العمل الخاصة بكم؟","من الاثنين إلى الجمعة، من 9 صباحًا إلى 6 مساءً."
2. استيراد المنتج
الأفضل لـ: كتالوجات التجارة الإلكترونية، المخزون
العمود المطلوب:
idProduct(أو عمود مخصص)
اختياري:
name(أو عمود مخصص)
مثال:
idProduct,name,description,price
"PROD001","جهاز ويدجت متميز","جهاز ويدجت عالي الجودة","99.99"
"PROD002","جهاز ويدجت قياسي","جهاز ويدجت أساسي","49.99"
3. استيراد افتراضي
الأفضل لـ: المحتوى العام، البيانات المختلطة
- يكشف تلقائيًا عن هيكل الأسئلة الشائعة أو المنتج
- يعود إلى استيراد مستندات عامة
- يتعامل مع تنسيقات CSV المختلفة
دليل خطوة بخطوة
الخطوة 1: الوصول إلى التكامل
- سجل الدخول إلى AI SmartTalk
- انتقل إلى الإدارة → مساعدي → [مساعدك]
- انقر على التكاملات → رابط CSV
الخطوة 2: إضافة رابط CSV
رابط فردي:
- انقر على إضافة رابط CSV جديد
- أدخل رابط ملف CSV
- قدم اسمًا اختياريًا
- اختر نوع الاستيراد (أسئلة شائعة/منتج/افتراضي)
- اختر الفئة (اختياري)
- انقر على إضافة رابط

استيراد جماعي:
- انقر على استيراد روابط جماعي
- أدخل الروابط (واحد في كل سطر)
- قم بتكوين الإعدادات المشتركة
- انقر على استيراد جميع الروابط

الخطوة 3: تكوين تطابق الأعمدة (للمنتج فقط)
قم بربط أعم دة CSV الخاصة بك بالحقول المتوقعة:
- عمود معرف المنتج: الافتراضي
idProduct→ ربط بـproduct_id,sku, إلخ. - عمود الاسم: الافتراضي
name→ ربط بـproduct_name,title, إلخ.
الخطوة 4: مراقبة الاستيراد
تتبع الحالة في تاريخ الاستيراد:
- معلق: في انتظار المعالجة
- مستورد: اكتمل بنجاح
- خطأ: فشل (عرض التفاصيل)

الخطوة 5: إعادة الاستيراد (تحديث البيانات)
- ابحث عن الرابط في التاريخ
- انقر على إعادة الاستيراد
- أكد الإجراء
- راقب الحالة المحدثة
الخطوة 6: التحقق من الاستيراد
- تحقق من قاعدة المعرفة للوثائق الجديدة
- اختبر chatbot بأسئلة حول المحتوى المستورد

متطلبات CSV
روابط صالحة
✅ https://example.com/data/products.csv
✅ https://cdn.company.com/catalog.csv
✅ https://raw.githubusercontent.com/user/repo/main/data.csv
❌ ftp://files.company.com/data.csv (FTP غير مدعوم)
❌ https://private.site.com/auth-data.csv (يتطلب مصادقة)
❌ file:///local/data.csv (الملفات المحلية غير مدعومة)
متطلبات الملف
- الوصول: متاح للجمهور عبر HTTP/HTTPS
- الرؤوس: يجب أن تحتوي الصف الأول على أسماء الأعمدة
- الفواصل: فاصلة (
,) أو فاصلة منقوطة (;) - الترميز: يوصى باستخدام UTF-8
- الحجم: الحد الأقصى 10 ميغابايت لكل ملف
استكشاف الأخطاء وإصلاحها
الأخطاء الشائعة
| الخطأ | الحل |
|---|---|
| الرابط غير متاح | تحقق من أن الرابط عام وصالح |
| تنسيق غير صالح | تحقق من الفاصل والرؤوس |
| الأعمدة المفقودة | تأكد من وجود الأعمدة المطلوبة (سؤال/جواب أو idProduct) |
| انتهاء مهلة الملف الكبير | قسم الملف أو قلل الحجم إلى أقل من 10 ميغابايت |
خطوات الحل
- اختبر الرابط في المتصفح
- تحقق من هيكل CSV والترميز
- راجع رسائل الخطأ في تاريخ الاستيراد
- اختبر باستخدام ملف عينة أصغر
- اتصل بالدعم إذا استمرت المشكلة
أفضل الممارسات
إدارة URL
- استخدم URLs مستقرة ودائمة
- اختبر URLs شهريًا للتأكد من الوصول إليها
- استخدم CDN لتحسين الأداء
- أدرج الإصدار في أسماء الملفات:
products-v2024.csv
تنظيم البيانات
- استخدم أسماء فئات واضحة
- حافظ على تنسيقات CSV متسقة
- نظف البيانات قبل الاستيراد (قم بإزالة الصفوف الفارغة)
- احتفظ بالملفات أقل من 10 ميجابايت
الأداء
- اختبر مع عينات صغيرة أولاً
- قم بمعالجة الاستيرادات الكبيرة خلال ساعات الذروة المنخفضة
- استخدم الاستيراد الجماعي لعدة URLs ذات صلة
- راقب معدل نجاح الاستيراد بانتظام
الأمان
- ✅ نقل مشفر عبر HTTPS
- ✅ التحقق من صحة URL
- ✅ التحكم في الوصول بناءً على الأذونات
- ✅ معالجة الملفات المؤقتة (بدون تخزين دائم)
- ✅ التنظيف التلقائي للبيانات القديمة
- ✅ سجلات التدقيق لجميع الأنشطة
بعد الاستيراد
بمجرد استيراد بياناتك:
- تصبح قابلة للبحث في قاعدة المعرفة
- تدعم استجابات chatbot على الفور
- تظهر منظمة حسب الفئات
- يمكن التحقق منها في قسم قاعدة المعرفة
تحقق من استيرادك:
- تحقق من قاعدة المعرفة للوثائق الجديدة
- اختبر chatbot بأسئلة حول المحتوى المستورد
- راجع الفئات والتنظيم
الدعم
تحتاج مساعدة؟
- 📧 البريد الإلكتروني: contact@aismarttalk.tech
- 📚 الوثائق: https://docs.aismarttalk.tech/
الملخص
يمكنك الآن:
- ✅ استيراد بيانات CSV من URLs العامة
- ✅ التعامل مع أنواع البيانات FAQ، المنتج، والبيانات العامة
- ✅ استيراد جماعي لمصادر متعددة
- ✅ رسم الأعمدة المخصصة للمنتجات
- ✅ مراقبة وإدارة الاستيرادات
- ✅ تحديث البيانات من خلال إعادة الاستيراد
الخطوات التالية:
- اختبر مع ملف CSV عينة
- استورد بيانات الإنتاج الخاصة بك
- قم بإعداد الفئات
- جدولة إعادة الاستيرادات بانتظام
- راقب الأداء
أسئلة؟ اتصل بفريق الدعم لدينا في أي وقت.