استخدام دعم ملفات PDF والمرفقات مع روبوتات الذكاء الاصطناعي

:bookmark: يشرح هذا الدليل كيفية تمكين واستخدام دعم المرفقات الأصلية لملفات PDF والمستندات عند التفاعل مع الروبوتات الذكية (AI) في Discourse. يمكن للمستخدمين تحميل ملفات PDF والمستندات الأخرى مباشرة في المحادثات مع وكلاء الذكاء الاصطناعي.

:person_raising_hand: مستوى المستخدم المطلوب: مسؤول (Administrator)

ملخص

يدعم الآن Discourse AI معالجة المرفقات الأصلية، مما يسمح للمستخدمين بتحميل ملفات PDF وأنواع المستندات الأخرى مباشرة أثناء المحادثة مع روبوتات الذكاء الاصطناعي. يمكن للذكاء الاصطناعي قراءة وفهم محتوى هذه المرفقات، مما يتيح حالات استخدام مثل تحليل المستندات، والتلخيص، والإجابة عن الأسئلة بناءً على الملفات المرفوعة.

تتطلب هذه الميزة:

  • أنواع مرفقات مسموح بها مُهيأة في نموذج اللغة الكبير (LLM)
  • وكيل (Agent) مفعّل فيه خيار الرؤية (Vision) (هذا يتحكم في ما إذا كانت التحميلات مشمولة في الرسائل)
  • امتداد الملف يكون مفوضاً في إعدادات التحميل الخاص بموقعك

الموفرون المدعومون

يعمل دعم المرفقات الأصلية مع النماذج من الموردين التاليين:

  • Anthropic (نماذج Claude)
  • AWS Bedrock (نماذج Claude عبر Bedrock)
  • Google (نماذج Gemini)
  • OpenAI (نماذج GPT)
  • Azure (النماذج المتوافقة مع OpenAI)
  • OpenRouter (النماذج المتوافقة مع OpenAI)

يتعامل كل موفر مع المرفقات بشكل مختلف على مستوى واجهة برمجة التطبيقات (API)، لكن Discourse AI يدير هذا تلقائياً. ضع في اعتبارك أن الموفرين المختلفين ينفذون مستويات دعم مختلفة لأنواع مرفقات متنوعة.

أنواع المرفقات المدعومة

يمكن تهيئة أنواع المستندات التالية لمعالجة الذكاء الاصطناعي:

النوع الامتدادات
PDF pdf
نص عادي txt
Microsoft Word doc, docx
Rich Text Format rtf
HTML html, htm
Markdown md, markdown

:information_source: يتم التعامل مع الصور بشكل منفصل من خلال إعداد “Vision enabled” ولا تتطلب تهيئة نوع المرفق.

التهيئة

الخطوة 1: تفويض امتدادات الملفات للتحميل

قبل أن يتمكن المستخدمون من تحميل المرفقات، تأكد من أن امتدادات الملفات مفوضة في إعدادات موقعك.

  1. انتقل إلى Admin ← Files
  2. ابحث عن إعداد authorized extensions
  3. أضف الامتدادات التي تريد السماح بها (مثال: pdf|txt|docx)

الخطوة 2: تهيئة نموذج اللغة الكبير (LLM)

  1. انتقل إلى Admin ← Plugins ← Discourse AI ← LLMs
  2. حدد نموذج اللغة الكبير الذي تريد تهيئته (أو أنشئ واحداً جديداً)
  3. في حقل Allowed attachments، حدد أو اكتب امتدادات الملفات التي تريد أن يقبلها النموذج (مثال: pdf، txt، docx)

:warning: إذا تركت حقل “Allowed attachments” فارغاً، فسيتم تعطيل مرفقات المستندات لذلك النموذج. يتم التحكم في الصور بشكل منفصل عبر مفتاح التبديل “Vision enabled”.

الخطوة 3: تهيئة الوكيل (Agent)

  1. انتقل إلى Admin ← Plugins ← Discourse AI ← Agents
  2. حدد وكيلاً أو أنشئ واحداً
  3. تأكد من تفعيل Vision enabled — هذا يتحكم في ما إذا كانت التحميلات (كل من الصور والمستندات) مشمولة في الرسائل المرسلة إلى نموذج اللغة الكبير
  4. اضبط Default model على نموذج لغة كبير مُهيأ للمرفقات

كيفية عمل الميزة

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

  1. يتم تحميل المستند إلى Discourse باستخدام معالجة التحميل القياسية
  2. يرمّز Discourse AI محتوى المستند (base64)
  3. يتم إرسال المحتوى المشفر إلى نموذج اللغة الكبير جنباً إلى جنب مع رسالة المستخدم
  4. يعالج نموذج اللغة الكبير كل من الرسالة النصية ومحتوى المستند
  5. يستجيب الذكاء الاصطناعي بناءً على السياق المشترك

تفاصيل تقنية

  • يتم ترميز المستندات بصيغة base64 وإرسالها ضمن الطلب
  • يستقبل كل موفر المرفقات بصيغته الأصلية:
    • Anthropic: يستخدم نوع document مع مصدر base64
    • Gemini: يستخدم تنسيق inlineData
    • OpenAI (Chat Completions API): يستخدم نوع file مع file_data تحتوي على المحتوى المشفر base64
    • OpenAI (Responses API): يستخدم نوع input_file مع file_data تحتوي على المحتوى المشفر base64
  • تخضع حدود حجم الملف لإعداد موقعك max attachment size kb

حالات الاستخدام

يتيح دعم المرفقات الأصلية عدة سير عمل:

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

القيود

  • حجم الملف: تخضع المرفقات لحدود إعدادات حجم التحميل في موقعك ومورد نموذج اللغة الكبير
  • دعم الموفر: يتطلب دعم المرفقات لهجة موفر تتعامل مع المستندات (Anthropic، AWS Bedrock، Google، OpenAI، Azure، وOpenRouter)
  • متطلبات رؤية الوكيل: يجب أن يكون لدى الوكيل “Vision enabled” مفعلاً ليتم تضمين التحميلات في الرسائل
  • مطابقة الامتداد: يجب أن يكون امتداد الملف مفوضاً للتحميل في موقعك ومسموحاً به في تهيئة أنواع مرفقات نموذج اللغة الكبير
  • تتفاوت النتائج: بما أن موردي نماذج اللغة الكبرى والنماذج نفسها تعالج الملفات بتكلفة ودقة مختلفتين، ستتفاوت النتائج. يميل Anthropic إلى استخدام عدد أكبر من الرموز (Tokens) للتحليل مقارنة بـ OpenAI أو Google.
  • تفعيل التخزين المؤقت: بالنسبة لـ Open AI، تأكد من استخدام Responses API التي تقدم دعماً أكثر اتساقاً للتخزين المؤقت (عند تفعيل التفكير). بالنسبة لنماذج Anthropic، قد تحتاج إلى تفعيل التخزين المؤقت صراحةً في تهيئة LLM. وهذا مهم بشكل خاص عند إجراء محادثات متعددة الجولات.

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

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

  1. تحقق من وجود امتداد الملف في إعداد authorized extensions الخاص بموقعك
  2. تأكد من أن نوع الملف مدرج في إعداد “Allowed attachments” لنموذج اللغة الكبير
  3. تأكد من أن الوكيل لديه “Vision enabled” مفعلاً ويستخدم نموذج لغة كبير مُهيأ بشكل صحيح

يفشل التحميل

  • تحقق من إعداد max attachment size kb الخاص بك
  • تحقق من أن امتداد الملف مفوض
  • قد لا يتم دعم ملفات PDF الكبيرة جداً، فلكل مورد نموذج لغة كبير أحجام تحميل قصوى مختلفة.

لا يفهم الذكاء الاصطناعي المستند

  • تأكد من أنك تستخدم نموذجاً يدعم فهم المستندات
  • جرب نموذجاً أكثر قدرة (مثال: Claude Sonnet 4.5، GPT-5.1، Gemini Pro 3)

الأسئلة الشائعة

هل يمكن للمستخدمين تحميل مستندات متعددة في رسالة واحدة؟
نعم، يمكن للمستخدمين تضمين مرفقات متعددة في رسالة واحدة، وسيتمكن الذكاء الاصطناعي من الوصول إلى جميعها.

هل يعمل هذا في الدردشة أيضاً كما في الرسائل الخاصة؟
نعم، يعمل دعم المرفقات في كل من الرسائل الخاصة مع روبوتات الذكاء الاصطناعي ورسائل الدردشة المباشرة، بشرط أن يكون الوكيل مُهيأ لهذه طرق التفاعل.

هل هذا مختلف عن تحميلات RAG للوكلاء؟
نعم. تحميلات RAG هي مستندات يضيفها المسؤولون إلى قاعدة معرفة الوكيل، حيث يتم فهرستها والبحث فيها. يتيح دعم المرفقات الأصلية للمستخدمين النهائيين تحميل المستندات أثناء المحادثات للتحليل الفوري دون فهرسة.

ماذا يحدث للمستندات المرفوعة؟
يتم معالجة المستندات وفقاً لمعالجة التحميل القياسية وسياسات الاحتفاظ في موقعك. يتم تخزينها كعمليات تحميل Discourse عادية.

موارد إضافية

7 إعجابات