Agent Traceを取得

各エージェント 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 の到着後もしばらくはイベントが届くことがあります。そのため、実行中のライブ実行をポーリングしている場合は、最終状態をレンダリングする前に短いテールウィンドウを設けてください。

Firecrawl APIキーが必要なAIエージェントですか？自動オンボーディングの手順については、firecrawl.dev/agent-onboarding/SKILL.md を参照してください。