跳转到主要内容
POST
/
support
/
ask
使用 AI 支持代理诊断 Firecrawl 问题
curl --request POST \
  --url https://api.firecrawl.dev/v2/support/ask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>",
  "rationale": "<string>",
  "jobId": "<string>",
  "context": {}
}
'
{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt

Use this file to discover all available pages before exploring further.

/support/ask 端点是一个 AI 支持代理，可帮助诊断 Firecrawl 任务、账户和 API 使用方式中的问题。提交问题后，你将收到经过验证的答案，以及可直接采取行动的修复参数——通常会在 15–30 秒内返回。

​
为 AI 代理而设计

/support/ask 专为 代理间 通信而构建。如果你正在构建使用 Firecrawl 的 AI 代理，请将此端点接入错误处理流程，让代理能够在无需人工干预的情况下，自行诊断抓取失败、爬取问题和配置问题。 传入 rationale 字段，为支持代理提供有关终端用户想要实现目标的上下文。这有助于优先收集相关证据。

​
工作原理

  1. 你描述问题 — 用自然语言说明你遇到的问题。
  2. 代理进行调查 — 它会检查任务日志、账户状态、文档和源代码。
  3. 代理进行验证 — 在可能的情况下，代理会针对实时 Firecrawl API 测试修复方案 (例如使用调整后的参数重试抓取) 。
  4. 你获得经过验证的答案 — 响应中包含文字说明形式的 answer、可直接应用的机器可读 fixParameters，以及表明该修复是否经过测试的 validation 结果。

​
身份验证

使用你的 Firecrawl API 密钥作为 Bearer Token。请求会自动限定在你的团队范围内——你只能查询自己的任务和账户数据。 
curl -X POST https://api.firecrawl.dev/v2/support/ask \
  -H "Authorization: Bearer fc-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "my crawl returned 3 pages but I expected 50",
    "rationale": "user is on their third failed crawl attempt today"
  }'

​
响应字段

字段类型描述
answerstring用 2-4 句话说明问题诊断和修复方法
confidencestringhigh、medium 或 low
fixParametersobjectnull用于应用修复的 API 参数 (例如 {"waitFor": 5000})
validationobjectnull修复是否已测试：tested、result (success/failure/skipped) 、evidence
feedbackobjectnull当代理陷入卡住状态时提供；{ blockedBy, attempted }。成功时为 null。
durationMsinteger总执行时间 (以毫秒为单位)

​
状态码

Code含义
200已答复或卡住 (始终返回 envelope)
400JSON 无效或不符合 schema
401缺少或无效的 bearer token
504达到 60 秒硬性时限——返回部分 envelope
如需查看包含集成示例的功能指南，请参见 提问 功能文档。
你是需要 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
​
question
string
必填

要诊断的内容。请描述你遇到的问题。

Required string length: 1 - 8000
​
rationale
string

建议供 AI 调用方使用。用 1-2 句话说明最终用户想要完成的目标。

Required string length: 1 - 2000
​
jobId
string

与失败调用关联的可选 Firecrawl 任务 ID。设置后，debugJob、searchLogs 和 getJob 等工具会默认自动使用此 ID，因此代理无需从问题中提取。

​
context
object

来自调用代理的自由格式元数据，会被序列化为字符串并写入诊断 prompt。

响应

诊断完成。无论代理是否找到答案或陷入卡顿，都会返回该封装响应。

​
requestId
string

此请求的唯一标识符。

​
answer
string

用 2-4 句话说明问题所在及修复方法。

​
confidence
enum<string>

代理对诊断结果的置信度。

可用选项:
high,
medium,
low
​
fixParameters
object

用于应用推荐修复的、可供机器执行的 API 参数。若无适用修复，则为 Null。

​
validation
object

代理是否已针对实时 Firecrawl API 测试该修复。

​
feedback
object

当代理陷入卡顿且无法给出可用答案时出现。成功时为 Null。

​
durationMs
integer

总执行时间（毫秒）。