Skip to main content
GET
获取代理任务的输出快照
代理运行期间,会对其输出工件进行版本控制——包括逐步生成的结构化 JSON 结果,以及生成的任何 Markdown、HTML、文本或截图。每次变更都会触发一个 artifact.updated 跟踪事件,并通过 snapshotId 引用新版本。此端点用于获取此类快照之一的完整内容。

用途

  • 部分结果 — 在运行完成前预览代理的结构化输出。JSON 结果工件 (artifactId: "result") 会随着内容增加持续生成快照,因此每个 snapshotId 都反映了最终 data 在某一时刻的状态。
  • 渲染后的工件 — 获取代理生成的非 JSON 工件内容,例如 Markdown 报告或其访问页面的截图。
  • 运行检查 — 结合追踪记录,准确还原输出在整个运行过程中的变化。

工作原理

artifact.updated 事件的 change 字段说明该快照相对于前一快照的变更类型:init (第一个版本) 、partialappendmodifyupdate。每次变更都会生成新的 snapshotId——获取最新快照以了解当前状态,或遍历历史记录以比较不同版本。 响应中的 snapshot 字段是字符串形式的工件内容。对于 json 工件,该字段经过 JSON 编码——使用前请先解析。
Spark 2 的运行会记录快照——也就是说,每次新运行都会记录快照。Spark 1 模型在退役前启动的任务没有快照,并会返回 400
你是需要 Firecrawl API 密钥的 AI 代理吗?请参见 firecrawl.dev/agent-onboarding/SKILL.md,获取自动化入门指引。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

路径参数

jobId
string<uuid>
必填

代理任务的 ID

snapshotId
string<uuid>
必填

来自 artifact.updated 追踪事件的快照 ID

响应

成功响应

id
string<uuid>
snapshot
string

以 JSON 编码字符串形式表示的快照内容 — 代理在运行过程中该时点的工作输出工件。

snapshotId
string<uuid>
success
boolean