Agent manager 是一个专为 Clawdbot 代理生态系统设计的管理工具，旨在实现代理的集中化管控与智能化任务路由。该工具的核心价值在于帮助系统管理员和开发者全面掌握代理网络的动态状态，从发现可用代理、分析其能力画像，到构建清晰的路由层级结构，最终实现任务的精准分配与执行跟踪。通过一套标准化的协议和脚本体系，Agent manager 确保了代理间协作的安全性与效率，尤其适用于复杂多代理协同工作的场景。它不仅提供了命令行接口供人工干预，还通过预设的规则引擎自动处理任务流转中的权限校验与升级机制，从而降低运维复杂度并提升整体系统的稳定性。
核心功能特点
- 支持全量代理发现与能力画像生成，快速识别系统中所有可用代理及其通信方式
- 提供权限验证机制（can_assign.js），确保任务只能分配给具备相应能力的代理
- 内置任务路由规则与升级路径定义功能，支持直接分配、握手审批和逐级上报三种流转模式
- 实时健康检查与绩效统计，监控代理运行状态（健康/缓慢/离线）及任务完成成功率
- 可视化代理层级结构，便于理解组织关系与依赖链条
适用场景
Agent manager 特别适用于需要协调多个异构代理共同完成复杂业务流程的环境。例如，在一个自动化客服系统中，初级代理可处理常规咨询，当遇到技术问题时，可通过 handshake 协议请求高级专家代理介入；若仍无法解决，则沿 escalation_path 上报至人类操作员。这种分层路由机制既保证了响应速度，又避免了越权操作风险。另一个典型应用场景是微服务架构下的智能调度平台，其中不同功能的代理（如数据分析、文本生成、API调用等）需根据任务类型被动态指派。借助 agent-registry.md 和 task-routing-rules.md 的配置能力，管理员可以灵活调整代理间的协作逻辑，并在代理变更（如扩容或下线）后及时更新注册表，确保系统持续可用。此外，log_analyzer.js 和 health_check.js 等脚本为日常运维提供了关键指标支持，帮助团队快速定位瓶颈或故障节点。