MCP

agent-swarm: نظام تشغيل MCP لـ swarm متعدد الوكلاء — افهم كامل كلفة النشر قبل البدء

agent-swarm هو الأنسب كنظام تنسيق موحّد لتشغيل الفرق لـ swarm من وكلاء متعددين، لكن مسار التثبيت الرسمي الرئيسي يعتمد افتراضيًا على preset full + tunnel، ما يعني نشر حزمة Compose كاملة دفعة واحدة وكتابة حالة محلية، وهو غير مناسب لسيناريوهات التجربة الخالية من الآثار الجانبية.

Official source · desplega-ai/agent-swarm

Install

ui-install.sh --preset full --tunnel

لمن يصلح

  • مناسب للفرق أو الأفراد الذين يريدون تنسيق عدة وكلاء (agents) داخل نظام موحّد: عبر أدوات دورة حياة المهام (send-task وcancel-task وtask-action وpoll-task وstore-progress)، ورسائل steering، وجلسات session/session logs، وإدارة الميزانية (getBudget/getBudgets/upsertBudget/deleteBudget) لتوجيه ومراقبة مجموعة من الوكلاء، وأحدث إصدار هو v2.7.7.
  • تغطي عقوده e2e "كل مسار (route) وكل أداة MCP وكل نوع من عقد سير العمل"، وتوثّق المجالات المختلفة أكثر من 32 أداة MCP، ما يجعله مناسبًا للمستخدمين الذين يتعاملون مع تعاون الوكلاء المتعددين كبنية تحتية طويلة الأمد.
  • غير مناسب لمن يريد نشرًا صفريًا وملفًا واحدًا جاهزًا للاستخدام: مسار التثبيت الرئيسي هو نشر preset full مع tunnel، وتتضمن حزمة Compose مكوّنات lead وworkers وagent-fs وMinIO وCaddy؛ وعند استخدام tls profile يتم النشر إلى نطاق فرعي حقيقي على agent-swarm.dev.
  • متطلبات بيانات الاعتماد وطريقة المصادقة والقيم الافتراضية لبوابة الميزانية (budget gate) غير مذكورة في الأدلة المجمّعة، لذا يجب التحقق منها في README/الوثائق الرسمية قبل الاستخدام.

أول تجربة في 3 دقائق

  • المسار الرسمي الرئيسي هو التثبيت الكامل المذكور في README والوثائق: ui-install.sh --preset full --tunnel.
  • المتطلبات المسبقة: جهاز مضيف يسمح بتشغيل عدة حاويات خدمات، مع تثبيت بيئة تشغيل Bun (يعتمد agent-swarm على Bun، وطبقة البيانات هي bun:sqlite)؛ وتستخدم بوابات الجودة bun run lint وtsc:check، ما يدل على أن الكود المصدري يمكن التحقق منه عبر سير عمل Bun.
  • تنبيه بشأن الآثار الجانبية: هذا نشر حقيقي وليس تجربة للقراءة فقط. سيكتب حالة محلية (SQLite)، ويشغّل خدمات مثل MinIO/Caddy، وعند استخدام tls profile يشغل نطاقًا فرعيًا حقيقيًا. تأكد قبل التنفيذ من قبول هذه الآثار؛ ولم تُقدَّم في الأدلة أوامر رسمية للتراجع/الإلغاء، فلا تفترض إمكانية الاستعادة بنقرة واحدة.
  • إشارة النجاح: بعد اكتمال سكربت التثبيت، تكون مكوّنات lead وworkers وagent-fs وMinIO وCaddy في حزمة Compose قيد التشغيل، ويمكن مراجعة حالة النظام عبر واجهة dashboard (يستخدم العرض الرسمي agent-browser).
  • إذا كنت تريد فقط الاطلاع على واجهة الأدوات دون نشر، فلا يوجد في الأدلة مسار رسمي أخف، فلا تخمّن طرق تثبيت بديلة.

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

  • الحالة 1: إرسال مهمة وتتبعها. بعد اكتمال النشر، أرسل مهمة إلى الـ swarm عبر MCP باستدعاء send-task، ثم استخدم poll-task لاستطلاع التقدم، وstore-progress لتسجيل التقدم (يدعم الحالة الطرفية 'skipped')؛ واستخدم cancel-task للإلغاء عند الحاجة. النتيجة المتوقعة: دورة حياة المهمة من الإنشاء حتى الحالة النهائية قابلة للمراجعة في session logs.
  • الحالة 2: ضبط ميزانية يومية لمنع الخروج عن السيطرة. استدعِ getBudget/getBudgets لعرض الميزانية الحالية، واستخدم upsertBudget لتحديد سقف الإنفاق اليومي؛ وتوضح الأدلة الرسمية أنه عند بلوغ الإنفاق البوابة اليومية يرفض النظام قبول المهام اللاحقة — وهذه طريقة مباشرة لملاحظة فعالية آلية الميزانية. أما الحذف فيتم عبر deleteBudget.

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

  • طبيعة القراءة والكتابة: توجد استعلامات للقراءة فقط (getBudgets وpoll-task وsession logs)، وأيضًا عمليات كتابة وإلغاء (send-task وupsertBudget وcancel-task)؛ قبل أي عملية كتابة بعد التجربة الأولى، تأكد من الحالة المستهدفة في dashboard أولًا.
  • البيانات المحلية: طبقة البيانات هي bun:sqlite، وسيُكتب حالة قاعدة بيانات محلية على الجهاز المضيف؛ وهذا يُعد كتابة محلية، ولا يتحول إلى قراءة فقط لمجرد وجود أدوات استعلام.
  • آثار النشر الجانبية: تشغيل حزمة متعددة الخدمات دفعة واحدة مع احتمال شغل نطاق حقيقي، ولم تُقدَّم في الأدلة مسارات تراجع.
  • غير مؤكد بعد: القيمة الافتراضية لبوابة الميزانية اليومية، ومتطلبات بيانات الاعتماد والمصادقة، وتوقيعات المعاملات الكاملة لكل أداة MCP (لم يُؤكَّد سوى أسماء الأدوات وعددها 32+)؛ اعتمد قبل الاستخدام على README/الوثائق الرسمية.