Skip to main content
GET
エージェントジョブの出力スナップショットを取得
エージェント の実行中は、出力アーティファクトがバージョン管理されます。これには、生成途中の構造化 JSON の結果や、生成された Markdown、HTML、テキスト、スクリーンショットのアーティファクトが含まれます。変更のたびに、新しいバージョンを snapshotId で参照する artifact.updated トレースイベント が発行されます。このエンドポイントでは、そのようなスナップショットの完全な内容を 1 件取得できます。

用途

  • 部分結果 — 実行が完了する前に、エージェントの構造化された出力をプレビューできます。JSON 結果アーティファクト (artifactId: "result") は内容の増加に応じてスナップショットされるため、各 snapshotId は最終的な data のある時点での状態を表します。
  • レンダリング済みアーティファクト — Markdown レポートや訪問先ページのスクリーンショットなど、エージェントが生成した JSON 以外のアーティファクトの内容を取得できます。
  • 実行の調査 — トレースと組み合わせることで、実行中に出力がどのように変化したかを正確に再現できます。

仕組み

artifact.updated イベントの change フィールドは、スナップショットが前のスナップショットからどのように変化したかを示します。値は init (初回バージョン) 、partialappendmodifyupdate のいずれかです。変更のたびに新しい snapshotId が付与されます。現在の状態を取得するには最新のものを取得し、バージョン間の差分を確認するには履歴をたどります。 レスポンスの snapshot フィールドには、アーティファクトの内容が string として含まれます。json アーティファクトでは JSON エンコードされているため、使用前に解析してください。
スナップショットは 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

snapshotId
string<uuid>
必須

artifact.updated トレースイベントから取得したスナップショット ID

レスポンス

成功したレスポンス

id
string<uuid>
snapshot
string

JSON エンコードされた文字列としてのスナップショット内容 — 実行中のその時点におけるエージェントの作業用出力アーティファクト。

snapshotId
string<uuid>
success
boolean