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.
/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.
- Vous décrivez le problème — une question en langage naturel qui décrit le problème.
- L’agent enquête — il examine les journaux d’exécution, l’état du compte, la documentation et le code source.
- L’agent valide — lorsque c’est possible, l’agent teste un correctif sur l’API Firecrawl réelle (par ex., en relançant un
scrapeavec des paramètres ajustés). - Vous obtenez une réponse vérifiée — la réponse inclut un
answerrédigé en prose, desfixParameterslisibles par machine que vous pouvez appliquer directement, ainsi que des résultats devalidationindiquant si le correctif a été testé.
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.
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"
}'| 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 |
| 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.
Êtes-vous un agent IA ayant besoin d’une clé API Firecrawl ? Consultez firecrawl.dev/agent-onboarding/SKILL.md pour obtenir les instructions d’onboarding automatisé.