من موجز العميل إلى منشورات حية: أسبوع كامل يديره وكيل، استدعاءً تلو الآخر

مثال عملي لأسبوع عميل واحد عبر Shager: الموجز، ورفع الوسائط، ومسودات لكل حساب، والمراجعة، وموافقة العميل، والجدولة، والتحقق من النشر، والتقرير.

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

ما يلي أسبوع واقعي لعميل خيالي، مع كل استدعاء يجريه الوكيل في Shager، بالترتيب. العميل هو Harbor Coffee، ولديه 14 مقهى، لكل منها صفحة على Facebook وحساب احترافي على Instagram، إضافة إلى قناة واحدة للعلامة التجارية على YouTube.

صباح الاثنين: يصل الموجز

يضع مدير الحساب موجزًا في مجلد سياق العميل: مشروب خريفي جديد، وإطلاق يوم الخميس، وخصم 20 في المئة في أول عطلة نهاية أسبوع، وفيديو عمودي مدته 25 ثانية، وصورتان مستضافتان على شبكة توزيع المحتوى الخاصة بالعميل. لا شيء غير ذلك. تمنع التعليمات الدائمة الوكيلَ من اختلاق أي شيء لا يذكره الموجز، فالخصم والتاريخ واسم المنتج هي الحقائق الوحيدة التي سيستخدمها.

تبدأ الجلسة داخل مجلد العميل، فيكون لدى الوكيل قواعد الوكالة وملف أسلوب Harbor Coffee، ولا شيء عن العملاء الآخرين. لماذا يهم ذلك؟ الجواب في وكيل واحد لعملاء كثيرين.

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

المرحلة 1: من نحن وأين نعمل

whoami            -> organization, claimed or sandbox, key scopes
list_workspaces   -> "Harbor Coffee" (ws_harbor), timezone Europe/London

تجيب whoami عن سؤالين قبل أي عمل: هل تولّى أحد ملكية هذه المؤسسة، وهل يتضمن المفتاح publish؟ إذا كانت بيئة اختبار لم يتولَّ أحد ملكيتها، فلا يزال بإمكان الوكيل رفع الوسائط وكتابة المسودات، لكن الجدولة وطلبات الموافقة ستفشل بخطأ واضح إلى أن يتولى شخص ملكيتها. خطوات تولّي الملكية موصوفة في /auth.md.

المرحلة 2: فحص الحسابات

list_channels ws_harbor  -> 29 channels: 14 Facebook, 14 Instagram, 1 YouTube
list_groups   ws_harbor  -> "All cafes FB", "All cafes IG", "Brand YouTube"

ينظر الوكيل في حالة كل قناة. يظهر أحد حسابات Instagram غير متصل. وبدل أن يكتب المسودات متجاوزًا هذا الحساب بصمت، ينشئ الوكيل رابط ربط لمدير ذلك المقهى:

{
  "tool": "create_connect_link",
  "arguments": { "workspace_id": "ws_harbor", "label": "Harbor Quayside, Instagram reconnect" }
}

يُعيد مدير الحساب توجيه الرابط. يسجّل مدير المقهى الدخول إلى Instagram من خلاله، دون حساب في Shager، ويعود الحساب إلى نتيجة list_channels في وقت لاحق من اليوم نفسه.

المرحلة 3: رفع الوسائط

ثلاثة استدعاءات، واحد لكل ملف. يحمل الفيديو أبعاده ومدته حتى يجري التحقق الخاص بالريل وShorts الآن لا عند النشر.

{
  "tool": "upload_media_from_url",
  "arguments": {
    "workspace_id": "ws_harbor",
    "url": "https://cdn.harbor-coffee.example/autumn/launch.mp4",
    "file_name": "autumn-launch.mp4",
    "width": 1080, "height": 1920, "duration_ms": 25000
  }
}

وتُرفع الصورتان بالطريقة نفسها، دون حقول الفيديو.

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

المرحلة 4: التخطيط، ثم الانتظار

يقترح الوكيل خطة بدل أن يبدأ الكتابة فورًا:

اليوم المنشور الصيغة الوجهة
الثلاثاء صورة تشويقية FEED All cafes FB، All cafes IG
الخميس فيديو الإطلاق REEL / SHORT All cafes FB، All cafes IG، Brand YouTube
السبت صورة تذكير بالخصم FEED All cafes FB، All cafes IG

يرد مدير الحساب بكلمة «انطلق»، مع نقل منشور السبت إلى بعد ظهر الجمعة. رسالة واحدة، ولا تتحول خطة ضعيفة أبدًا إلى 85 نصًا موزعًا على الحسابات.

المرحلة 5: المسودات بنص لكل حساب

يتحول كل منشور مخطط إلى استدعاء create_post واحد دون schedule_at، فيُحفظ كمسودة. منشور الإطلاق يعرض الشكل الكامل:

{
  "tool": "create_post",
  "arguments": {
    "workspace_id": "ws_harbor",
    "group_ids": ["grp_all_fb", "grp_all_ig", "grp_brand_yt"],
    "media_ids": ["med_launch"],
    "caption": "The autumn drink is here. 20% off this weekend.",
    "youtube_title": "Harbor Coffee autumn drink, first pour",
    "youtube_privacy": "public",
    "cta_url": "https://harbor-coffee.example/autumn",
    "campaign": "autumn-launch",
    "label": "Harbor autumn launch video",
    "first_comment": "Find your nearest Harbor and the weekend offer: https://harbor-coffee.example/autumn",
    "per_channel": [
      { "channel_id": "ch_fb_quayside", "format": "REEL",
        "caption": "Quayside regulars, it's here. Autumn's first pour, 20% off this weekend." },
      { "channel_id": "ch_ig_quayside", "format": "REEL",
        "caption": "First pour at Quayside. 20% off all weekend, details in bio." },
      { "channel_id": "ch_yt_brand", "format": "SHORT",
        "caption": "The new Harbor autumn drink, poured for the first time." }
    ]
  }
}

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

المرحلة 6: المراجعة في جولة منفصلة

جلسة ثانية تعمل بتعليمات مراجِع وأدوات قراءة فقط، تستدعي list_posts مع ضبط status على DRAFT، ثم get_post لكل منشور. تتحقق من تكرار النصوص، ومن وجود حقائق ليست في الموجز، ومن روابط وُضعت حيث لا يمكن النقر عليها، ومن صيغ الفيديو المطبقة على وسائط غير عمودية. هذه المرة تنبّه إلى نصّين على Instagram يقولان «الرابط في الأسفل» بينما الرابط في الملف الشخصي. يصلحهما الوكيل الكاتب بإنشاء مسودات مصححة، وتُستبعد القديمة من الجدولة.

المرحلة 7: موافقة العميل

مساحة عمل Harbor Coffee مضبوطة على approval_required، فلا يمكن جدولة شيء قبل أن يوافق العميل. يرسل الوكيل كل مسودة للموافقة:

{
  "tool": "request_approval",
  "arguments": {
    "workspace_id": "ws_harbor",
    "post_id": "pst_launch",
    "reviewer_name": "Dana, Harbor Coffee marketing",
    "reviewer_email": "dana@harbor-coffee.example",
    "send_email": true
  }
}

يفتح العميل الرابط، ويراجع المنشور، ويوافق دون تسجيل دخول. تنتقل حالة المنشور من IN_REVIEW إلى APPROVED، أو إلى CHANGES_REQUESTED، وفي هذه الحالة يعدّل الوكيل المنشور ويعيد إرساله. أما تصميم قواعد موافقة جيدة فمشروح في الموافقة البشرية على منشورات الوكلاء.

المرحلة 8: الجدولة والتحقق

بعد الموافقة، تعمل خطوة الجدولة بمفتاح يتضمن النطاق publish. يحسب الوكيل كل موعد بالمنطقة الزمنية لمساحة العمل، مع فارق التوقيت الصحيح لذلك التاريخ:

{
  "tool": "schedule_post",
  "arguments": {
    "workspace_id": "ws_harbor",
    "post_id": "pst_launch",
    "schedule_at": "2026-10-15T08:30:00+01:00"
  }
}

مع 14 حسابًا على كل من Facebook وInstagram، وفاصل افتراضي يتراوح بين 30 و90 ثانية، يستغرق التنفيذ على كل شبكة نحو 13 دقيقة، وتعمل الشبكتان بالتوازي. يوم الخميس عند 9:15 يستدعي الوكيل get_post. يظهر ثمانية وعشرون حسابًا منشورًا مع روابط حية، ويظهر حساب واحد بخطأ في الصلاحيات. يذكر الوكيل الحساب باسمه في تقريره ويقترح رابط ربط جديدًا؛ ولا يعيد المحاولة عشوائيًا.

الاثنين التالي: التقرير

يُختتم الأسبوع نفسه بالتقرير: list_posts لما نُشر، وget_post لنتائج كل حساب، وget_analytics للنقرات حسب الحساب والمنشور على مدار الأسبوع، مع ربطها بالعملاء المحتملين في نظام CRM عبر utm_content حين يشاركها العميل. الإعداد الكامل، بما في ذلك تشغيله دون إشراف، موجود في التقرير الأسبوعي للعميل بواسطة وكيل.

من فعل ماذا

المرحلة الوكيل الإنسان
الصلاحيات ومساحة العمل يتحقق ويُبلغ
الحسابات يكتشف الحساب المعطل وينشئ الرابط يعيد توجيه الرابط
الوسائط والخطة يرفع ويقترح يقول «انطلق»
المسودات والمراجعة يكتب 85 نصًا ويراجعها
الموافقة يرسل الروابط العميل يوافق
الجدولة يحسب المواعيد ويجدول منح publish مرة واحدة
النشر والتقرير يتحقق ويكتب التقرير يقرأ التقرير

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

كم يستغرق أسبوع كهذا من وقت الإنسان؟

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

هل يستطيع الوكيل تخطي موافقة العميل في المنشورات الروتينية؟

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

ماذا لو طلب العميل تعديلات بعد الموافقة؟

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

إلى أين بعد ذلك؟

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

جرّبه على حساباتك.

مجانًا خلال فترة الإطلاق، دون بطاقة. اربط حساباتك، واكتب مرة واحدة، وShager ينشر ويقيس.