# Ask (/fr/api-reference/endpoint/ask)
Related: [Recherche](/fr/api-reference/endpoint/search.md), [Retour sur la recherche](/fr/api-reference/endpoint/search-feedback.md), [Scrape](/fr/api-reference/endpoint/scrape.md), [Scrape par lot](/fr/api-reference/endpoint/batch-scrape.md), [Obtenir l’état d’une extraction par lot](/fr/api-reference/endpoint/batch-scrape-get.md), [Annuler une extraction par lots](/fr/api-reference/endpoint/batch-scrape-delete.md)
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 [#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 [#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 [#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
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 [#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 [#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é.
`POST /support/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.
## OpenAPI
```json
{
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"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"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"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"
}
}
},
"description": "Réponse de l’agent de support"
},
"400": {
"content": {
"application/json": {
"schema": {
"properties": {
"error": {
"description": "Code d’erreur du proxy de support ou du service amont.",
"type": "string"
}
},
"type": "object"
}
}
},
"description": "Requête non valide"
},
"401": {
"content": {
"application/json": {
"schema": {
"properties": {
"error": {
"description": "Code d’erreur du proxy de support ou du service amont.",
"type": "string"
}
},
"type": "object"
}
}
},
"description": "Jeton Bearer manquant ou invalide"
},
"503": {
"content": {
"application/json": {
"schema": {
"properties": {
"error": {
"description": "Code d’erreur du proxy de support ou du service amont.",
"type": "string"
}
},
"type": "object"
}
}
},
"description": "Agent de support indisponible"
},
"504": {
"content": {
"application/json": {
"schema": {
"properties": {
"error": {
"description": "Code d’erreur du proxy de support ou du service amont.",
"type": "string"
}
},
"type": "object"
}
}
},
"description": "Délai d’attente de l’agent de support dépassé"
}
}
}
```