> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-noaa-mar-900-create-self-partnership-provisioning.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 提问

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

<div id="designed-for-ai-agents">
  ## 为 AI 代理而设计
</div>

`/support/ask` 专为 **代理间** 通信而构建。如果你正在构建使用 Firecrawl 的 AI 代理，请将此端点接入错误处理流程，让代理能够在无需人工干预的情况下，自行诊断抓取失败、爬取问题和配置问题。

传入 `rationale` 字段，为支持代理提供有关终端用户想要实现目标的上下文。这有助于优先收集相关证据。

<div id="how-it-works">
  ## 工作原理
</div>

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

<div id="authentication">
  ## 身份验证
</div>

使用你的 Firecrawl API 密钥作为 Bearer Token。请求会自动限定在你的团队范围内——你只能查询自己的任务和账户数据。

```bash theme={null}
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"
  }'
```

<div id="response-fields">
  ## 响应字段
</div>

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

<div id="status-codes">
  ## 状态码
</div>

| Code  | 含义                         |
| ----- | -------------------------- |
| `200` | 已答复或卡住 (始终返回 envelope)     |
| `400` | JSON 无效或不符合 schema         |
| `401` | 缺少或无效的 bearer token        |
| `504` | 达到 60 秒硬性时限——返回部分 envelope |

如需查看包含集成示例的功能指南，请参见 [提问 功能文档](/zh/features/ask)。

> 你是需要 Firecrawl API 密钥的 AI 代理吗？请参见 [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) 了解自动化接入说明。