Obtener la traza del agente
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 eloutcomey elerrorestructurado del evento finalrun.finished). - Interfaces de usuario de progreso en tiempo real — consulta periódicamente la traza mientras un trabajo está en
processingpara mostrar lo que hace el agente en tiempo real. Los eventosprogress.reportedincluyen la fase de la ejecución (planning,working,finalizing) con un mensaje legible para las personas, y los eventosreasoning.summarydescriben el razonamiento del agente. - Vista del navegador en tiempo real — pasa
?liveView=truemientras una ejecución está en curso para obteneractiveBrowserSessions: las sesiones activas del navegador de la ejecución, cada una con unaliveViewUrlque puedes integrar para observar (o mostrar en una demostración) cómo navega el agente. - Seguimiento de costos —
creditsUsedinforma de los créditos consumidos hasta el momento, con un límite demaxCreditspara la ejecución si se configuró.
Cómo funciona
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.
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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Parámetros de ruta
El ID del trabajo del agente
Parámetros de consulta
Si es "true", incluye las sesiones de navegador activas actualmente con URL de vista en vivo.
true, false Respuesta
Respuesta correcta
Sesiones de navegador actualmente activas (solo se incluye cuando liveView=true).
Créditos consumidos hasta el momento, con un máximo de maxCredits si se especificó.
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.
- run.started
- run.cancel_requested
- run.finished
- agent.started
- agent.finished
- browser.session.started
- browser.session.finished
- progress.reported
- reasoning.summary
- tool_call.started
- tool_call.finished
- artifact.updated
- error.occurred

