> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-noaa-mar-989-create-firecrawl-codex-plugins.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Ask
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.
## Conçu pour les agents IA
`/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.
## Comment ça marche
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é.
## Authentification
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"
}'
```
## Champs de la réponse
| 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 | |
## Codes d’état
| 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:
title: Firecrawl API
version: v2
description: >-
API pour interagir avec les services Firecrawl afin d’effectuer des tâches
de scraping et de crawling web.
contact:
name: Firecrawl Support
url: https://firecrawl.dev/support
email: support@firecrawl.dev
servers:
- url: https://api.firecrawl.dev/v2
security:
- bearerAuth: []
paths:
/support/ask:
post:
tags:
- Support
summary: >-
Diagnostiquer les problèmes Firecrawl à l’aide d’un agent d’assistance
IA
operationId: supportAsk
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- question
properties:
question:
type: string
minLength: 1
maxLength: 8000
description: >-
Éléments à diagnostiquer. Décrivez le problème que vous
rencontrez.
rationale:
type: string
minLength: 1
maxLength: 2000
description: >-
Recommandé pour les appelants IA. Décrivez en 1 à 2 phrases
ce que l’utilisateur final essaie d’accomplir.
jobId:
type: string
description: >-
ID de tâche Firecrawl facultatif associé à l’appel ayant
échoué. Des outils comme debugJob, searchLogs et getJob
l’utilisent automatiquement par défaut lorsqu’il est défini,
afin que l’agent n’ait pas besoin de l’extraire de la
question.
context:
type: object
description: >-
Métadonnées libres provenant de l’agent appelant, converties
en chaîne de caractères et intégrées à l’invite de
diagnostic.
responses:
'200':
description: >-
Diagnostic terminé. L’enveloppe est renvoyée, que l’agent ait trouvé
une réponse ou soit resté bloqué.
content:
application/json:
schema:
$ref: '#/components/schemas/AskResponse'
'400':
description: JSON invalide ou violation du schéma
content:
application/json:
schema:
type: object
properties:
error:
type: string
'401':
description: Jeton bearer manquant ou invalide
content:
application/json:
schema:
type: object
properties:
error:
type: string
'504':
description: "La limite stricte de 60\_secondes a été atteinte. Une enveloppe partielle peut être renvoyée."
content:
application/json:
schema:
$ref: '#/components/schemas/AskResponse'
security:
- bearerAuth: []
components:
schemas:
AskResponse:
type: object
properties:
requestId:
type: string
description: Identifiant unique de cette requête.
answer:
type: string
description: Texte de 2 à 4 phrases expliquant le problème et sa correction.
confidence:
type: string
enum:
- high
- medium
- low
description: Niveau de confiance de l’agent dans son diagnostic.
fixParameters:
type: object
nullable: true
description: >-
Paramètres d’API exploitables par une machine à appliquer pour
corriger le problème recommandé. Null si aucun correctif ne
s’applique.
validation:
type: object
nullable: true
description: >-
Indique si l’agent a testé le correctif sur l’API Firecrawl en
production.
properties:
tested:
type: boolean
result:
type: string
enum:
- success
- failure
- skipped
evidence:
type: string
feedback:
type: object
nullable: true
description: >-
Présent lorsque l’agent est bloqué et n’a pas pu produire de réponse
exploitable. Null en cas de succès.
properties:
blockedBy:
type: string
description: Brève description de ce que l’agent n’a pas pu faire.
attempted:
type: array
items:
type: string
description: Noms des outils que l’agent a essayés avant d’abandonner.
durationMs:
type: integer
description: Temps d’exécution total en millisecondes.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
````