エージェントジョブの実行トレースを取得
エージェントエンドポイント
Agent Traceを取得
GET
エージェントジョブの実行トレースを取得
各エージェント runでは、正規の実行トレースが記録されます。これは、呼び出したツールとその戻り値、推論の要約、進捗アップデート、ブラウザセッション、出力アーティファクトへの変更など、実行中に行われたすべての操作を記録した時系列のイベントストリームです。これは、Agent playgroundのライブActivityビューを支えるイベントストリームと同じものです。
イベントは、実行内のエージェント (
用途
- 実行のデバッグ — エージェントが実行した検索、スクレイピング、抽出の内容、各ツールの入力 (
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種類のイベントバリアントを区別します。全一覧と各バリアントのフィールドについては、以下のレスポンススキーマを参照してください。
artifact.updated イベントにはアーティファクトのコンテンツ自体は含まれません。snapshotId によって参照されるため、snapshot endpoint から取得してください。
run.finished の到着後もしばらくはイベントが届くことがあります。そのため、実行中のライブ実行をポーリングしている場合は、最終状態をレンダリングする前に短いテールウィンドウを設けてください。
トレースは Spark 2 の実行 (すべての新規実行) で記録されます。廃止前に Spark 1 モデルで開始されたジョブにはトレースがなく、
400 が返されます。Firecrawl APIキーが必要なAIエージェントですか?自動オンボーディングの手順については、firecrawl.dev/agent-onboarding/SKILL.md を参照してください。
承認
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
パスパラメータ
エージェントジョブの ID
クエリパラメータ
"true" の場合、ライブビュー URL を含む現在アクティブなブラウザセッションを含めます。
利用可能なオプション:
true, false レスポンス
成功したレスポンス
現在アクティブなブラウザセッション(liveView=true の場合にのみ存在)。
これまでに消費したクレジット数。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 イベントには、snapshots エンドポイントで使用する snapshotId の値が含まれます。
エージェント実行の正規イベント。すべてのイベントには、schemaVersion、eventId、runId、occurredAt、producerSequence、agent のエンベロープフィールドが含まれ、type フィールドでバリアントを識別します。usage.recorded イベントは内部用で公開されず、agent.started イベントには model フィールドが含まれません。
- run.started
- run.cancel_requested
- run.finished
- agent.started
- agent.finished
- browser.session.started
- browser.session.finished
- progress.reported
- reasoning.summary
- tool_call.started
- tool_call.finished
- artifact.updated
- error.occurred

