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

# Ask

> Diagnostiquez les problèmes liés aux tâches Firecrawl, au compte et à l’utilisation de l’API avec un agent de support IA.

Le point de terminaison `/support/ask` est un agent d’assistance IA qui diagnostique les problèmes liés à vos jobs Firecrawl, à votre compte et à votre utilisation de l’API. Envoyez une question et recevez une réponse vérifiée avec des paramètres de correction concrets — généralement en 15–30 secondes.

<div id="designed-for-ai-agents">
  ## Conçu pour les agents IA
</div>

`/support/ask` est conçu pour une communication **d'agent à agent**. Si vous créez un agent IA qui utilise Firecrawl, intégrez ce point de terminaison à votre flux de gestion des erreurs afin que votre agent puisse diagnostiquer lui-même les échecs de scraping, les problèmes de crawl et les erreurs de configuration, sans intervention humaine.

Transmettez un champ `rationale` pour donner à l'agent d'assistance du contexte sur ce que votre utilisateur final cherche à accomplir. Cela permet de prioriser la collecte d'éléments probants.

<div id="how-it-works">
  ## Comment ça marche
</div>

1. **Vous décrivez le problème** — une question en langage naturel qui décrit le problème.
2. **L’agent enquête** — il examine les journaux d’exécution, l’état du compte, la documentation et le code source.
3. **L’agent valide** — lorsque c’est possible, l’agent teste un correctif sur l’API Firecrawl réelle (par ex., en relançant un `scrape` avec des paramètres ajustés).
4. **Vous obtenez une réponse vérifiée** — la réponse inclut un `answer` rédigé en prose, des `fixParameters` lisibles par machine que vous pouvez appliquer directement, ainsi que des résultats de `validation` indiquant si le correctif a été testé.

<div id="authentication">
  ## Authentification
</div>

Utilise votre clé API Firecrawl comme jeton Bearer. La requête est automatiquement restreinte à votre équipe — vous ne pouvez consulter que vos propres jobs et les données de votre compte.

```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">
  ## Champs de la réponse
</div>

| Champ           | Type    | Description                                                     |                                                                                                |
| --------------- | ------- | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `answer`        | string  | Texte de 2 à 4 phrases expliquant le diagnostic et le correctif |                                                                                                |
| `confidence`    | string  | `high`, `medium` ou `low`                                       |                                                                                                |
| `fixParameters` | object  | null                                                            | Paramètres d'API à appliquer pour le correctif (par ex., `{"waitFor": 5000}`)                  |
| `validation`    | object  | null                                                            | Indique si le correctif a été testé : `tested`, `result` (success/failure/skipped), `evidence` |
| `feedback`      | object  | null                                                            | Présent lorsque l'agent est bloqué ; `{ blockedBy, attempted }`. `null` en cas de réussite.    |
| `durationMs`    | integer | Temps d'exécution total en millisecondes                        |                                                                                                |

<div id="status-codes">
  ## Codes d’état
</div>

| Code  | Signification                                                       |
| ----- | ------------------------------------------------------------------- |
| `200` | Réponse fournie ou bloqué (enveloppe toujours renvoyée)             |
| `400` | JSON invalide ou non-conformité au schéma                           |
| `401` | Jeton Bearer manquant ou invalide                                   |
| `504` | Délai maximal strict de 60 s atteint — enveloppe partielle renvoyée |

Pour le guide de la fonctionnalité avec des exemples d’intégration, consultez la [documentation de la fonctionnalité Ask](/fr/features/ask).

> Êtes-vous un agent IA ayant besoin d’une clé API Firecrawl ? Consultez [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) pour obtenir les instructions d’onboarding automatisé.


## OpenAPI

````yaml fr/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: >-
    API pour interagir avec les services Firecrawl afin d’effectuer des tâches
    de scraping et de crawling web.
  title: Firecrawl API
  version: v2
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /support/ask:
    post:
      tags:
        - Support
      summary: Interroger l’agent de support Firecrawl
      description: >-
        Diagnostiquez les problèmes liés aux tâches Firecrawl, au compte et à
        l’utilisation de l’API avec un agent de support IA.
      operationId: askSupportAgent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SupportAskRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportAskResponse'
          description: Réponse de l’agent de support
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportProxyErrorResponse'
          description: Requête non valide
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportProxyErrorResponse'
          description: Jeton Bearer manquant ou invalide
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportProxyErrorResponse'
          description: Agent de support indisponible
        '504':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportProxyErrorResponse'
          description: Délai d’attente de l’agent de support dépassé
      security:
        - bearerAuth: []
components:
  schemas:
    SupportAskRequest:
      additionalProperties: true
      properties:
        question:
          description: Question ou problème à diagnostiquer par l’agent de support.
          type: string
        rationale:
          description: >-
            Contexte facultatif sur ce que l’utilisateur final cherche à
            accomplir.
          type: string
      required:
        - question
      type: object
    SupportAskResponse:
      properties:
        answer:
          description: Diagnostic et correction recommandée.
          type: string
        confidence:
          enum:
            - high
            - medium
            - low
          type: string
        durationMs:
          description: Temps d’exécution total de l’agent de support, en millisecondes.
          type: integer
        feedback:
          additionalProperties: true
          description: >-
            Présent lorsque l’agent de support est bloqué ou a besoin de plus
            d’informations.
          nullable: true
          type: object
        fixParameters:
          additionalProperties: true
          description: Paramètres d’API lisibles par machine pouvant résoudre le problème.
          nullable: true
          type: object
        validation:
          additionalProperties: true
          description: >-
            Résultat de validation lorsque l’agent de support a testé ou tenté
            une correction.
          nullable: true
          type: object
      type: object
    SupportProxyErrorResponse:
      properties:
        error:
          description: Code d’erreur du proxy de support ou du service amont.
          type: string
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````