Skip to main content
POST
Inicia una tarea de agente para la extracción de datos mediante agentes
¿Eres un agente de IA que necesita una clave de API de Firecrawl? Consulta firecrawl.dev/agent-onboarding/SKILL.md para ver instrucciones de incorporación automatizada.

Autorizaciones

Authorization
string
header
requerido

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

Cuerpo

application/json
prompt
string
requerido

El prompt que describe los datos que se van a extraer

Maximum string length: 10000
auditMetadata
object

Atribución de usuario incluida en los eventos de registro SIEM cuando SIEM Logging está habilitado para la organización.

effort
enum<string>

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.

Opciones disponibles:
low,
medium,
high
exchange
object

Permite que el agente llame a los providers de datos de Alexandria de tu equipo durante la ejecución. Sin este objeto, la ejecución usa solo la web (un turno de seguimiento hereda los ajustes del turno anterior). Consulta Usa tus herramientas conectadas de Alexandria.

maxCredits
number

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.

mode
enum<string>
predeterminado:extract

extract devuelve el resultado estructurado completo en data en cada turno. chat permite responder brevemente en message a una solicitud de seguimiento que no pida datos nuevos, sin volver a ejecutar la tarea. exchange.requireApproval requiere chat en la misma solicitud. Si se omite en un turno de seguimiento, se conserva el modo del hilo.

Opciones disponibles:
extract,
chat
model
enum<string>
predeterminado:spark-2

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.

Opciones disponibles:
spark-2,
spark-1-mini,
spark-1-pro
schema
object

Esquema JSON opcional para estructurar los datos extraídos

strictConstrainToURLs
boolean

Si es true, el agente solo visitará las URL proporcionadas en el array urls

threadId
string<uuid>

Continúa un hilo existente: pasa el threadId devuelto por una ejecución anterior y esta solicitud se ejecutará como el siguiente turno de ese hilo. Si se omiten los ajustes de urls, schema, effort, mode y exchange, se conservarán los del turno anterior. Omite threadId para iniciar un nuevo hilo.

threatProtection
Threat Protection Override · object

Anulación por solicitud de Protección contra amenazas. 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.

urls
string<uri>[]

Lista opcional de URLs a las que se limitará el agente

webhook
object

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).

Respuesta

La tarea del agente se inició correctamente

id
string<uuid>
success
boolean
threadId
string<uuid>

El hilo al que pertenece esta ejecución. Pásalo como threadId para continuar el hilo.

threadTurn
integer

El turno de esta ejecución en el hilo, empezando por 1.