> ## 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.

# 質問

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

`/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)を参照してください。


## OpenAPI

````yaml ja/api-reference/v2-openapi.json POST /support/ask
openapi: 3.0.0
info:
  contact:
    email: support@firecrawl.dev
    name: Firecrawl Support
    url: https://firecrawl.dev/support
  description: Firecrawlのサービスを利用して、Webスクレイピングやクロールを行うためのAPIです。
  title: Firecrawl API
  version: v2
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /support/ask:
    post:
      tags:
        - Support
      summary: Firecrawlのサポートエージェントに問い合わせる
      description: AIサポートエージェントで、Firecrawlのジョブ、アカウント、API利用に関する問題を診断します。
      operationId: askSupportAgent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SupportAskRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportAskResponse'
          description: サポートエージェントの回答
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportProxyErrorResponse'
          description: 無効なリクエスト
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportProxyErrorResponse'
          description: Bearerトークンがないか、無効です
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportProxyErrorResponse'
          description: サポートエージェントは利用できません
        '504':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportProxyErrorResponse'
          description: サポートエージェントがタイムアウトしました
      security:
        - bearerAuth: []
components:
  schemas:
    SupportAskRequest:
      additionalProperties: true
      properties:
        question:
          description: サポートエージェントが診断する質問または問題。
          type: string
        rationale:
          description: エンドユーザーが何を達成しようとしているかに関する任意のコンテキスト。
          type: string
      required:
        - question
      type: object
    SupportAskResponse:
      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
    SupportProxyErrorResponse:
      properties:
        error:
          description: サポート用プロキシまたは上流のエラーコード。
          type: string
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````