事件与配置

​

事件类型

• Agent 启动、结束、暂停和恢复
• 模型请求与响应
• 工具调用与结果
• Hook 触发与完成
• 人工等待、输入、暂停和中断
• 显式错误

​

检查事件契约

• 控制台
• CLI

1. 打开 Observe → Events。
2. 设置较短的时间窗口，并按环境、Agent 和事件类型进行筛选。
3. 选择一个事件以检查其标准化字段和原始载荷，然后打开其会话查看执行上下文。
4. 如果缺少配对的持续时间，请确认开始事件和完成事件使用相同的关联 ID。

使用事件流将数据缩小到单次 Agent 运行，并检查标准化事件字段。然后跟随事件进入其会话。追踪视图显示该事件前后发生的内容，当载荷本身不明确时，这一信息尤为必要。当配对事件或持续时间缺失时，请在两个视图中对比关联 ID 和时间戳。

先获取有效的筛选值，再拉取某个会话的完整事件载荷：

fp list event_types
fp list envs
fp events --since 1h \
  --env production \
  --event-type tool_use,tool_result \
  --session-id <session-id> \
  --full

使用 fp --json events ... --fields ts,event_type,session_id,payload 进行机器可读的检查。

​

SDK 保留字段

​

本地边界

• Failproof AI 的状态默认存储在 ~/.failproofai 下，除非明确配置了其他路径。
• failproofai-sdk 始终在 ~/.failproofai/custom-agents 下进行缓冲写入。FAILPROOFAI_HOME 可重新定位该主目录；custom-agents 段始终会被追加，因此缓冲目录无法置于其外部。只有 SDK 自身的 configure(base_dir=...) 才会写入其他位置。AGENTEYE_HOME 由旧版 agenteye-collector 读取以确定监控目标，不再影响 SDK 的写入位置。
• 环境标签可通过 SDK 配置或 AGENTEYE_ENVIRONMENT 设置。
• 守护进程凭据与非敏感设置分开存储。

​

修改环境标签

export AGENTEYE_ENVIRONMENT=production-us-east
failproofai config
failproofai config --status
fp sessions --since 1h --env production-us-east