# 質問 (/ja/api-reference/endpoint/ask)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1638 · updated: 2026-07-30 -->
Related: [検索](/ja/api-reference/endpoint/search.md), [検索フィードバック](/ja/api-reference/endpoint/search-feedback.md), [スクレイプ](/ja/api-reference/endpoint/scrape.md), [バッチスクレープ](/ja/api-reference/endpoint/batch-scrape.md), [バッチスクレイプのステータス取得](/ja/api-reference/endpoint/batch-scrape-get.md), [バッチスクレイプのキャンセル](/ja/api-reference/endpoint/batch-scrape-delete.md)

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

<div id="designed-for-ai-agents">
  ## AIエージェント向けに設計 [#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
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)を参照してください。

`POST /support/ask`

AIサポートエージェントで、Firecrawlのジョブ、アカウント、API利用に関する問題を診断します。

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "additionalProperties": true,
          "properties": {
            "question": {
              "description": "サポートエージェントが診断する質問または問題。",
              "type": "string"
            },
            "rationale": {
              "description": "エンドユーザーが何を達成しようとしているかに関する任意のコンテキスト。",
              "type": "string"
            }
          },
          "required": [
            "question"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "answer": {
                "description": "診断結果と推奨される修正内容。",
                "type": "string"
              },
              "confidence": {
                "enum": [
                  "high",
                  "medium",
                  "low"
                ],
                "type": "string"
              },
              "durationMs": {
                "description": "サポートエージェントの合計実行時間（ミリ秒）。",
                "type": "integer"
              },
              "feedback": {
                "additionalProperties": true,
                "description": "サポートエージェントが行き詰まっている場合、または追加情報が必要な場合に含まれます。",
                "nullable": true,
                "type": "object"
              },
              "fixParameters": {
                "additionalProperties": true,
                "description": "問題の修正に役立つ可能性がある、機械可読なAPIパラメータ。",
                "nullable": true,
                "type": "object"
              },
              "validation": {
                "additionalProperties": true,
                "description": "サポートエージェントが修正をテストまたは試行した際の検証結果。",
                "nullable": true,
                "type": "object"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "サポートエージェントの回答"
    },
    "400": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "description": "サポート用プロキシまたは上流のエラーコード。",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "無効なリクエスト"
    },
    "401": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "description": "サポート用プロキシまたは上流のエラーコード。",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Bearerトークンがないか、無効です"
    },
    "503": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "description": "サポート用プロキシまたは上流のエラーコード。",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "サポートエージェントは利用できません"
    },
    "504": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "description": "サポート用プロキシまたは上流のエラーコード。",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "サポートエージェントがタイムアウトしました"
    }
  }
}
```