Skip to main content
GET
获取代理任务的执行追踪
每次代理运行都会记录一份规范的执行追踪:按顺序记录本次运行所执行的所有操作,包括调用的工具及其返回结果、推理摘要、进度更新、浏览器会话,以及输出产物的变更。这与 Agent playground 中实时活动视图使用的是同一事件流。

用途

  • 调试运行 — 查看代理执行的具体搜索、抓取和提取操作、各工具的输入 (tool_call.started) 和结果 (tool_call.finished) ,以及运行在哪一步出错 (error.occurred,还有最终 run.finished 事件的 outcome 和结构化 error) 。
  • 实时进度 UI — 在任务处于 processing 状态时轮询执行追踪,实时展示代理正在执行的操作。progress.reported 事件包含运行阶段 (planningworkingfinalizing) 及易于理解的消息,reasoning.summary 事件则会呈现代理的思考过程。
  • 实时浏览器视图 — 运行期间传入 ?liveView=true,即可获取 activeBrowserSessions:该运行的活跃浏览器会话。每个会话都提供可嵌入的 liveViewUrl,可用于观看 (或演示) 代理浏览网页的过程。
  • 成本跟踪creditsUsed 会报告截至目前已消耗的额度;如果设置了运行的 maxCredits,消耗额度不会超过该上限。

工作原理

事件由运行中的代理 (orchestrator 及其 subagent) 发出,每个事件都会在 agent 字段中标识发出者。浏览器操作在代理自己的浏览器会话中进行,并通过 browser.session.* 事件上报,而非由独立的浏览器代理执行。请按 producerSequence (每个事件发出代理各自的序列) 对事件排序。type 字段用于区分 13 种事件变体;完整列表及各变体的字段请参见下方的响应 schema。 artifact.updated 事件本身不包含输出产物内容,而是通过 snapshotId 引用该内容;您可通过 snapshot endpoint 获取。 在收到 run.finished 后,事件可能还会继续到达一小段时间。因此,如果您正在轮询实时运行,请在渲染最终状态前保留一个短暂的收尾窗口。
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

查询参数

liveView
enum<string>

如果为 "true",则包含带有实时视图 URL 的当前活跃浏览器会话。

可用选项:
true,
false

响应

成功响应

activeBrowserSessions
object[]

当前活跃的浏览器会话(仅当 liveView=true 时提供)。

creditsUsed
number

截至目前已消耗的额度;如果设置了 maxCredits,则以该值为上限。

events
(run.started · object | run.cancel_requested · object | run.finished · object | agent.started · object | agent.finished · object | browser.session.started · object | browser.session.finished · object | progress.reported · object | reasoning.summary · object | tool_call.started · object | tool_call.finished · object | artifact.updated · object | error.occurred · object)[]

运行的规范执行事件;按 producerSequence 排序。artifact.updated 事件包含快照端点使用的 snapshotId 值。

代理运行产生的规范执行事件。每个事件都包含封装字段 schemaVersion、eventId、runId、occurredAt、producerSequence 和 agent;type 字段用于区分变体。usage.recorded 事件为内部事件,绝不会公开;agent.started 事件不包含 model 字段。

id
string<uuid>
success
boolean