エージェント の実行中は、出力アーティファクトがバージョン管理されます。これには、生成途中の構造化 JSON の結果や、生成された Markdown、HTML、テキスト、スクリーンショットのアーティファクトが含まれます。変更のたびに、新しいバージョンを snapshotId で参照する artifact.updated トレースイベント が発行されます。このエンドポイントでは、そのようなスナップショットの完全な内容を 1 件取得できます。
用途#
- 部分結果 — 実行が完了する前に、エージェントの構造化された出力をプレビューできます。JSON 結果アーティファクト (
artifactId: "result") は内容の増加に応じてスナップショットされるため、各snapshotIdは最終的なdataのある時点での状態を表します。 - レンダリング済みアーティファクト — Markdown レポートや訪問先ページのスクリーンショットなど、エージェントが生成した JSON 以外のアーティファクトの内容を取得できます。
- 実行の調査 — トレースと組み合わせることで、実行中に出力がどのように変化したかを正確に再現できます。
仕組み#
artifact.updated イベントの change フィールドは、スナップショットが前のスナップショットからどのように変化したかを示します。値は init (初回バージョン) 、partial、append、modify、update のいずれかです。変更のたびに新しい snapshotId が付与されます。現在の状態を取得するには最新のものを取得し、バージョン間の差分を確認するには履歴をたどります。
レスポンスの snapshot フィールドには、アーティファクトの内容が string として含まれます。json アーティファクトでは JSON エンコードされているため、使用前に解析してください。
Note
スナップショットは Spark 2 での実行時、つまりすべての新規実行時に記録されます。廃止前に Spark 1 モデルで開始されたジョブにはスナップショットがなく、
400 が返されます。Firecrawl APIキーが必要な AI エージェント ですか？自動オンボーディング手順については、firecrawl.dev/agent-onboarding/SKILL.md を参照してください。