> ## Documentation Index > Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-4orfll.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Agente > ¿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 instrucciones de incorporación automatizada. ## OpenAPI ````yaml es/api-reference/v2-openapi.json POST /agent 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: /agent: post: tags: - Agent summary: Inicia una tarea de agente para la extracción de datos mediante agentes operationId: startAgent requestBody: content: application/json: schema: properties: auditMetadata: $ref: '#/components/schemas/AuditMetadata' effort: description: >- Presupuesto de razonamiento para la tarea del agente. Cada ejecución se realiza en spark-2, por lo que se puede enviar effort con o sin especificar el modelo. enum: - low - medium - high type: string maxCredits: description: >- Créditos máximos que se pueden gastar en esta tarea del agente. El valor predeterminado es 2500 si no se especifica. Los valores superiores a 2.500 siempre se facturan como solicitudes de pago. type: number model: default: spark-2 description: >- El modelo que utilizará el agente para la tarea. spark-2 es el predeterminado y el modelo que utiliza cada ejecución. Los nombres de modelos Spark 1 siguen aceptándose por compatibilidad con versiones anteriores, pero están obsoletos y se redirigen a spark-2. enum: - spark-2 - spark-1-mini - spark-1-pro type: string prompt: description: El prompt que describe los datos que se van a extraer maxLength: 10000 type: string schema: description: Esquema JSON opcional para estructurar los datos extraídos type: object strictConstrainToURLs: description: >- Si es true, el agente solo visitará las URL proporcionadas en el array urls type: boolean threatProtection: $ref: '#/components/schemas/ThreatProtectionOverride' urls: description: Lista opcional de URLs a las que se limitará el agente items: format: uri type: string type: array webhook: description: >- Un objeto de especificación de webhook. Se suscribe a eventos del ciclo de vida del agente (agent.started, agent.action, agent.completed, agent.failed, agent.cancelled). properties: events: default: - started - action - completed - failed - cancelled description: >- Los eventos que se enviarán a la URL del webhook. De forma predeterminada, se envían todos los eventos. items: enum: - started - action - completed - failed - cancelled type: string type: array headers: additionalProperties: type: string description: Cabeceras que se enviarán a la URL del webhook. type: object metadata: additionalProperties: type: string description: >- Metadatos personalizados que se incluirán en todas las cargas útiles de webhook para este trabajo del agente. type: object url: description: La URL a la que se enviarán los eventos de webhook. format: uri type: string required: - url type: object required: - prompt type: object required: true responses: '200': content: application/json: schema: properties: id: format: uuid type: string success: type: boolean type: object description: La tarea del agente se inició correctamente '400': content: application/json: schema: properties: error: example: 'Invalid JSON schema: ...' type: string type: object description: >- Solicitud incorrecta — el cuerpo de la solicitud no superó la validación (por ejemplo, un esquema JSON no válido). '402': content: application/json: schema: properties: error: example: Payment required to access this resource. type: string type: object description: Se requiere pago '403': content: application/json: schema: properties: error: example: >- This URL (https://example.com) is blocked by your organization's threat protection policy (rule: blocklist). If you believe this is a mistake, contact your organization administrator to adjust the policy (e.g. whitelist the domain). type: string type: object description: >- Prohibido — una URL proporcionada está bloqueada por la política de Protección contra amenazas del equipo. '429': content: application/json: schema: properties: error: example: Rate limit exceeded. type: string type: object description: Demasiadas solicitudes '500': content: application/json: schema: properties: error: example: Failed to passthrough agent request. type: string type: object description: >- Error interno del servidor — no se pudo acceder al servicio del agente. security: - bearerAuth: [] components: schemas: AuditMetadata: additionalProperties: false description: >- Atribución de usuario incluida en los eventos de registro SIEM cuando SIEM Logging está habilitado para la organización. properties: username: description: El nombre de usuario asociado a la solicitud. maxLength: 1024 type: string required: - username type: object ThreatProtectionOverride: description: >- Anulación por solicitud de [Protección contra amenazas](https://docs.firecrawl.dev/features/threat-protection). Los campos que proporciones reemplazan los campos correspondientes de la política de tu organización solo para esta solicitud; los campos omitidos conservan sus valores a nivel de organización. Requiere que Protección contra amenazas esté habilitada para tu equipo (función enterprise); de lo contrario, la solicitud se rechaza con un 403. Si tu organización ha deshabilitado las anulaciones por solicitud, cualquier solicitud que incluya este objeto se rechaza con un 403. Si Protección contra amenazas se aplica de forma obligatoria a tu equipo, `mode` no puede establecerse en `off`. properties: blacklist: description: >- Dominios que siempre se deben bloquear, como dominios simples (`example.com`) o patrones con comodines (`*.example.com`). Sin protocolo, ruta ni puerto. items: type: string maxItems: 1000 type: array blockedTlds: description: >- Dominios de nivel superior que se bloquean directamente, en minúsculas y sin el punto inicial (p. ej., `zip`). items: type: string maxItems: 1000 type: array failurePolicy: description: >- Qué hacer cuando no se puede acceder al clasificador: `closed` bloquea la solicitud; `open` la permite. enum: - open - closed type: string mode: description: >- Modo de análisis de URL para esta solicitud. `normal` verifica las URL con Google Web Risk (+2 créditos por URL analizada). enum: - 'off' - normal type: string riskScoreThreshold: description: >- Puntuación de riesgo normalizada (0–100) a partir de la cual el veredicto de un clasificador bloquea la URL. Cuanto más bajo, más estricto. example: 75 maximum: 100 minimum: 0 type: integer whitelist: description: >- Dominios que siempre se deben permitir, como dominios simples o patrones con comodines. Tiene prioridad sobre cualquier otra regla. items: type: string maxItems: 1000 type: array title: Threat Protection Override type: object securitySchemes: bearerAuth: scheme: bearer type: http ````