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.

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.

Ê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é.