Skip to main content

​
事件类型

  • Agent 启动、结束、暂停和恢复
  • 模型请求与响应
  • 工具调用与结果
  • Hook 触发与完成
  • 人工等待、输入、暂停和中断
  • 显式错误
每个事件都包含时间戳、会话 ID、Agent ID、事件类型和环境信息。事件特定字段包含模型、工具、关联、结果、内容、持续时间或错误数据。

​
检查事件契约

  1. 打开 Observe → Events。
  2. 设置较短的时间窗口，并按环境、Agent 和事件类型进行过滤。
  3. 选择一个事件以查看其规范化字段和原始数据，然后进入其会话查看执行上下文。
  4. 如果缺少配对的持续时间，请验证开始事件和完成事件是否使用相同的关联 ID。
使用 Events 流将数据缩小到单次 Agent 运行，并检查规范化的事件字段。实时 Events 流，支持按环境、Agent、会话和事件类型过滤。然后从事件跳转到对应的会话。追踪视图会显示该事件前后发生的内容，在仅凭数据内容难以判断时尤为必要。用于在执行上下文中检查事件的关联会话追踪。当缺少配对事件或持续时间时，请在两个视图中对比关联 ID 和时间戳。

​
保留的 SDK 字段

请勿将 timestamp、session_id、agent_id、type 或 environment 用作自定义 Python SDK 字段。工具结果持续时间等配对事件的持续时间由 SDK 自动计算，无法手动提供。

​
本地边界

  • Failproof AI 的状态默认存储在 ~/.failproofai 下，除非显式配置了其他路径。
  • failproofai-sdk 使用 AGENTEYE_HOME 作为其旧版基础目录的覆盖配置。
  • 环境标签可通过 SDK 配置或 AGENTEYE_ENVIRONMENT 进行设置。
  • 守护进程凭证与非敏感设置分开存储。
请使用稳定、低基数的环境名称。守护进程环境标签不支持逗号。

​
更改环境标签

环境标签由发送方的 SDK 或 Failproof 守护进程分配。更改后，打开 Observe → Sessions 并使用环境过滤器确认新会话已携带新的标签值。已有会话将保留其原始环境标签。