Skip to main content
GET
获取智能体任务状态
如果你是需要 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>
必填

Agent 任务的 ID

响应

成功的响应

creditsUsed
number
data
object

提取的数据(仅在状态为 completed 时可用)。运行失败时不会设置此字段,包括因达到额度上限而停止的运行。

effort
enum<string>

代理运行使用的推理预算(仅存在于设置了 effort 的运行中)

可用选项:
low,
medium,
high
error
string

错误信息(仅当状态为失败时出现)

expiresAt
string<date-time>
message
string

代理对结果的说明。如果运行因达到额度上限而停止并失败,此说明可能会指出哪些内容尚未完成。

model
enum<string>
默认值:spark-2

本次代理运行所使用的模型预设。每次新运行均在 spark-2 上执行;Spark 1 名称仅会出现在旧版运行中。

可用选项:
spark-2,
spark-1-pro,
spark-1-mini
partial
any

从未完成的运行中尽力恢复的 JSON。仅在部分失败的运行中提供,例如达到 maxCredits 上限的运行;运行仍在处理时不会提供。其中可能缺少行或字段,因此请勿将其视为完整结果。

partialSchemaValid
boolean

partial 是否通过请求中指定的 JSON 模式验证。仅当 partial 存在且请求包含 schema 时提供。

status
enum<string>
可用选项:
processing,
completed,
failed
stopReason
enum<string>

运行失败并提前停止的原因。credit_limit_reached 表示运行已达到 maxCredits 上限。仅在状态为 failed 时提供。

可用选项:
credit_limit_reached
success
boolean