跳转到主要内容
在开发期间向运行或继续操作传入 DevTools 配置,即可为每次运行向本地目录中的 generations.jsonl 追加一行 JSON。每一行包含该运行的输入、步骤、工具活动、输出、用量和网关请求 ID。除非你开启,否则不会捕获任何内容。
Rust 0.2 没有 DevTools 捕获。请把生命周期钩子与 run_with_events 一起使用,并自行写入事件。

通过环境变量开启捕获

没有 DevTools 配置时,设置 PHASEO_DEVTOOLS=true 即可开启捕获。文件写入 PHASEO_DEVTOOLS_DIR;如果未设置该变量,则写入工作目录下的 .phaseo-devtools。在所有提供 DevTools 的语言中,这一行为都相同。

会写入什么

每条记录的 type 对运行为 agent.run,对继续操作为 agent.continue。agent.continue 是记录类型,而不是方法名:调用 continueRun()(TypeScript、PHP、Java)、continue_run()(Python、Ruby)、Continue(Go)或 ContinueRun(C#)时写入的就是它。 一条记录包含运行 ID 和智能体 ID、工具数量以及完整的运行结果:状态、消息、带有模型、提供商和网关请求 ID 的步骤、工具活动、用量和输出。失败的运行会得到一条带有错误的记录(Go 和 Java 中为 error.message;TypeScript 中为结构化的失败详情)。在 Java 中,写入错误会被忽略,所以捕获永远不会让运行失败。
记录以明文保存提示词、消息、应用上下文、工具输入和工具输出。请让该目录远离源代码管理和生产镜像,也不要把它用作审计存储。生产环境的遥测请使用生命周期钩子。
最后修改于 2026年11月5日