لتوسيم المستندات تلقائيًا، قدم للوكيل الذكي تعليمًا ثابتًا واحدًا ودعه يستدعي أداة وضع علامة مائية على الصورة محليًا لكل ملف في مجلد الإخراج. مع خادم GroupDocs.Watermark.Mcp يمكن أن يكون هذا التعليم سطرًا واحدًا في ملف قواعد، أو تعليمًا للمشروع في Claude Code، أو موجهًا تلصقه في Cursor:

ضع logo.png على كل صفحة من كل ملف في مجلد الإخراج بنسبة شفافية 25٪، ثم أدرج الملفات التي أنشأتها.

الإصدار خطوة بخطوة مع الإعدادات واستكشاف الأخطاء موجود في الوثائق: How to brand documents with a logo watermark using AI.

لماذا يختلف التوسيم اليدوي؟

التوسيم الذي يتم يدويًا يختلف من شخص لآخر: فريق يلصق الشعار في ملف المصدر، آخر يطبع الـ PDF بقوة كاملة، وثالث ينسى. نموذج لغة كبير “يضيف شعارًا” عن طريق تعديل محتوى المستند لا يضمن موضعًا ثابتًا أيضًا. أداة add_image_watermark تطبق الشعار ككائن علامة مائية، مع قيم صريحة لـ opacity و rotation، لذا فإن نفس المدخلات تعطي نفس القوة والزواية. وبما أنه كائن وليس محتوى ملصوق، يمكن العثور على الشعار وإزالته لاحقًا عندما يتغير العلامة التجارية.

ماذا يقرر الوكيل، وماذا يفعل المحرك؟

الخطوة ما يقرره الوكيل ما يفعله المحرك
تحديد الملفات ضمن النطاق يقرأ المجلد وتعليمك لا شيء
اختيار الأداة للاستدعاء add_image_watermark للشعار، add_watermark للحالة لا شيء
القوة والزواية يمرر opacity و rotation من تعليمك القياسي يرسم العلامة بالقيم المحددة
النتيجة يبلّغ عن الملفات التي تم إنتاجها يكتب ملفًا جديدًا؛ الأصلي لا يتغير

القياس القياسي موجود في موجهك. الخادم لا يحدد نفسه ولا يمتلك سياسة علامة تجارية مدمجة؛ الجزء القابل للتكرار هو التعليم الذي تحفظه وتعيد استخدامه.

كيف تفرض المعيار في خمس خطوات؟

  1. احفظ الشعار بجانب المستندات. يتم حل كل من المستند والصورة بالاسم من مجلد التخزين (GROUPDOCS_MCP_STORAGE_PATH). استخدم PNG شفاف؛ الشعار على مستطيل أبيض سيظهر ذلك المستطيل فوق الصفحة.
  2. افصل ملفات الإخراج. اضبط GROUPDOCS_MCP_OUTPUT_PATH إلى مجلد مختلف إذا أردت حفظ النسخ الموسومة بعيدًا عن المصادر. إذا لم يُحدد، يذهب الإخراج إلى مجلد التخزين.
  3. تحقق من الترخيص. اسأل: “ما هو حالة ترخيص خادم العلامة المائية؟” يستدعي الوكيل get_license_status.
  4. شغّل الموجه القياسي. الشفافية بين 0.2 و0.4 هي النطاق الذي توصي به الوثائق للتوسيم؛ فوق 0.6 يهيمن الشعار على الصفحة.
  5. تحقق. اطلب تمريرة search_watermarks على كل ملف تم إنتاجه وقارن العدد بما تتوقعه.

هل يمكن للعلامة أن تعبر أيضًا عن حالة؟

نعم، عبر استدعاء متسلسل ثاني. وسّم وأضف الحالة في طلب واحد:

أضف الشعار بنسبة شفافية 25٪، ثم أضف علامة مائية نصية CONFIDENTIAL إلى تلك النتيجة.

كل استدعاء يكتب ملفًا جديدًا، لذا فإن “إلى تلك النتيجة” هو ما يحافظ على كلا العلامتين.

جلسة مثال (مختصرة)

You:    Put logo.png on report.pdf at 30% opacity.
Agent:  [add_image_watermark: watermarkImage logo.png, opacity 0.3]
        Added image watermark from "logo.png" to "report.pdf"
You:    That is too strong - redo it at 0.2.
Agent:  [add_image_watermark: opacity 0.2, from the original report.pdf]
        Added image watermark from "logo.png" to "report.pdf"
        Two branded copies exist. Delete the 0.3 copy if you do not need it.

التكرار بهذه الطريقة آمن لأن كل محاولة تُنتج ملفًا جديدًا. احذف الملفات المرفوضة بعد ذلك.

أي قناة توصيل تناسب نشر الفريق؟

في إعداد مشترك، صورة Docker تتجنب تثبيت أي شيء آخر على كل جهاز، لأن وقت التشغيل والاعتمادات الأصلية داخلها:

docker run --rm -i -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-watermark/watermark-net-mcp:latest

قناة NuGet (dnx GroupDocs.Watermark.Mcp --yes) تحتاج إلى SDK .NET 10. كلاهما يعمل على Windows وLinux وmacOS (dnx على Linux/macOS يحتاج أيضًا إلى libgdiplus)، وكلاهما يستخدم نفس الأدوات الست، لذا لا يتغير موجه العلامة بينهما.

ما هي الحدود؟

خطط حول حدين. أولًا، الأداة تكشف فقط عن opacity و rotation: لا توجد إعدادات للموقع أو الحجم أو الهوامش. ثانيًا، وضع التقييم: صفحة ترخيص الخادم تقول إن الإخراج غير المرخص يحمل قيود تقييم (الحدود الدقيقة موجودة في licensing page)، لذا النسخ الموسومة التي تُنتج بدون ترخيص لا يمكن توزيعها. شغّل get_license_status قبل نشر العلامة. تحت الترخيص القائم على الاستهلاك يُفوتر كل ملف يُعالج، وتحت ترخيص ملف يعمل الخادم دون اتصال. أيضًا ضع في اعتبارك أن العلامة المائية تُلصق المستند؛ لا تحمي المحتوى الموجود تحته.

الأسئلة المتكررة

هل يمكن للذكاء الاصطناعي إضافة شعار شركتنا إلى جميع ملفات PDF؟
نعم. اطلب الشعار باسم الملف وعيّن شفافية؛ يستدعي الوكيل add_image_watermark مرة لكل ملف. نفس الاستدعاء يعمل أيضًا على ملفات Word وPowerPoint وExcel والصور.

هل يمكنني استخدام نفس الشعار على الصور والمستندات؟
نعم. الصور هي أهداف صالحة، لذا يمكن توسيع العلامة على صور المنتجات كما تُوسم ملفات PDF.

ماذا يحدث عندما تتغير العلامة التجارية؟
يمكن لـ remove_watermarks إزالة الشعار القديم، لأنه طُبق ككائن علامة مائية. خاصية textFilter تطابق نص العلامة المائية فقط، لذا إزالة شعار صورة يعني إزالة جميع العلامات المائية، بما فيها النصية. ابحث أولًا لتعرف ما هو موجود، ثم أضف الشعار الجديد.

تعمق أكثر