> ## 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` エンドポイントは、Firecrawl のジョブ、アカウント、API 利用に関する問題を診断する AI サポートエージェントです。質問を送信すると、すぐに対処に使える修正用パラメータを含む検証済みの回答が返されます。通常は 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>

Bearer トークンとして Firecrawl APIキーを使用します。リクエストは自動的に所属チームのスコープに制限されるため、参照できるのは自身のジョブとアカウントデータのみです。

```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>

| コード   | 意味                               |
| ----- | -------------------------------- |
| `200` | 回答済み、または処理が停止中 (エンベロープは常に返されます)  |
| `400` | 無効なJSON、またはスキーマ違反                |
| `401` | Bearerトークンがない、または無効              |
| `504` | 60秒のハード制限に達した — 部分的なエンベロープが返されます |

連携例を含む機能ガイドについては、[Ask 機能のドキュメント](/ja/features/ask)を参照してください。

> Firecrawl APIキーが必要なAIエージェントですか？ 自動オンボーディング手順については、[firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md)を参照してください。