يشرح هذا الدليل كيفية تمكين واستخدام دعم ملفات PDF الأصلية وإرفاق المستندات عند التفاعل مع روبوتات الذكاء الاصطناعي في ديسكورس (Discourse). يمكن للمستخدمين تحميل ملفات PDF ومستندات أخرى مباشرة في المحادثات مع وكلاء الذكاء الاصطناعي.
مستوى المستخدم المطلوب: مسؤول (Administrator)
ملخص
يدعم Discourse AI الآن معالجة المرفقات الأصلية، مما يسمح للمستخدمين بتحميل ملفات PDF وأنواع المستندات الأخرى مباشرة عند التحدث مع روبوتات الذكاء الاصطناعي. يمكن للذكاء الاصطناعي قراءة وفهم محتوى هذه المرفقات، مما يتيح حالات استخدام مثل تحليل المستندات، والتلخيص، والإجابة على الأسئلة بناءً على الملفات المحملة.
تتطلب هذه الميزة:
- أنواع المرفقات المسموح بها (Allowed attachment types) مُعدّة في نموذج اللغة الكبير (LLM).
- وجود وكيل (agent) لديه خاصية الرؤية (vision) مُفعلة (هذا يتحكم فيما إذا كانت التحميلات مُضمنة في الرسائل).
- أن يكون امتداد الملف مُصرّحًا به في إعدادات التحميل لموقعك.
المزوّدون المدعومون
يعمل دعم المرفقات الأصلي مع النماذج من المزوّدين التاليين:
- أنثروبيك (Anthropic) (نماذج كلود Claude)
- AWS بيدروك (AWS Bedrock) (نماذج كلود عبر بيدروك)
- جوجل (Google) (نماذج جيميني Gemini)
- أوبن إيه آي (OpenAI) (نماذج جي بي تي GPT)
- أزور (Azure) (النماذج المتوافقة مع OpenAI)
- أوبن راوتر (OpenRouter) (النماذج المتوافقة مع OpenAI)
يتعامل كل مزوّد مع المرفقات بشكل مختلف على مستوى واجهة برمجة التطبيقات (API)، ولكن Discourse AI يدير ذلك تلقائيًا. ضع في اعتبارك أن المزوّدين المختلفين يطبقون مستويات مختلفة من الدعم لأنواع المرفقات المختلفة.
أنواع المرفقات المدعومة
يمكن تكوين أنواع المستندات التالية للمعالجة بواسطة الذكاء الاصطناعي:
| النوع | الامتدادات |
|---|---|
pdf |
|
| نص عادي | txt |
| مايكروسوفت وورد | doc, docx |
| تنسيق النص المنسق | rtf |
| HTML | html, htm |
| ماركداون | md, markdown |
يتم التعامل مع الصور بشكل منفصل من خلال إعداد “تمكين الرؤية” (Vision enabled) ولا تتطلب تكوين نوع المرفق.
التكوين
الخطوة 1: التصريح عن امتدادات الملفات للتحميل
قبل أن يتمكن المستخدمون من تحميل المرفقات، تأكد من التصريح عن امتدادات الملفات في إعدادات موقعك.
- انتقل إلى مسؤول (Admin) ← ملفات (Files)
- ابحث عن الإعداد
authorized extensions(الامتدادات المصرح بها) - أضف الامتدادات التي تريد السماح بها (على سبيل المثال،
pdf|txt|docx)
الخطوة 2: تكوين نموذج اللغة الكبير (LLM)
- انتقل إلى مسؤول (Admin) ← الإضافات (Plugins) ← Discourse AI ← نماذج اللغة الكبيرة (LLMs)
- حدد نموذج LLM الذي تريد تكوينه (أو أنشئ نموذجًا جديدًا)
- في حقل المرفقات المسموح بها (Allowed attachments)، حدد أو اكتب امتدادات الملفات التي تريد أن يقبلها النموذج (على سبيل المثال،
pdf،txt،docx)
إذا تركت حقل “المرفقات المسموح بها” فارغًا، سيتم تعطيل إرفاقات المستندات لهذا النموذج. يتم التحكم في الصور بشكل منفصل عبر مفتاح التبديل “تمكين الرؤية”.
الخطوة 3: تكوين الوكيل (Agent)
- انتقل إلى مسؤول (Admin) ← الإضافات (Plugins) ← Discourse AI ← الوكلاء (Agents)
- حدد وكيلًا أو أنشئ واحدًا
- تأكد من تشغيل تمكين الرؤية (Vision enabled) — هذا يتحكم فيما إذا كانت التحميلات (الصور والمستندات) مُضمنة في الرسائل المُرسلة إلى LLM
- قم بتعيين النموذج الافتراضي (Default model) لنموذج LLM تم تكوين المرفقات له
كيف تعمل
عندما يقوم مستخدم بتحميل مستند في محادثة مع روبوت ذكاء اصطناعي:
- يتم تحميل المستند إلى ديسكورس باستخدام معالجة التحميل القياسية.
- يقوم Discourse AI بتشفير محتوى المستند (base64).
- يتم إرسال المحتوى المُشفر إلى LLM جنبًا إلى جنب مع رسالة المستخدم.
- يقوم LLM بمعالجة رسالة النص ومحتوى المستند.
- يستجيب الذكاء الاصطناعي بناءً على السياق المدمج.
التفاصيل التقنية
- يتم تشفير المستندات كـ base64 وإرسالها مضمنة مع الطلب.
- يتلقى كل مزود المرفقات بتنسيقه الأصلي:
- أنثروبيك (Anthropic): يستخدم النوع
documentمع مصدر base64. - جيميني (Gemini): يستخدم تنسيق
inlineData. - أوبن إيه آي (OpenAI) (واجهة برمجة تطبيقات إكمال الدردشة Chat Completions API): يستخدم النوع
fileمعfile_dataيحتوي على محتوى base64. - أوبن إيه آي (OpenAI) (واجهة برمجة تطبيقات الاستجابات Responses API): يستخدم النوع
input_fileمعfile_dataيحتوي على محتوى base64.
- أنثروبيك (Anthropic): يستخدم النوع
- تخضع حدود حجم الملف لإعداد موقعك
max attachment size kb(الحد الأقصى لحجم المرفقات بالكيلوبايت).
حالات الاستخدام
يتيح دعم المرفقات الأصلي العديد من مسارات العمل:
- تحليل المستندات: قم بتحميل العقود أو التقارير أو الأوراق البحثية ليقوم الذكاء الاصطناعي بتلخيصها أو الإجابة على الأسئلة حولها.
- مراجعة المحتوى: اطلب من الذكاء الاصطناعي مراجعة مسودات المستندات وتقديم ملاحظات حولها.
- استخراج البيانات: استخراج معلومات محددة من المستندات المحملة.
- مساعدة الترجمة: تحميل مستندات بلغة واحدة ومناقشة المحتوى أو طلب ترجمات.
- الدعم الفني: يمكن للمستخدمين تحميل ملفات السجل أو ملفات التكوين للحصول على مساعدة في استكشاف الأخطاء وإصلاحها.
القيود
- حجم الملف: المرفقات محدودة بإعدادات حجم التحميل لموقعك وحدود مزود خدمة LLM.
- دعم المزوّد: يتطلب دعم المرفقات لهجة مزود (provider dialect) تتعامل مع المستندات (أنثروبيك، AWS بيدروك، جوجل، أوبن إيه آي، أزور، وأوبن راوتر).
- متطلبات رؤية الوكيل (Agent vision): يجب تشغيل “تمكين الرؤية” للوكيل ليتم تضمين التحميلات في الرسائل.
- مطابقة الامتداد: يجب أن يكون امتداد الملف مصرحًا به للتحميل على موقعك ومسموحًا به في تكوين أنواع مرفقات LLM.
- تختلف النتائج: نظرًا لأن مزودي خدمة LLM ونماذج LLM يعالجون الملفات، تختلف التكلفة / الدقة والنتائج. يميل أنثروبيك إلى استخدام رموز (tokens) أكثر للتحليل من أوبن إيه آي أو جوجل.
- تمكين التخزين المؤقت (Caching): بالنسبة لـ OpenAI، تأكد من استخدام واجهة برمجة تطبيقات الاستجابات التي توفر دعمًا أكثر اتساقًا للتخزين المؤقت (عند تمكين التفكير)؛ بالنسبة لنماذج أنثروبيك، قد تحتاج إلى تمكين التخزين المؤقت صراحةً في تكوين LLM. يمكن أن يكون هذا مهمًا بشكل خاص عند إجراء محادثات متعددة الأدوار.
استكشاف الأخطاء وإصلاحها
لا تتم معالجة المرفقات
- تحقق من أن امتداد الملف موجود في إعداد
authorized extensionsلموقعك. - تأكد من إدراج نوع الملف في إعداد “المرفقات المسموح بها” لنموذج LLM.
- تأكد من تشغيل “تمكين الرؤية” للوكيل واستخدامه لنموذج LLM مُكوّن بشكل صحيح.
فشل التحميل
- تحقق من الإعداد
max attachment size kb. - تحقق من أن امتداد الملف مُصرّح به.
- قد لا تكون ملفات PDF الكبيرة جدًا مدعومة؛ لكل مزود خدمة LLM أحجام تحميل قصوى مختلفة.
الذكاء الاصطناعي لا يفهم المستند
- تأكد من أنك تستخدم نموذجًا يدعم فهم المستندات.
- جرب نموذجًا أكثر قدرة (على سبيل المثال، Claude Sonnet 4.5، GPT-5.1، Gemini Pro 3).
الأسئلة الشائعة
هل يمكن للمستخدمين تحميل مستندات متعددة في رسالة واحدة؟
نعم، يمكن للمستخدمين تضمين مرفقات متعددة في رسالة واحدة، وسيكون لدى الذكاء الاصطناعي إمكانية الوصول إليها جميعًا.
هل يعمل هذا في الدردشة بالإضافة إلى الرسائل الخاصة؟
نعم، يعمل دعم المرفقات في الرسائل الخاصة مع روبوتات الذكاء الاصطناعي وفي الرسائل المباشرة للدردشة، شريطة أن يكون الوكيل مُكوّنًا لتلك طرق التفاعل.
هل هذا يختلف عن تحميلات RAG على الوكلاء؟
نعم. تُعد تحميلات RAG مستندات يضيفها المسؤولون إلى قاعدة معارف الوكيل، ويتم فهرستها والبحث فيها. يسمح دعم المرفقات الأصلي للمستخدمين النهائيين بتحميل المستندات أثناء المحادثات للتحليل الفوري دون فهرسة.
ماذا يحدث للمستندات التي تم تحميلها؟
تتم معالجة المستندات وفقًا لمعالجة التحميل القياسية وسياسات الاحتفاظ لموقعك. يتم تخزينها كتحميلات ديسكورس عادية.