> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-noaa-mar-989-create-firecrawl-codex-plugins.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Preguntar
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.
```bash theme={null}
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](/es/features/ask).
> ¿Eres un agente de IA que necesita una clave de API de Firecrawl? Consulta [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para ver las instrucciones de onboarding automatizado.
## OpenAPI
````yaml /es/api-reference/v2-openapi.json POST /support/ask
openapi: 3.0.0
info:
title: Firecrawl API
version: v2
description: >-
API para interactuar con los servicios de Firecrawl y realizar tareas de
scraping y rastreo web.
contact:
name: Firecrawl Support
url: https://firecrawl.dev/support
email: support@firecrawl.dev
servers:
- url: https://api.firecrawl.dev/v2
security:
- bearerAuth: []
paths:
/support/ask:
post:
tags:
- Support
summary: Diagnostica problemas de Firecrawl con un agente de soporte con IA
operationId: supportAsk
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- question
properties:
question:
type: string
minLength: 1
maxLength: 8000
description: >-
Qué diagnosticar. Describe el problema que estás
experimentando.
rationale:
type: string
minLength: 1
maxLength: 2000
description: >-
Recomendado para agentes de IA que realizan llamadas. 1-2
frases sobre lo que el usuario final intenta lograr.
jobId:
type: string
description: >-
ID de trabajo opcional de Firecrawl con el que se asoció la
llamada fallida. Herramientas como debugJob, searchLogs y
getJob usan este valor de forma predeterminada cuando se
establece, por lo que el agente no necesita extraerlo de la
pregunta.
context:
type: object
description: >-
Metadatos de formato libre del agente que realiza la
llamada, convertidos en string dentro del prompt de
diagnóstico.
responses:
'200':
description: >-
Diagnóstico completado. El contenedor se devuelve tanto si el agente
encontró una respuesta como si se quedó atascado.
content:
application/json:
schema:
$ref: '#/components/schemas/AskResponse'
'400':
description: JSON no válido o incumplimiento del esquema
content:
application/json:
schema:
type: object
properties:
error:
type: string
'401':
description: Token de portador ausente o no válido
content:
application/json:
schema:
type: object
properties:
error:
type: string
'504':
description: >-
Se alcanzó el límite estricto de 60 segundos. Puede devolverse un
contenedor parcial.
content:
application/json:
schema:
$ref: '#/components/schemas/AskResponse'
security:
- bearerAuth: []
components:
schemas:
AskResponse:
type: object
properties:
requestId:
type: string
description: Identificador único de esta solicitud.
answer:
type: string
description: Texto de 2 a 4 frases que explica qué falla y cómo corregirlo.
confidence:
type: string
enum:
- high
- medium
- low
description: Nivel de confianza del agente en el diagnóstico.
fixParameters:
type: object
nullable: true
description: >-
Parámetros de API accionables por máquina para aplicar la corrección
recomendada. Null si no corresponde ninguna corrección.
validation:
type: object
nullable: true
description: >-
Indica si el agente probó la corrección en la API activa de
Firecrawl.
properties:
tested:
type: boolean
result:
type: string
enum:
- success
- failure
- skipped
evidence:
type: string
feedback:
type: object
nullable: true
description: >-
Presente cuando el agente se queda atascado y no puede generar una
respuesta útil. Null en caso de éxito.
properties:
blockedBy:
type: string
description: Descripción breve de lo que el agente no pudo hacer.
attempted:
type: array
items:
type: string
description: >-
Nombres de las herramientas que el agente probó antes de
rendirse.
durationMs:
type: integer
description: Tiempo total de ejecución en milisegundos.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
````