عن المشروع

Swarms هو إطار عمل Python لبناء وتنسيق الأنظمة متعددة الوكلاء. يوفر مجموعة من البنى التنسيقية الجاهزة وتجريدًا مشتركًا للوكيل، بحيث يمكن إعادة استخدام نفس الوكلاء عبر استراتيجيات تعاون مختلفة. المكونات الأساسية - الوكيل (Agent): كيان مدعوم بنموذج لغوي كبير (LLM) مع أدوات وذاكرة، يتم تكوينه عبر اسم النموذج، ومطالبة النظام، وعدد الحلقات، وخيارات ذات صلة. تعيين max_loops="auto" يسمح للوكيل بتحديد متى يكتمل المهمة بدلاً من التوقف بعد عدد ثابت من التكرارات. - سير العمل (Workflows): SequentialWorkflow يربط الوكلاء بحيث يغذي كل ناتج الوكلاء التالي؛ ConcurrentWorkflow يشغل الوكلاء بالتوازي على نفس المهمة؛ AgentRearrange يعبر عن التدفقات غير الخطية بصيغة نصية مثل "a -> b, c"؛ GraphWorkflow يمثل الوكلاء كعقد في رسم بياني موجه غير دائري (DAG) مع حواف صريحة ونقاط دخول وخروج، وترتيب طوبولوجي تلقائي، وفروع مستقلة متوازية. - الأنماط عالية المستوى: MixtureOfAgents يشغل وكلاء خبراء بالتوازي ويدمج النتائج باستخدام مُجمّع؛ GroupChat يدعم التعاون الحواري؛ ForestSwarm يختار وكلاء أو أشجار وكلاء مناسبة لمهمة معينة؛ HierarchicalSwarm يستخدم مديرًا يخطط ويوزع العمل على عمال متخصصين؛ HeavySwarm يصف سير عمل بحثي وتحليلي متعدد المراحل؛ SwarmRouter يوفر واجهة واحدة لتشغيل أي نوع سرب مدعوم بتغيير معامل واحد. - AutoSwarmBuilder يولّد الوكلاء والمطالبات وهيكل سير العمل من وصف مهمة، مع خيار إرجاع تكوينات الوكلاء المُولّدة. التشغيل البيني يمكن للوكلاء استهلاك أدوات خارجية عبر بروتوكول سياق النموذج (MCP) بتعيين عنوان URL لخادم MCP، ويمكن لـ MCPDeployer فضح وكيل أو سرب أو دالة كخادم MCP مع مصادقة قابلة للتكوين (مفاتيح API ثابتة، أو دوال مصادقة مخصصة، أو مُتحققون من الرموز مع نطاقات) ودعم نقل HTTP أو SSE أو stdio. يذكر ملف README أيضًا توافقًا عكسيًا مع أطر وكلاء أخرى وبروتوكولات مثل x402 والمهارات. التثبيت والاستخدام يتم التثبيت عبر pip أو uv أو poetry، أو من المصدر. التكوين يتم أساسًا عبر متغيرات البيئة مثل مفاتيح API ودليل عمل. تغطي الأمثلة في README وكيلًا أولاً، ووكيلًا مستقلًا، وإعدادات عميل وخادم MCP، والعديد من بنى السرب. يُوزَّع المشروع كحزمة PyPI ويربط إلى التوثيق وموقع ويب وسوق للمواد الإضافية.