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.

POST /support/ask

Interroger l’agent de support Firecrawl

cURL

curl --request POST \
  --url https://api.firecrawl.dev/v2/support/ask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>",
  "rationale": "<string>"
}
'

200

{
  "answer": "<string>",
  "durationMs": 123,
  "feedback": {},
  "fixParameters": {},
  "validation": {}
}

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

Autorisations

Authorization · string · header · requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Corps

application/json

question · string · requis

Question ou problème à diagnostiquer par l’agent de support.

rationale · string

Contexte facultatif sur ce que l’utilisateur final cherche à accomplir.

Réponse

200

application/json

Réponse de l’agent de support

answer · string

Diagnostic et correction recommandée.

confidence · enum<string>

Options disponibles: high, medium, low

durationMs · integer

Temps d’exécution total de l’agent de support, en millisecondes.

feedback · object

Présent lorsque l’agent de support est bloqué ou a besoin de plus d’informations.

fixParameters · object

Paramètres d’API lisibles par machine pouvant résoudre le problème.

validation · object

Résultat de validation lorsque l’agent de support a testé ou tenté une correction.