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

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

exchange
object

此次运行通过 Alexandria 执行的操作。toolkits 和 requireApproval 是此次运行继承会话设置后最终确定的值。

expiresAt
string<date-time>
message
string

代理对结果的说明。在 chat 模式下,不请求新数据的后续请求会在此处获得回复,而不是在 data 中。如果运行因达到额度上限而停止并失败,此说明可能会指出哪些内容尚未完成。

mode
enum<string>
可用选项:
extract,
chat
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 时提供。

pendingApproval
object

本轮暂停以请求确认的事项。在会话的下一轮中使用 exchange.approve 或 exchange.decline 回应。

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

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

可用选项:
credit_limit_reached
success
boolean
suggestions
object[]

代理为会话下一轮提供的后续请求建议。

threadId
string<uuid>

本次运行所属的会话。

threadTurn
integer

本次运行在会话中的轮次,从 1 开始。