ابنِ وكيل ذكاء اصطناعي يُنشئ الكتب التفاعلية

ماذا لو كان “انشر تقرير هذا الشهر كأنه كتاب تفاعلي” أمراً يفعله حاسوبك من تلقاء نفسه — بلا لوحة تحكم، بلا رفع، وبلا نسخ رابط مشاركة ولصقه في رسالة بريد؟ هذا هو وعد وكيل الذكاء الاصطناعي للمستندات: تصف أنت النتيجة المطلوبة، فيستدعي الوكيل الأدوات المناسبة بالترتيب الصحيح حتى يحققها.

يوضّح لك هذا الدرس كيف تبني واحداً عبر خادم FlipLink MCP وClaude. سيأخذ الوكيل تقرير PDF أُنشئ للتو، وينشئ منه كتاباً تفاعلياً، وينشره، ويعيد إليك رابط مشاركة — وهو بالضبط ما يمكنك جدولته ثم نسيانه. وسنكون صريحين أيضاً بشأن النقطة التي يصطدم فيها الوكيل المؤتمت بالكامل بحدود حقيقية، ومتى يكون السكربت البسيط (CLI) هو الأداة الأنسب.

السيناريو: تقرير شهري يُنشر تلقائياً

تخيّل مهمة متكررة. في الأول من كل شهر، تُنتج إحدى العمليات ملف report.pdf — أرقام مبيعات، أو نشرة بريدية، أو عرض مجلس إدارة. اليوم يقوم شخص برفعه إلى لوحة التحكم، وينشره، وينسخ الرابط، ويلصقه في مكان ما. نريد أتمتة ذلك بوكيل قادر على التفكير في الخطوات بدلاً من أن نبرمج كل خطوة يدوياً.

يحتاج الوكيل إلى أن يكون قادراً على: إنشاء كتاب تفاعلي من الملف، ونشره، وجلب رابط المشاركة. ومع توصيل خادم FlipLink MCP، تتطابق هذه المهام مع أدوات حقيقية يستطيع النموذج استدعاءها مباشرةً.

الخطوة 1 — توصيل خادم MCP

بروتوكول Model Context Protocol هو الطريقة التي يكتشف بها عميل الذكاء الاصطناعي (Claude وCursor وغيرهما) الأدوات الخارجية ويستدعيها. ويعرض خادم FlipLink MCP واجهة FlipLink API كمجموعة من الأدوات التي يمكن للنموذج استخدامها داخل المحادثة.

للاطلاع على الشرح الكامل، راجع وصِّل FlipLink بـ Claude عبر خادم MCP. أما النسخة المختصرة — فلا شيء تثبّته يدوياً، إذ يُشغّله عميلك عبر npx:

claude mcp add fliplink -e FLIPLINK_API_KEY=YOUR_API_KEY -- npx -y fliplink-mcp

أو على هيئة كتلة إعداد mcpServers (Claude Desktop وCursor وCodex):

{
  "mcpServers": {
    "fliplink": {
      "command": "npx",
      "args": ["-y", "fliplink-mcp"],
      "env": { "FLIPLINK_API_KEY": "YOUR_API_KEY", "FLIPLINK_MCP_MODE": "safe" }
    }
  }
}

تُولَّد الأدوات من مواصفة FlipLink وتُسمّى وفق النمط <noun>_<verb> — وهكذا سيرى الوكيل أدوات مثل flipbook_create_by_file وflipbook_publish وflipbook_get_share_link، إضافةً إلى فحص صحة عام المستوى باسم whoami، وغيرها. احصل على مفتاحك بتسجيل الدخول من go.fliplink.me.

الخطوة 2 — اكتب موجّه الوكيل

الوكيل في حقيقته ليس سوى نموذج مقروناً بحلقة: يقرأ الهدف، ويقرر أي أداة يستدعي، ويقرأ النتيجة، ثم يقرر الخطوة التالية إلى أن يتحقق الهدف. وجودة تلك الحلقة تأتي بكاملها تقريباً من موجّه واضح يحدد الأدوات والترتيب وشرط النجاح.

إليك موجّه نظام/مهمة واقعي لوكيل التقرير الشهري:

SYSTEM:
You are a publishing agent for FlipLink. Your job is to turn a PDF report
into a published flipbook and return its share link. You have FlipLink MCP
tools available (names follow the pattern noun_verb).

Operating rules:
1. Start by calling `whoami` to confirm the API key works and check the
   remaining flipbook quota. If `whoami` fails, STOP and report the error.
2. Create the flipbook from the file with `flipbook_create_by_file`
   (field File = the PDF path; set Name and Title from the task).
3. Read the result. Every FlipLink response has a top-level `Result` field
   that is "OK" or "ERROR". If `Result` is "ERROR", STOP and report the
   `Message` — do NOT retry blindly or proceed.
4. On success, capture the returned flipbook ID.
5. Publish it with `flipbook_publish` using that ID. Check `Result` again.
6. Fetch the share link with `flipbook_get_share_link`.
7. Report back: the flipbook ID, the published share URL, and the quota left.

Never invent tool names or IDs. If a step has no clear next action,
stop and explain rather than guessing.

TASK:
Publish this month's report. File: ./reports/2026-06-report.pdf
Title: "June 2026 Report". Name: "june-2026-report".

أمران يجعلان هذا الموجّه ناجحاً. أولهما أنه يأمر الوكيل بأن يتفرّع بناءً على حقل Result — إذ تُعيد FlipLink أخطاء التطبيق على هيئة HTTP 200 مع Result: "ERROR"، ولذلك فإن فحصاً ساذجاً من نوع “هل أعاد الاستدعاء 200؟” سيعامل الإخفاقات بصمت على أنها نجاحات. وثانيهما أنه يمنح شرط توقّف صريحاً لكل مسار إخفاق، وهو ما يمنع التشغيل غير المراقَب من الدخول في دوامة من المحاولات المتكررة.

الخطوة 3 — ضوابط أمان للتشغيل غير المراقَب

هنا عليك أن تكون واضح النظرة. الوضع الافتراضي لـ MCP هو safe (79 أداة): عمليات قراءة إضافةً إلى عمليات كتابة قابلة للتراجع، مع عدم وجود أدوات حذف ولا أدوات تجارية. ووكيل التقرير الشهري لدينا لا يفعل سوى الإنشاء والنشر والقراءة — وكلها تندرج ضمن وضع safe — ولذلك يمكنك في هذه المهمة الإبقاء على الوضع الافتراضي ويعمل الوكيل من البداية إلى النهاية بلا أي عوائق.

أما الإجراءات المدمِّرة فقصة أخرى. إذا احتاج وكيلك يوماً إلى حذف كتاب تفاعلي أو التعامل مع التسعير/المبيعات، فعليه أن يعمل في وضع full (87 أداة). وفي وضع full، لا تعمل أدوات الحذف والمال أبداً من الاستدعاء الأول: يعيد الخادم معاينةً من سطر واحد إضافةً إلى رمز confirm_token قصير الأجل (مرتبط بالوسائط المحددة بالضبط، وتنتهي صلاحيته خلال 5 دقائق)، وعلى المساعد أن يستدعي مرةً أخرى بهذا الرمز. وتلك البوابة موجودة داخل الخادم — أما واجهة FlipLink API نفسها فلم تتغيّر.

كن صريحاً بشأن ما يعنيه هذا لمفهوم “الاستقلالية الكاملة”:

• يستطيع وكيلٌ يقرأ ويُنشئ ويَنشر في وضع safe أن يعمل بلا مراقبة وبسلاسة. فلا شيء يفعله خاضعٌ لبوابة.
• أما الوكيل الذي يحذف الأشياء فلا يمكنه أن يكون بلا عوائق وغير مراقَب في آنٍ واحد. فبوابة رمز التأكيد موجودة عن قصد. فإما أن يوافق شخصٌ على الخطوة المدمِّرة، أو أن يعمل إطار عملك في وضع full ويتعامل صراحةً في الشيفرة مع مصافحة المعاينة → رمز التأكيد → الاستدعاء الثاني. لا تصمّم خط معالجة يفترض أن كتاباً تفاعلياً سيحذف نفسه بصمت بلا تأكيد — فهذا لن يحدث، وذلك هو بيت القصيد.

للاطلاع على التفصيل الكامل للأوضاع وآلية رمز التأكيد، راجع أمان خادم MCP وضوابطه. كما تحمل الأدوات تعليقات MCP التوضيحية (readOnlyHint وdestructiveHint وidempotentHint) بحيث يستطيع إطار عمل متبصّر أن يقدّر المخاطر قبل أن يستدعي أي شيء.

🚀

جرّب FlipLink مجاناً

حوّل ملف PDF خلال ثوانٍ. لا تسجيل ولا بطاقة ائتمان — ارفع ملفك وانطلق.

Drop your PDF here or click to browse

الحجم الأقصى 40MB

الباقات المدفوعة من $39 ترفع هذا الحد إلى 150 MB.

الخطوة 4 — جدولتها

بمجرد أن يعمل الوكيل بموثوقية يدوياً، ضعه على مؤقّت. وتعتمد كيفية ذلك على عميلك — مهمة cron تستدعي Claude في وضع بلا واجهة مع موجّه المهمة، أو سير عمل مجدول، أو تنسيقك الخاص. والتفاصيل التقنية خارج نطاق هذا المقال؛ المهم أن الموجّه والوضع هما ما يجعلان التشغيل المجدول آمناً، لا المُجدوِل نفسه. أبقِ الوكيل في وضع safe لمهام الإنشاء/النشر، ويبقى التشغيل غير مراقَب دون أن يصطدم بجدار تأكيد.

الخطوة 5 — تحقّق من المُخرَج

لا تثق بعبارة “قال الوكيل إنه نجح.” تحقّق من الناتج الفعلي:

• ينبغي أن يتضمن التقرير النهائي للوكيل معرّف الكتاب التفاعلي ورابط مشاركة. افتح الرابط — يجب أن يحمّل الكتاب التفاعلي المنشور.
• افحص حصة whoami قبل التشغيل وبعده، حتى تعرف أن عملية الإنشاء استهلكت فعلاً خانةً واحدة بدلاً من أن تخفق بصمت.
• ولأن كل نتيجة أداة تحمل حقل Result، فإن وكيلاً محكم البناء يُظهر نص Message الدقيق عند الإخفاق. فإذا أبلغ التشغيل عن Result: "ERROR"، فاقرأ الرسالة بدلاً من إعادة التشغيل — إذ لن يُصلح حدُّ الحصة أو ملفٌ مفرط الحجم نفسه عند المحاولة من جديد.

متى يكون CLI هو الأداة الأنسب

إليك الوجه الصريح المقابل لكل ما سبق: بالنسبة لمهمة حتمية بلا واجهة داخل CI، فأنت في الغالب لا تريد وكيل نموذج لغوي على الإطلاق.

يتألق وكيل الذكاء الاصطناعي حين تتطلب المهمة حُكماً وتقديراً — كأن يقرر عنواناً لشيء ما، أو يتفاعل مع مدخلات غامضة، أو يربط خطوات لم تفصّلها بالكامل. أما “خذ هذا الملف بعينه، وأنشئ كتاباً تفاعلياً، وانشره، واطبع الرابط” فمهمة بلا أي غموض. وتشغيل نموذج لغوي من أجلها يضيف كلفةً وبطئاً وعدم حتمية بلا أي فائدة، ومع ذلك يبقى عليك أن تتعامل مع التفرّع نفسه على أساس Result.

لتلك الحالة، استعِن بـ FlipLink CLI. فهو مولَّد من المواصفة نفسها التي وُلِّد منها خادم MCP وواجهة API، ولذلك لا يمكن أن ينحرف عنها، وهو يعيد رموز خروج نظيفة (0 نجاح، 1 خطأ في الطلب، 2 خطأ في التطبيق) يستطيع CI التفرّع بناءً عليها دون أي تحليل:

fliplink config set-key "$FLIPLINK_API_KEY"
ID=$(fliplink flipbook create ./reports/2026-06-report.pdf \
  --title "June 2026 Report" --name june-2026-report --json | jq -r '.ID')
fliplink flipbook publish "$ID"
fliplink flipbook share-link "$ID"

تلك هي المهمة الشهرية بأكملها، دون حاجة إلى أي نموذج. وللاطلاع على خط معالجة كامل — بما في ذلك تشغيله داخل التكامل المستمر — راجع أتمتة نشر الكتب التفاعلية في CI/CD.

قاعدة عامة: استخدم وكيل ذكاء اصطناعي حين تحتاج المهمة إلى حُكم وتقدير؛ واستخدم CLI حين تحتاج إلى أن تكون متطابقة في كل مرة. كثير من الفرق تستخدم الاثنين معاً — الوكيل لطلبات “انشر هذا من أجلي” العابرة، وCLI للتشغيلات المجدولة الآلية.

ابدأ البناء

وكيل الذكاء الاصطناعي للمستندات يزيل الجزء اليدوي الأوسط من النشر: تذكر أنت النتيجة، فيستدعي هو الأدوات. ومع FlipLink MCP في وضع safe، يعمل وكيل الإنشاء والنشر من البداية إلى النهاية بلا عوائق — وحيثما تدخل الإجراءات المدمِّرة الصورة، تُبقي بوابة رمز التأكيد التشغيلات غير المراقَبة آمنةً لا خطِرة.

مستعد؟ وصِّل خادم MCP، ووجّه وكيلاً نحو تقرير، وراقبه وهو ينشره. أما لمسار CI الحتمي، فإن وثائق CLI تغطّيك. ويوجد فهرس النقاط الطرفية الكامل في مرجع API.

قراءات ذات صلة

• وصِّل FlipLink بـ Claude عبر خادم MCP
• أمان خادم MCP وضوابطه
• أتمتة الكتب التفاعلية باللغة الطبيعية
• أتمتة نشر الكتب التفاعلية في CI/CD
• وثائق FlipLink CLI
• مرجع FlipLink API