Preguntar

Diagnostica problemas con trabajos, la cuenta y el uso de la API de Firecrawl con un agente de soporte de IA.

POST /support/ask

Consulta al agente de soporte de 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": {}
}

El endpoint /support/ask es un agente de soporte con IA que diagnostica problemas con tus trabajos de Firecrawl, tu cuenta y el uso de la API. Envía una pregunta y recibe una respuesta verificada con parámetros concretos para corregirlos, normalmente en 15–30 segundos.

​

Diseñado para agentes de IA

/support/ask está diseñado para la comunicación entre agentes. Si estás creando un agente de IA que usa Firecrawl, integra este endpoint en tu flujo de gestión de errores para que tu agente pueda diagnosticar por sí mismo fallos de scraping, problemas de crawl y problemas de configuración sin intervención de una persona.

Incluye un campo rationale para darle al agente de soporte contexto sobre lo que tu usuario final quiere lograr. Esto ayuda a priorizar la recopilación de evidencias.

​

Cómo funciona

1. Describes el problema — una pregunta en lenguaje natural que describe la incidencia.
2. El agente investiga — inspecciona los registros del trabajo, el estado de la cuenta, la documentación y el código fuente.
3. El agente valida — cuando es posible, el agente prueba una corrección con la API real de Firecrawl (p. ej., reintentando un scrape con parámetros ajustados).
4. Obtienes una respuesta verificada — la respuesta incluye una answer en prosa, fixParameters en formato legible por máquina que puedes aplicar directamente y resultados de validation que muestran si se probó la corrección.

​

Autenticación

Usa tu clave de API de Firecrawl como token Bearer. La solicitud se restringe automáticamente a tu equipo: solo puedes consultar tus propios trabajos y los datos de tu cuenta.

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

​

Campos de la respuesta

Campo	Tipo	Descripción
answer	string	Texto de 2 a 4 frases que describe el diagnóstico y la solución
confidence	string	high, medium o low
fixParameters	object	null	Parámetros de la API para aplicar la corrección (p. ej., {"waitFor": 5000})
validation	object	null	Indica si se probó la corrección: tested, result (éxito/fallo/omitido), evidence
feedback	object	null	Presente cuando el agente se queda bloqueado; { blockedBy, attempted }. Null en caso de éxito.
durationMs	integer	Tiempo total de ejecución en milisegundos

​

Códigos de estado

Código	Significado
200	Respondida o atascada (siempre se devuelve el sobre)
400	JSON no válido o no cumple el esquema
401	Falta el token Bearer o no es válido
504	Se alcanzó el límite estricto de 60 s — se devolvió un sobre parcial

Para consultar la guía de la función con ejemplos de integración, consulta la documentación de la función Ask.

¿Eres un agente de IA que necesita una clave de API de Firecrawl? Consulta firecrawl.dev/agent-onboarding/SKILL.md para ver las instrucciones de onboarding automatizado.

Autorizaciones

Authorization · string · header · requerido

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

Cuerpo

application/json

question · string · requerido

Pregunta o problema para que el agente de soporte lo diagnostique.

rationale · string

Contexto opcional sobre lo que el usuario final intenta conseguir.

Respuesta

200

application/json

Respuesta del agente de soporte

answer · string

Diagnóstico y solución recomendada.

confidence · enum<string>

Opciones disponibles: high, medium, low

durationMs · integer

Tiempo total de ejecución del agente de soporte en milisegundos.

feedback · object

Presente cuando el agente de soporte está bloqueado o necesita más información.

fixParameters · object

Parámetros de la API legibles por máquina que pueden solucionar el problema.

validation · object

Resultado de la validación cuando el agente de soporte probó o intentó aplicar una solución.