Skip to main content
POST
Interroger l’agent de support Firecrawl
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.

Champs de la réponse

Codes d’état

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

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 | null

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

fixParameters
object | null

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

validation
object | null

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