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

تكامل URL لملفات CSV

استورد المستندات مباشرة من ملفات CSV المتاحة للجمهور عبر URL إلى قاعدة معرفة مساعدك الذكي.

البداية السريعة​

ابدأ في 3 خطوات:

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

نصيحة: اختبر باستخدام ملف CSV صغير أولاً لتتعرف على العملية.

نظرة عامة على تكامل URL لملفات CSV

ما يمكنك القيام به​

  • ✅ استيراد من URLs لملفات CSV العامة عبر HTTP/HTTPS
  • ✅ استيراد دفعة واحدة لعدة URLs في آن واحد
  • ✅ الكشف التلقائي عن هيكل CSV (أسئلة متكررة، منتج، أو عام)
  • ✅ تعيين الفئات ورسم الأعمدة المخصصة
  • ✅ تتبع حالة الاستيراد والتاريخ

المتطلبات الأساسية​

  • وصول إداري إلى مساعدك الذكي AI SmartTalk
  • ملفات CSV متاحة للجمهور (لا يتطلب مصادقة)
  • هيكل CSV صحيح مع رؤوس الأعمدة
  • يوصى باستخدام ترميز UTF-8

أنواع الاستيراد​

1. استيراد الأسئلة الشائعة​

الأفضل لـ: وثائق الدعم، قواعد المعرفة

الأعمدة المطلوبة:

  • question
  • answer

مثال:

question,answer
"كيف يمكنني إعادة تعيين كلمة المرور الخاصة بي؟","انقر على 'نسيت كلمة المرور' واتبع التعليمات."
"ما هي ساعات العمل الخاصة بكم؟","من الاثنين إلى الجمعة، من 9 صباحًا إلى 6 مساءً."

2. استيراد المنتج​

الأفضل لـ: كتالوجات التجارة الإلكترونية، المخزون

العمود المطلوب:

  • idProduct (أو عمود مخصص)

اختياري:

  • name (أو عمود مخصص)

مثال:

idProduct,name,description,price
"PROD001","وحدة متميزة","وحدة عالية الجودة","99.99"
"PROD002","وحدة قياسية","وحدة أساسية","49.99"

3. استيراد افتراضي​

الأفضل لـ: محتوى عام، بيانات مختلطة

  • يكتشف تلقائيًا هيكل الأسئلة الشائعة أو المنتج
  • يعود إلى استيراد مستندات عامة
  • يتعامل مع تنسيقات CSV المختلفة

دليل خطوة بخطوة​

الخطوة 1: الوصول إلى التكامل​

  1. تسجيل الدخول إلى AI SmartTalk
  2. انتقل إلى الإدارة → مساعدي → [مساعدك]
  3. انقر على التكاملات → CSV URL

الخطوة 2: إضافة عنوان URL لـ CSV​

عنوان URL واحد:

  1. انقر على إضافة عنوان URL جديد لـ CSV
  2. أدخل عنوان URL لملف CSV
  3. قدم اسمًا اختياريًا
  4. اختر نوع الاستيراد (FAQ/منتج/افتراضي)
  5. اختر الفئة (اختياري)
  6. انقر على إضافة عنوان URL

نموذج استيراد CSV URL واحد

الاستيراد بالجملة:

  1. انقر على استيراد عناوين URL بالجملة
  2. أدخل عناوين URL (واحد في كل سطر)
  3. قم بتكوين الإعدادات المشتركة
  4. انقر على استيراد جميع عناوين URL

استيراد CSV URL بالجملة

الخطوة 3: تكوين تطابق الأعمدة (للمنتج فقط)​

قم بربط أعمدة CSV الخاصة بك بالحقول المتوقعة:

  • عمود ID المنتج: الافتراضي idProduct → ربط بـ product_id, sku, إلخ.
  • عمود الاسم: الافتراضي name → ربط بـ product_name, title, إلخ.

Step 4: Monitor Import​

تتبع الحالة في سجل الاستيراد:

  • Pending: في انتظار المعالجة
  • Imported: اكتمل بنجاح
  • Error: فشل (عرض التفاصيل)

Import Status Dashboard

Step 5: Re-import (Update Data)​

  1. ابحث عن URL في السجل
  2. انقر على Re-import
  3. أكد الإجراء
  4. راقب الحالة المحدثة

Step 6: Verify Import​

  1. تحقق من قاعدة المعرفة للوثائق الجديدة
  2. اختبر الدردشة الآلية بأسئلة حول المحتوى المستورد

Post-Import Knowledge Base

متطلبات CSV​

عناوين URL صالحة​

✅ 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 موصى به
  • الحجم: الحد الأقصى 10MB لكل ملف

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

الأخطاء الشائعة​

الخطأالحل
الرابط غير متاحتحقق من أن الرابط عام وصحيح
تنسيق غير صالحتحقق من الفاصل والرؤوس
أعمدة مفقودةتأكد من وجود الأعمدة المطلوبة (سؤال/جواب أو idProduct)
انتهاء مهلة الملف الكبيرقم بتقسيم الملف أو تقليل الحجم إلى أقل من 10 ميجابايت

خطوات الحل​

  1. اختبر الرابط في المتصفح
  2. تحقق من هيكل CSV والترميز
  3. راجع رسائل الخطأ في سجل الاستيراد
  4. اختبر باستخدام ملف عينة أصغر
  5. اتصل بالدعم إذا استمرت المشكلة

أفضل الممارسات​

إدارة الروابط​

  • استخدم روابط مستقرة ودائمة
  • اختبر الروابط شهريًا للتأكد من الوصول إليها
  • استخدم CDN لتحسين الأداء
  • قم بتضمين الإصدار في أسماء الملفات: products-v2024.csv

تنظيم البيانات​

  • استخدم أسماء فئات واضحة
  • حافظ على تنسيقات CSV متسقة
  • نظف البيانات قبل الاستيراد (قم بإزالة الصفوف الفارغة)
  • احتفظ بالملفات تحت 10MB

الأداء​

  • اختبر مع عينات صغيرة أولاً
  • قم بمعالجة الاستيرادات الكبيرة خلال ساعات الذروة المنخفضة
  • استخدم الاستيراد بالجملة لعدة روابط ذات صلة
  • راقب معدل نجاح الاستيراد بانتظام

الأمان​

  • ✅ نقل مشفر عبر HTTPS
  • ✅ تحقق من صحة الروابط
  • ✅ التحكم في الوصول بناءً على الأذونات
  • ✅ معالجة الملفات المؤقتة (بدون تخزين دائم)
  • ✅ تنظيف تلقائي للبيانات القديمة
  • ✅ سجلات تدقيق لجميع الأنشطة

بعد الاستيراد​

بمجرد الاستيراد، تصبح بياناتك:

  1. قابلة للبحث في قاعدة المعرفة
  2. تدعم استجابات الدردشة الآلية على الفور
  3. تظهر منظمة حسب الفئات
  4. يمكن التحقق منها في قسم قاعدة المعرفة

تحقق من استيرادك:

  • تحقق من قاعدة المعرفة للوثائق الجديدة
  • اختبر الدردشة الآلية بأسئلة حول المحتوى المستورد
  • راجع الفئات والتنظيم

الدعم​

تحتاج إلى مساعدة؟

الملخص​

يمكنك الآن:

  • ✅ استيراد بيانات CSV من عناوين URL العامة
  • ✅ التعامل مع أنواع البيانات FAQ، والمنتجات، والبيانات العامة
  • ✅ استيراد جماعي لمصادر متعددة
  • ✅ تخصيص أعمدة مخصصة للمنتجات
  • ✅ مراقبة وإدارة الاستيرادات
  • ✅ تحديث البيانات من خلال إعادة الاستيراد

الخطوات التالية:

  1. اختبر باستخدام ملف CSV عينة
  2. استورد بيانات الإنتاج الخاصة بك
  3. قم بإعداد الفئات
  4. جدولة إعادة الاستيراد بانتظام
  5. مراقبة الأداء

أسئلة؟ اتصل بفريق الدعم لدينا في أي وقت.