Skip to main content
GET
Obtiene el rastreo de ejecución de un trabajo del agente
Cada ejecución de un agente registra una traza de ejecución canónica: una secuencia ordenada de eventos que describe todo lo que hizo la ejecución —las herramientas que llamó y lo que devolvieron, resúmenes de razonamiento, actualizaciones de progreso, sesiones de navegador y cambios en sus artefactos de salida—. Es la misma secuencia de eventos que impulsa la vista de actividad en tiempo real en Agent Playground.

Para qué sirve

  • Depuración de ejecuciones — consulta las búsquedas, los scrapeos y las extracciones exactos que realizó el agente, la entrada (tool_call.started) y el resultado (tool_call.finished) de cada herramienta, y dónde falló una ejecución (error.occurred, así como el outcome y el error estructurado del evento final run.finished).
  • Interfaces de usuario de progreso en tiempo real — consulta periódicamente la traza mientras un trabajo está en processing para mostrar lo que hace el agente en tiempo real. Los eventos progress.reported incluyen la fase de la ejecución (planning, working, finalizing) con un mensaje legible para las personas, y los eventos reasoning.summary describen el razonamiento del agente.
  • Vista del navegador en tiempo real — pasa ?liveView=true mientras una ejecución está en curso para obtener activeBrowserSessions: las sesiones activas del navegador de la ejecución, cada una con una liveViewUrl que puedes integrar para observar (o mostrar en una demostración) cómo navega el agente.
  • Seguimiento de costoscreditsUsed informa de los créditos consumidos hasta el momento, con un límite de maxCredits para la ejecución si se configuró.

Cómo funciona

Los eventos los emiten los agentes de la ejecución —el orchestrator y sus subagents—, y cada evento identifica a su emisor en el campo agent. El trabajo del navegador se realiza dentro de la propia sesión de navegador del agente y se notifica mediante eventos browser.session.*, no a través de agentes de navegador independientes. Ordena los eventos por producerSequence (para cada agente emisor). El campo type distingue las 13 variantes de eventos; consulta el esquema de respuesta a continuación para ver la lista completa y los campos de cada variante. Los eventos artifact.updated no incluyen el contenido del artefacto; hacen referencia a él mediante snapshotId, que puedes recuperar con el endpoint de instantáneas. Los eventos pueden seguir llegando durante un breve periodo tras recibir run.finished, así que, si consultas periódicamente una ejecución activa, mantén abierta una breve ventana de espera antes de mostrar el estado final.
Las trazas se registran en las ejecuciones de Spark 2, es decir, en todas las ejecuciones nuevas. Los trabajos iniciados en modelos Spark 1 antes de su retirada no tienen trazas y devuelven 400.
¿Eres un agente de IA que necesita una clave de API de Firecrawl? Consulta firecrawl.dev/agent-onboarding/SKILL.md para obtener instrucciones de incorporación automatizada.

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 del trabajo del agente

Parámetros de consulta

liveView
enum<string>

Si es "true", incluye las sesiones de navegador activas actualmente con URL de vista en vivo.

Opciones disponibles:
true,
false

Respuesta

Respuesta correcta

activeBrowserSessions
object[]

Sesiones de navegador actualmente activas (solo se incluye cuando liveView=true).

creditsUsed
number

Créditos consumidos hasta el momento, con un máximo de maxCredits si se especificó.

events
(run.started · object | run.cancel_requested · object | run.finished · object | agent.started · object | agent.finished · object | browser.session.started · object | browser.session.finished · object | progress.reported · object | reasoning.summary · object | tool_call.started · object | tool_call.finished · object | artifact.updated · object | error.occurred · object)[]

Eventos canónicos de ejecución, ordenados por producerSequence. Los eventos artifact.updated contienen los valores snapshotId utilizados por el endpoint de instantáneas.

Un evento de ejecución canónico de una ejecución del agente. Cada evento incluye los campos de envoltura schemaVersion, eventId, runId, occurredAt, producerSequence y agent; el campo type distingue la variante. Los eventos usage.recorded son internos y nunca se exponen, y los eventos agent.started omiten el campo model.

id
string<uuid>
success
boolean