Agent manager

核心功能

agents-manager 是 Clawdbot 生态系统的智能体管理中枢，提供六大核心能力：

1. 智能体发现与画像

• 通过 agents_list 工具枚举所有可用智能体，获取其 ID 与模型信息
• 主动查询智能体构建能力画像：模型版本、可用工具、任务类型、通信方式

2. 层级路由配置
支持三级路由体系：

• can_assign_to：水平委托权限（同级智能体）
• reports_to：垂直汇报关系（上级智能体/人类）
• escalation_path：逐级升级链路（L1主管 → L2人类所有者 → L3+扩展层级）

3. 智能任务分配
分析任务类型 → 匹配注册表 → 检查委托权限 → 选择通信方式（现有会话复用 sessions_send / 新建会话 sessions_spawn / 人类通知 message）→ 带上下文路由并指定回报告对象

4. 注册表维护与追踪
动态维护 agent-registry.md，记录：智能体标识、能力清单、路由配置、工作日志、最后更新时间

5. 升级协议
任务失败时自动触发：同级委托 → 上级汇报 → 人类介入的递进式解决路径

显著优势

• 中心化管控：单一入口管理多智能体协同
• 灵活层级：支持树状/网状混合路由结构
• 可追溯性：完整工作日志便于审计与优化

潜在局限

• 依赖智能体主动准确报告自身能力
• 路由配置需人工初始化，动态调整门槛较高
• 跨模型智能体兼容性未明确说明

适用场景

多智能体协作环境、企业级自动化流程、需明确责任归属的复杂任务分派

常规风险

• 路由配置错误导致任务循环或丢失
• 权限边界模糊引发越权委托
• 注册表与实际能力不同步造成匹配失败

核心用法

Agents Manager 是 Clawdbot 平台的智能体管理中枢，通过六大核心模块实现多 Agent 生态的统一治理：

1. 代理发现 (Agent Discovery)
通过 agents_list 工具枚举所有可用代理，支持按模型/类型筛选，为后续任务路由提供目标池。

2. 能力画像 (Agent Profiling)
主动查询各代理的核心参数：模型版本、工具集、任务边界，以及关键的路由元数据——can_assign_to（可委派对象）、reports_to（汇报对象）、escalation_path（升级链路），构建完整的组织拓扑。

3. 路由配置 (Routing Configuration)
定义三类关系网络：

• 水平路由：peer-to-peer 任务委托（can_assign_to）
• 垂直汇报：向 supervisor 或 human 反馈（reports_to）
• 紧急升级：任务失败时的兜底链路（escalation_path）

4. 任务分发 (Task Assignment)
基于任务类型匹配注册表中的专项代理，通过 sessions_send 或 sessions_spawn 建立通信通道，并嵌入 reportTo 指令确保闭环。

5. 注册追踪 (Registry Tracking)
维护 agent-registry.md 作为单一事实源，记录代理状态、能力演化、工作日志与拓扑变更，支持审计追溯。

6. 升级协议 (Escalation Protocol)
四级兜底：同级委托 → 上级汇报 → 人工介入 → 链路终结，确保任务不丢失。

---

显著优点

• 拓扑灵活：支持动态 DAG 结构，适配扁平团队与层级组织两种模式
• 零外部依赖：纯本地文档+脚本架构，无网络暴露面
• 审计友好：所有代理关系与任务流转均有 Markdown 留痕
• 人机混合：原生支持 human-in-the-loop 的汇报与升级节点

潜在局限

• 手动维护成本：注册表与路由配置需人工更新，规模化场景下同步延迟
• 无自动负载均衡：任务分发依赖静态配置，缺乏实时性能指标的动态调度
• 冲突消解缺失：多代理并发修改同一资源时无内置锁机制
• 依赖 Clawdbot 生态：无法直接管理外部 LLM 服务或 MCP Server

适合人群

• 构建 5-50 个专项 Agent 的中型自动化团队
• 需要清晰汇报链与合规审计的企业场景
• 追求零外部依赖、完全离线运行的私有化部署

常规风险

• 配置漂移：未及时更新的 can_assign_to 列表导致任务路由失败
• 循环依赖：错误配置的 reports_to 链路可能引发无限升级
• 权限模糊：escalation_path 末端若指向无权限人员，造成任务泄露或悬停