Obter rastro do agente
Para que serve
- Depuração de execuções — veja as buscas, os scrapes e as extrações exatos realizados pelo agente, a entrada (
tool_call.started) e o resultado (tool_call.finished) de cada ferramenta, além de identificar onde uma execução falhou (error.occurred, bem como ooutcomee oerrorestruturado do evento terminalrun.finished). - UIs de progresso em tempo real — consulte o rastro enquanto um job estiver em
processingpara mostrar o que o agente está fazendo em tempo real. Os eventosprogress.reportedinformam a fase da execução (planning,working,finalizing) com uma mensagem compreensível para humanos, e os eventosreasoning.summarydescrevem o raciocínio do agente. - Visualização do navegador em tempo real — passe
?liveView=trueenquanto uma execução estiver em andamento para obteractiveBrowserSessions: as sessões ativas do navegador da execução, cada uma com umaliveViewUrlque pode ser incorporada para acompanhar (ou demonstrar) o agente navegando. - Acompanhamento de custos —
creditsUsedinforma os créditos consumidos até o momento, limitados aomaxCreditsda execução, se definido.
Como funciona
orchestrator e seus subagents — e cada evento identifica seu emissor no campo agent. As tarefas no navegador ocorrem dentro da própria sessão de navegador de um agente e são reportadas por eventos browser.session.*, não por agentes de navegador separados. Ordene os eventos por producerSequence (por agente emissor). O campo type distingue as 13 variantes de evento; consulte o esquema de resposta abaixo para ver a lista completa e os campos de cada variante.
Os eventos artifact.updated não incluem o conteúdo do artefato — eles fazem referência a ele por snapshotId, que você busca com o endpoint de snapshot.
Os eventos podem continuar chegando por um momento após a chegada de run.finished; portanto, se você estiver consultando uma execução em andamento, mantenha uma breve janela de espera antes de renderizar o estado final.
400.Você é um agente de IA que precisa de uma chave de API do Firecrawl? Consulte firecrawl.dev/agent-onboarding/SKILL.md para ver as instruções de integração automatizada.
Autorizações
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Parâmetros de caminho
O ID do job do agente
Parâmetros de consulta
Se "true", inclua as sessões do navegador atualmente ativas com URLs de visualização em tempo real.
true, false Resposta
Resposta bem-sucedida
Sessões de navegador ativas no momento (presentes apenas quando liveView=true).
Créditos consumidos até o momento, limitados a maxCredits, se definido.
Eventos canônicos de execução da execução; ordenados por producerSequence. Os eventos artifact.updated contêm os valores de snapshotId usados pelo endpoint de snapshots.
Um evento de execução canônico de uma execução de agente. Todos os eventos contêm os campos de envelope schemaVersion, eventId, runId, occurredAt, producerSequence e agent; o campo type diferencia a variante. Os eventos usage.recorded são internos e nunca são expostos, e os eventos agent.started omitem o 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

