.agent-runs/<run id>.json,并在你传入运行 ID 时恢复该运行。
该脚本仅作演示:文件存储只适用于单台机器。在生产环境中,保留同样的 load/save 函数对,但改用你的数据库作为存储。Phaseo 不会替你存储 Agent SDK 运行。
构建
1
安装
@phaseo/agent-sdk 会一并安装 @phaseo/sdk。设置你的密钥:2
编写智能体
agent.ts
3
运行
checkpoint 后用 Ctrl+C 停止脚本,然后传入它打印的运行 ID(一个 UUID):检查是否成功
- 脚本每一步打印一次
checkpoint,然后打印运行 ID、completed,以及一个包含phaseo.app/docsURL 的回答。 .agent-runs/<run id>.json保存了运行 ID、状态、消息历史、每一步的工具调用和结果,以及最终输出。- 运行被中断后,恢复命令会完成同一个运行 ID,而不是开始新的运行。
- 每个模型轮次都会出现在 设置 → 使用情况 → 日志 中。在每个请求 ID 旁边记录运行 ID,以便将二者对应起来。
保存的状态包含什么
每个保存的结果都是完整的AgentRunResult:run(ID、状态、消息、用量以及任何暂停信息)、带有 Gateway 请求 ID 和工具调用的 steps,以及运行完成后的 output。continueRun() 可以直接接受它,也可以接受 runId 加 state,此时它会自己调用 load()。
进程停止时正在运行的工具调用可能已经产生了效果,因此请让工具保持幂等。对于从未得到结果的调用,SDK 会在继续之前修复其历史记录。状态与审批介绍了暂停和审批。