消息监控与排障

消息监控

可查看机器人是否按预期读消息。

重点字段：

问题
原始问题
是否@
回答
耗时
回调地址
AI回复引擎
AI判断群回复

本地监控与第三方监控

本平台托管回调：优先展示本地处理记录
非本平台回调：展示 WorkTool 回调记录
本地监控中的 messageId 会做本地脱敏映射（local-xxxx），避免暴露内部自增规模

指令任务查询

“指令任务查询”用于查看机器人任务下发与执行状态：

默认展示最近 30 条任务
统一按 messageId 合并“指令下发记录”和“执行结果记录”
有执行结果且 rawSuccess=0：执行成功
有执行结果且 rawSuccess!=0：执行失败
没有执行结果：待执行
待执行列表每 60 秒自动刷新
支持按 messageId 精准查询

指令任务下发与执行状态联动

“指令任务下发”用于主动下发任务
“指令任务查询”用于查看实际执行状态
推荐流程：先下发，再按 messageId 精准核对执行结果

机器人登录日志异常提醒

在“机器人信息 > 机器人登录日志”里，系统会判断登录上下线波动：

最近 24 小时或当天内
上线+下线记录超过 10 次

命中后会显示醒目提醒，提示优先检查客户端设备网络稳定性。

机器人排查

管理员可使用排查页查看机器人登录信息与设备信息，例如：

appVersion
设备型号与系统版本
workVersion
是否 root
登录 IP
问答回调记录（含原始问题、是否@）

机器人排查开放 API（给智能体）

用于让智能体直接查询排查结果，不需要走后台页面操作。

地址：POST /api/v1/open/troubleshoot/search
请求头：X-Open-API-Key: <你的密钥>
Content-Type：application/json

请求体字段：

robot_id：机器人ID（建议优先传）
message_id：消息ID（可选；不传 robot_id 时可用它反查）
keyword：关键字（可选）
start_time：开始时间（可选）
end_time：结束时间（可选）
limit：每个分区返回数量，默认20，最大100

示例：

curl -X POST 'https://console.worktool.ymdyes.cn/api/v1/open/troubleshoot/search' \
  -H 'Content-Type: application/json' \
  -H 'X-Open-API-Key: your-open-api-key' \
  -d '{
    "robot_id": "worktool1",
    "message_id": "",
    "keyword": "",
    "start_time": "",
    "end_time": "",
    "limit": 20
  }'

安全建议：

建议在配置中限制可查询机器人ID范围（白名单）
密钥只用于服务端调用，不要放在前端页面代码里

常见异常

AI 请求失败：检查 URL、Token、Model
回复为空：检查规则命中与 provider 返回结构
回调失败：检查 WorkTool 侧绑定和网络可达性
指令长期待执行：优先按 messageId 查询，确认是否有客户端执行记录
群聊“是否@”异常：优先检查企微对外显示名与机器人识别昵称是否一致

对话记忆说明

平台回调链路默认启用轻量记忆：

群聊和私聊都记录上下文
每个会话默认最多 20 条
默认保留 7 天并自动清理