使用手册 · 运营

活动流

实时事件流,展示整个 Agent 舰队的所有运营动态——基于 Server-Sent Events 驱动。

/activity

概述#

活动页面为你提供对 Agent 舰队中所有操作的实时可见性。每一个重要事件——审批、定时任务执行、成本异常、心跳检测、配置协调——都会以带时间戳的条目出现在持续更新的事件流中。

事件流由 Server-Sent Events (SSE) 驱动,新事件在发生的瞬间即推送到页面,无需手动刷新。页面顶部的实时流状态指示器确认连接处于活跃状态,颜色编码的事件卡片让你一眼就能发现异常。

前置条件#

前置条件
  • 至少一个连接器已同步且在线(参见「连接器」)
  • Agent 正在运行并产生事件(审批、定时任务、成本记录等)

使用反馈#

事件开始流入后,活动页面显示:

  • -通过 SSE 实时更新的事件流,流状态指示器确认连接正常
  • -颜色编码的事件卡片:琥珀色代表审批,红色代表失败,绿色代表成功,蓝色代表信息类事件
  • -每张卡片显示事件类型徽章、Agent 名称、时间戳以及风险等级(如适用)

Web 端操作#

从侧边栏的「运营」分组中导航至「活动流」。

实时推送

活动流通过 SSE(Server-Sent Events)实时推送事件。新事件出现在列表顶部。页面标题栏中的脉动圆点指示器确认实时连接处于活跃状态。如果连接断开,会自动重连。

事件卡片

每个事件渲染为一张卡片,包含:彩色类型徽章、触发事件的 Agent 名称、可读时间戳,以及风险等级(如适用)。卡片设计便于快速视觉扫描——你可以立即发现失败(红色)或待审批(琥珀色)事件。

事件类型

事件流捕获五种主要事件类型:审批(人机协同决策)、定时任务(计划任务执行)、成本(异常告警和预算阈值警告)、心跳(周期性 Agent 健康探测)、协调(配置漂移检测和修复事件)。

筛选

使用事件类型筛选器缩小范围,只查看特定类别(如仅显示审批或成本事件)。还可以按日期范围筛选以回顾历史活动。

CLI 端操作#

列出最近的活动事件,支持按类型和日期筛选

Terminal
$ ap activity list

常见问题#

问:事件没有实时出现。
答:请确认连接器在线且 SSE 连接处于活跃状态(查看流状态指示器)。如果指示器未显示,请检查网络连接并确认连接器已同步(参见「连接器」)。
问:活动流中有哪些事件类型?
答:共有五种主要事件类型:审批(人机协同决策)、定时任务(计划任务执行)、成本(消费异常和预算告警)、心跳(周期性健康探测)、协调(配置漂移检测)。每种类型都有独特的颜色徽章便于快速识别。
问:活动数据保留多长时间?
答:活动事件作为审计追踪的一部分存储,默认无限期保留。你可以按日期范围搜索和筛选历史事件。如需导出,可使用 CLI 的 export 命令。
活动流 — ClawButler 用户手册