> ## 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.
# Preguntar
> Diagnostica problemas con trabajos, la cuenta y el uso de la API de Firecrawl con un agente de soporte de IA.
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:
contact:
email: support@firecrawl.dev
name: Firecrawl Support
url: https://firecrawl.dev/support
description: >-
API para interactuar con los servicios de Firecrawl y realizar tareas de
scraping y rastreo web.
title: Firecrawl API
version: v2
servers:
- url: https://api.firecrawl.dev/v2
security:
- bearerAuth: []
paths:
/support/ask:
post:
tags:
- Support
summary: Consulta al agente de soporte de Firecrawl
description: >-
Diagnostica problemas con trabajos, la cuenta y el uso de la API de
Firecrawl con un agente de soporte de IA.
operationId: askSupportAgent
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SupportAskRequest'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/SupportAskResponse'
description: Respuesta del agente de soporte
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/SupportProxyErrorResponse'
description: Solicitud no válida
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/SupportProxyErrorResponse'
description: Token de portador ausente o no válido
'503':
content:
application/json:
schema:
$ref: '#/components/schemas/SupportProxyErrorResponse'
description: Agente de soporte no disponible
'504':
content:
application/json:
schema:
$ref: '#/components/schemas/SupportProxyErrorResponse'
description: Tiempo de espera agotado del agente de soporte
security:
- bearerAuth: []
components:
schemas:
SupportAskRequest:
additionalProperties: true
properties:
question:
description: Pregunta o problema para que el agente de soporte lo diagnostique.
type: string
rationale:
description: Contexto opcional sobre lo que el usuario final intenta conseguir.
type: string
required:
- question
type: object
SupportAskResponse:
properties:
answer:
description: Diagnóstico y solución recomendada.
type: string
confidence:
enum:
- high
- medium
- low
type: string
durationMs:
description: Tiempo total de ejecución del agente de soporte en milisegundos.
type: integer
feedback:
additionalProperties: true
description: >-
Presente cuando el agente de soporte está bloqueado o necesita más
información.
nullable: true
type: object
fixParameters:
additionalProperties: true
description: >-
Parámetros de la API legibles por máquina que pueden solucionar el
problema.
nullable: true
type: object
validation:
additionalProperties: true
description: >-
Resultado de la validación cuando el agente de soporte probó o
intentó aplicar una solución.
nullable: true
type: object
type: object
SupportProxyErrorResponse:
properties:
error:
description: Código de error del proxy de soporte o del servicio upstream.
type: string
type: object
securitySchemes:
bearerAuth:
scheme: bearer
type: http
````