swarm-orchestration
实现多智能体集群的动态协同与任务编排,支持网状、层级及自适应拓扑结构,可自动分配任务、均衡负载、容错恢复,并在集群内共享状态,适用于复杂分布式 AI 工作流的构建与扩展。
效率工具数据与分析软件开发
| name | Swarm Orchestration |
| description | Orchestrate multi-agent swarms with agentic-flow for parallel task execution, dynamic topology, and intelligent coordination. Use when scaling beyond single agents, implementing complex workflows, or building distributed AI systems. |
Swarm Orchestration
What This Skill Does
Orchestrates multi-agent swarms using agentic-flow's advanced coordination system. Supports mesh, hierarchical, and adaptive topologies with automatic task distribution, load balancing, and fault tolerance.
Prerequisites
- agentic-flow v1.5.11+
- Node.js 18+
- Understanding of distributed systems (helpful)
Quick Start
▼bash复制代码# Initialize swarm npx agentic-flow hooks swarm-init --topology mesh --max-agents 5 # Spawn agents npx agentic-flow hooks agent-spawn --type coder npx agentic-flow hooks agent-spawn --type tester npx agentic-flow hooks agent-spawn --type reviewer # Orchestrate task npx agentic-flow hooks task-orchestrate \ --task "Build REST API with tests" \ --mode parallel
Topology Patterns
1. Mesh (Peer-to-Peer)
▼typescript复制代码// Equal peers, distributed decision-making await swarm.init({ topology: 'mesh', agents: ['coder', 'tester', 'reviewer'], communication: 'broadcast' });
2. Hierarchical (Queen-Worker)
▼typescript复制代码// Centralized coordination, specialized workers await swarm.init({ topology: 'hierarchical', queen: 'architect', workers: ['backend-dev', 'frontend-dev', 'db-designer'] });
3. Adaptive (Dynamic)
▼typescript复制代码// Automatically switches topology based on task await swarm.init({ topology: 'adaptive', optimization: 'task-complexity' });
Task Orchestration
Parallel Execution
▼typescript复制代码// Execute tasks concurrently const results = await swarm.execute({ tasks: [ { agent: 'coder', task: 'Implement API endpoints' }, { agent: 'frontend', task: 'Build UI components' }, { agent: 'tester', task: 'Write test suite' } ], mode: 'parallel', timeout: 300000 // 5 minutes });
Pipeline Execution
▼typescript复制代码// Sequential pipeline with dependencies await swarm.pipeline([ { stage: 'design', agent: 'architect' }, { stage: 'implement', agent: 'coder', after: 'design' }, { stage: 'test', agent: 'tester', after: 'implement' }, { stage: 'review', agent: 'reviewer', after: 'test' } ]);
Adaptive Execution
▼typescript复制代码// Let swarm decide execution strategy await swarm.autoOrchestrate({ goal: 'Build production-ready API', constraints: { maxTime: 3600, maxAgents: 8, quality: 'high' } });
Memory Coordination
▼typescript复制代码// Share state across swarm await swarm.memory.store('api-schema', { endpoints: [...], models: [...] }); // Agents read shared memory const schema = await swarm.memory.retrieve('api-schema');
Advanced Features
Load Balancing
▼typescript复制代码// Automatic work distribution await swarm.enableLoadBalancing({ strategy: 'dynamic', metrics: ['cpu', 'memory', 'task-queue'] });
Fault Tolerance
▼typescript复制代码// Handle agent failures await swarm.setResiliency({ retry: { maxAttempts: 3, backoff: 'exponential' }, fallback: 'reassign-task' });
Performance Monitoring
▼typescript复制代码// Track swarm metrics const metrics = await swarm.getMetrics(); // { throughput, latency, success_rate, agent_utilization }
Integration with Hooks
▼bash复制代码# Pre-task coordination npx agentic-flow hooks pre-task --description "Build API" # Post-task synchronization npx agentic-flow hooks post-task --task-id "task-123" # Session restore npx agentic-flow hooks session-restore --session-id "swarm-001"
Best Practices
- Start small: Begin with 2-3 agents, scale up
- Use memory: Share context through swarm memory
- Monitor metrics: Track performance and bottlenecks
- Enable hooks: Automatic coordination and sync
- Set timeouts: Prevent hung tasks
Troubleshooting
Issue: Agents not coordinating
Solution: Verify memory access and enable hooks
Issue: Poor performance
Solution: Check topology (use adaptive) and enable load balancing
Learn More
- Swarm Guide: docs/swarm/orchestration.md
- Topology Patterns: docs/swarm/topologies.md
- Hooks Integration: docs/hooks/coordination.md
效率工具
数据与分析
软件开发









