Skip to main content
GET
Obtener el estado de una tarea de agente
¿Eres un agente de IA que necesita una API key de Firecrawl? Consulta firecrawl.dev/agent-onboarding/SKILL.md para obtener instrucciones de incorporación automática.

Autorizaciones

Authorization
string
header
requerido

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

Parámetros de ruta

jobId
string<uuid>
requerido

El ID de la tarea del agente

Respuesta

Respuesta correcta

creditsUsed
number
data
object

Los datos extraídos (solo disponibles cuando el estado es "completed"). Nunca se incluyen en una ejecución fallida, ni siquiera si se detuvo al alcanzar su límite de créditos.

effort
enum<string>

Presupuesto de razonamiento utilizado para la ejecución del agente (solo presente en ejecuciones que especifican effort)

Opciones disponibles:
low,
medium,
high
error
string

Mensaje de error (solo presente cuando el estado es failed)

exchange
object

Lo que hizo la ejecución con Alexandria. toolkits y requireApproval son los valores efectivos de la ejecución tras aplicar la herencia del hilo.

expiresAt
string<date-time>
message
string

Una nota del agente sobre el resultado. En el modo chat, las solicitudes de seguimiento que no piden datos nuevos se responden aquí en lugar de en data. Si la ejecución falló al alcanzar el límite de créditos, puede explicar qué partes están incompletas.

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

Configuración predefinida del modelo utilizada en la ejecución del agente. Cada nueva ejecución se realiza en spark-2; los nombres de Spark 1 solo aparecen en ejecuciones heredadas.

Opciones disponibles:
spark-2,
spark-1-pro,
spark-1-mini
partial
any

JSON recuperado en la medida de lo posible de una ejecución incompleta. Solo está presente en algunas ejecuciones fallidas, como las que alcanzaron maxCredits; nunca mientras la ejecución está en curso. Pueden faltar filas o campos, por lo que no debe tratarse como un resultado completo.

partialSchemaValid
boolean

Indica si partial cumple con el esquema JSON de la solicitud. Solo está presente si se incluye partial y la solicitud incluía un schema.

pendingApproval
object

La pregunta que interrumpió el turno. Respóndela en el siguiente turno del hilo con exchange.approve o exchange.decline.

status
enum<string>
Opciones disponibles:
processing,
completed,
failed
stopReason
enum<string>

Motivo por el que una ejecución fallida se detuvo antes de tiempo. credit_limit_reached significa que la ejecución alcanzó el límite establecido en maxCredits. Solo está presente cuando el estado es failed.

Opciones disponibles:
credit_limit_reached
success
boolean
suggestions
object[]

Solicitudes de seguimiento que el agente propone para el siguiente turno del hilo.

threadId
string<uuid>

El hilo al que pertenece esta ejecución.

threadTurn
integer

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