Passer au contenu principal
POST
/
support
/
ask
Diagnostiquer les problèmes Firecrawl à l’aide d’un agent d’assistance IA
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>",
  "jobId": "<string>",
  "context": {}
}
'
{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt

Use this file to discover all available pages before exploring further.

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

ChampTypeDescription
answerstringTexte de 2 à 4 phrases expliquant le diagnostic et le correctif
confidencestringhigh, medium ou low
fixParametersobjectnullParamètres d’API à appliquer pour le correctif (par ex., {"waitFor": 5000})
validationobjectnullIndique si le correctif a été testé : tested, result (success/failure/skipped), evidence
feedbackobjectnullPrésent lorsque l’agent est bloqué ; { blockedBy, attempted }. null en cas de réussite.
durationMsintegerTemps d’exécution total en millisecondes

​
Codes d’état

CodeSignification
200Réponse fournie ou bloqué (enveloppe toujours renvoyée)
400JSON invalide ou non-conformité au schéma
401Jeton Bearer manquant ou invalide
504Dé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

Éléments à diagnostiquer. Décrivez le problème que vous rencontrez.

Required string length: 1 - 8000
​
rationale
string

Recommandé pour les appelants IA. Décrivez en 1 à 2 phrases ce que l’utilisateur final essaie d’accomplir.

Required string length: 1 - 2000
​
jobId
string

ID de tâche Firecrawl facultatif associé à l’appel ayant échoué. Des outils comme debugJob, searchLogs et getJob l’utilisent automatiquement par défaut lorsqu’il est défini, afin que l’agent n’ait pas besoin de l’extraire de la question.

​
context
object

Métadonnées libres provenant de l’agent appelant, converties en chaîne de caractères et intégrées à l’invite de diagnostic.

Réponse

Diagnostic terminé. L’enveloppe est renvoyée, que l’agent ait trouvé une réponse ou soit resté bloqué.

​
requestId
string

Identifiant unique de cette requête.

​
answer
string

Texte de 2 à 4 phrases expliquant le problème et sa correction.

​
confidence
enum<string>

Niveau de confiance de l’agent dans son diagnostic.

Options disponibles:
high,
medium,
low
​
fixParameters
object

Paramètres d’API exploitables par une machine à appliquer pour corriger le problème recommandé. Null si aucun correctif ne s’applique.

​
validation
object

Indique si l’agent a testé le correctif sur l’API Firecrawl en production.

​
feedback
object

Présent lorsque l’agent est bloqué et n’a pas pu produire de réponse exploitable. Null en cas de succès.

​
durationMs
integer

Temps d’exécution total en millisecondes.