获取代理执行追踪

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

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

事件由运行中的代理 (orchestrator 及其 subagent) 发出，每个事件都会在 agent 字段中标识发出者。浏览器操作在代理自己的浏览器会话中进行，并通过 browser.session.* 事件上报，而非由独立的浏览器代理执行。请按 producerSequence (每个事件发出代理各自的序列) 对事件排序。type 字段用于区分 13 种事件变体；完整列表及各变体的字段请参见下方的响应 schema。

artifact.updated 事件本身不包含输出产物内容，而是通过 snapshotId 引用该内容；您可通过 snapshot endpoint 获取。

在收到 run.finished 后，事件可能还会继续到达一小段时间。因此，如果您正在轮询实时运行，请在渲染最终状态前保留一个短暂的收尾窗口。

您是需要 Firecrawl API 密钥的 AI 代理吗？请参见 firecrawl.dev/agent-onboarding/SKILL.md 了解自动化接入说明。