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": {}
}
'

import requests

url = "https://api.firecrawl.dev/v2/support/ask"

payload = {
    "question": "<string>",
    "rationale": "<string>",
    "jobId": "<string>",
    "context": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({question: '<string>', rationale: '<string>', jobId: '<string>', context: {}})
};

fetch('https://api.firecrawl.dev/v2/support/ask', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v2/support/ask",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'question' => '<string>',
    'rationale' => '<string>',
    'jobId' => '<string>',
    'context' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v2/support/ask"

	payload := strings.NewReader("{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.firecrawl.dev/v2/support/ask")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v2/support/ask")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

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": {}
}
'

import requests

url = "https://api.firecrawl.dev/v2/support/ask"

payload = {
    "question": "<string>",
    "rationale": "<string>",
    "jobId": "<string>",
    "context": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({question: '<string>', rationale: '<string>', jobId: '<string>', context: {}})
};

fetch('https://api.firecrawl.dev/v2/support/ask', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v2/support/ask",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'question' => '<string>',
    'rationale' => '<string>',
    'jobId' => '<string>',
    'context' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v2/support/ask"

	payload := strings.NewReader("{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.firecrawl.dev/v2/support/ask")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v2/support/ask")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

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

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 scrape avec des paramètres ajustés).
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

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

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

validation

object | null

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

Show child attributes

feedback

object | null

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

Show child attributes

durationMs

integer

Temps d’exécution total en millisecondes.

Utilisation de l’API

Points de terminaison de recherche

Points de terminaison Scrape

Points de terminaison d’Interact

Points de terminaison de cartographie

Points de terminaison Parse

Points de terminaison Crawl

Points de terminaison de débogage des agents

Points de terminaison du compte

Payloads de webhook

Intégration partenaire

Conçu pour les agents IA

Comment ça marche

Authentification

Champs de la réponse

Codes d’état

Autorisations

Corps

Réponse

​Conçu pour les agents IA

​Comment ça marche

​Authentification

​Champs de la réponse

​Codes d’état

Autorisations

Corps

Réponse

Conçu pour les agents IA

Comment ça marche

Authentification

Champs de la réponse

Codes d’état