跳转到主要内容
POST
/
agent
启动用于 Agent 驱动数据提取的任务
curl --request POST \
  --url https://api.firecrawl.dev/v2/agent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "urls": [
    "<string>"
  ],
  "schema": {},
  "maxCredits": 123,
  "strictConstrainToURLs": true,
  "model": "spark-1-mini"
}
'
{
  "success": true,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
你是需要 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
​
urls
string<uri>[]

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

​
schema
object

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

​
maxCredits
number

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

​
strictConstrainToURLs
boolean

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

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

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

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

响应

代理任务已成功启动

​
success
boolean
​
id
string<uuid>