Agent Monitor — Agent 工作状态监控

概述

本技能提供子 Agent 工作状态监控及自动激活能力：

1. 状态监控 — 实时监控 Agent 运行时状态
2. 停滞检测 — 检测 Agent 是否处于“停滞”状态（即连续超过 5 分钟无响应）
3. 自动激活 — 自动发送激活消息，恢复 Agent 的运行

核心能力

1. 监控 Agent 状态

使用 subagents 工具获取当前正在运行的 Agent 列表：

# 列出最近 30 分钟内运行过的 Agent
subagents(action="list", recentMinutes=30)

2. 检测停滞状态

检测逻辑如下：

• 获取该 Agent 最近一次活跃时间（lastActivity）
• 计算其与当前时间的时间差
• 若时间差超过 5 分钟（300 秒）且无任何活动 → 判定为“停滞”

3. 自动激活 Agent

使用 subagents 工具的 steer 动作向目标 Agent 发送激活消息：

# 向指定 Agent 发送激活消息
subagents(action="steer", target="", message="Continue working")

工作流程

┌─────────────────────┐
│  获取 Agent 列表     │
└──────────┬──────────┘
           ▼
┌─────────────────────┐
│ 检查每个 Agent 的    │
│  最近活跃时间       │
└──────────┬──────────┘
           ▼
      ┌────────┐
      │ >5 分钟? ├──否──┐
      └────┬───┘      │
          是│         │
           ▼          │
┌─────────────────────┐│
│  判定为停滞状态      ││
└──────────┬──────────┘│
           ▼           │
┌─────────────────────┐│
│  发送激活消息以恢复  ││
│  Agent 运行          ││
└─────────────────────┘│
           │           │
           └───────────┘
                 ▼
        ┌─────────────────┐
        │ 继续监控          │
        └─────────────────┘

使用示例

示例 1：监控全部 Agent

# 1. 获取 Agent 列表
result = subagents(action="list", recentMinutes=30)

# 2. 检查每个 Agent 的状态
for agent in result.agents:
    idle_time = calculate_idle_time(agent.lastActivity)
    if idle_time > 300:  # 超过 5 分钟
        # 3. 自动激活
        subagents(action="steer", target=agent.id, message="Please continue executing the task")

示例 2：监控特定 Agent

# 监控指定 ID 的 Agent
agent_id = "builder-agent-001"
result = subagents(action="list", recentMinutes=10)

# 查找目标 Agent
for agent in result.agents:
    if agent.id == agent_id:
        if is_stalled(agent, threshold=300):
            activate_agent(agent_id)

脚本工具

monitor_agents.py

位于 scripts/monitor_agents.py，提供完整的监控功能：

# 监控并自动激活停滞的 Agent
python scripts/monitor_agents.py --threshold 300 --auto-activate

# 仅检测，不执行自动激活
python scripts/monitor_agents.py --threshold 300 --dry-run

# 监控特定 Agent
python scripts/monitor_agents.py --target agent-id-001

参数说明：

• --threshold：停滞判定阈值（单位：秒），默认为 300（即 5 分钟）
• --auto-activate：对判定为停滞的 Agent 自动执行激活
• --dry-run：仅执行检测，不触发激活操作
• --target：指定需监控的特定 Agent ID

集成至定时任务

可将监控脚本集成至 cron 定时任务中，实现持续监控：

# 每 2 分钟检查一次
*/2 * * * * python /path/to/monitor_agents.py --auto-activate

注意事项

1. 阈值设置：应根据任务类型调整停滞判定阈值；复杂任务可能需要更长的阈值
2. 激活消息：发送的激活消息应简洁明确，清晰提示 Agent 继续执行任务
3. 避免误激活：确保 Agent 确实处于停滞状态后再执行激活，以免干扰其正常的推理或执行流程
4. 日志记录：建议对每次检测与激活操作均进行日志记录，便于后续分析与排查