Skip to content
Firecrawl Docs
Firecrawl Docs
Agentic Debugging 端点

提问

POST/support/ask

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

/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 句话说明问题诊断和修复方法
confidencestringhighmediumlow
fixParametersobjectnull
validationobjectnull
feedbackobjectnull
durationMsinteger总执行时间 (以毫秒为单位)
Code含义
200已答复或卡住 (始终返回 envelope)
400JSON 无效或不符合 schema
401缺少或无效的 bearer token
504达到 60 秒硬性时限——返回部分 envelope

如需查看包含集成示例的功能指南,请参见 提问 功能文档

你是需要 Firecrawl API 密钥的 AI 代理吗?请参见 firecrawl.dev/agent-onboarding/SKILL.md 了解自动化接入说明。

Was this page helpful?Suggest editsRaise issue