Skip to main content
POST
启动用于 Agent 驱动数据提取的任务
你是需要 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.

请求体

application/json
prompt
string
必填

用于描述应提取哪些数据的提示词

Maximum string length: 10000
auditMetadata
object

为组织启用 SIEM Logging 后,SIEM 日志事件中会包含用户归属信息。

maxCredits
number

此代理任务可使用的最大额度。若未设置,默认值为 2500。高于 2,500 的值一律按付费请求计费。

model
enum<string>
默认值:spark-1-mini

适用于智能体任务的模型。spark-1-mini(默认)成本更低,价格便宜约 60%;spark-1-pro 在处理复杂任务时能提供更高的准确率。

可用选项:
spark-1-mini,
spark-1-pro
schema
object

用于定义提取数据结构的可选 JSON Schema

strictConstrainToURLs
boolean

如果为 true,代理将仅访问 urls 数组中提供的 URL

threatProtection
Threat Protection Override · object

此请求的威胁防护按请求覆盖配置。你提供的字段仅会替换此次请求中你所在组织策略的对应字段;未提供的字段则保留组织级配置值。你的团队必须已启用威胁防护(企业版功能),否则该请求会因 403 被拒绝。如果你的组织已禁用请求级覆盖,任何包含此对象的请求都会因 403 被拒绝。如果你的团队强制启用了威胁防护,则不得将 mode 设为 off

urls
string<uri>[]

用于限定智能体访问范围的可选 URL 列表

响应

代理任务已成功启动

id
string<uuid>
success
boolean