Skip to main content
GET
Obter o status de um job de agente
Você é um agente de IA que precisa de uma chave de API do Firecrawl? Consulte firecrawl.dev/agent-onboarding/SKILL.md para ver instruções automatizadas de onboarding.

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

jobId
string<uuid>
obrigatório

O ID da tarefa do agente

Resposta

Resposta bem-sucedida

creditsUsed
number
data
object

Os dados extraídos (apenas presentes quando o status é "completed"). Nunca definidos em uma execução que falhou, inclusive quando ela foi interrompida ao atingir o limite de créditos.

effort
enum<string>

Orçamento de raciocínio usado na execução do agente (presente apenas em execuções que definem esforço)

Opções disponíveis:
low,
medium,
high
error
string

Mensagem de erro (apenas quando o status for "failed")

expiresAt
string<date-time>
message
string

Uma observação do agente sobre o resultado. Se a execução falhou ao ser interrompida por atingir o limite de créditos, pode explicar o que ficou incompleto.

model
enum<string>
padrão:spark-2

Predefinição de modelo usada na execução do agente. Todas as novas execuções são realizadas no spark-2; os nomes do Spark 1 aparecem apenas em execuções legadas.

Opções disponíveis:
spark-2,
spark-1-pro,
spark-1-mini
partial
any

JSON recuperado, na medida do possível, de uma execução incompleta. Presente apenas em algumas execuções que falharam, como uma que atingiu maxCredits; nunca presente enquanto a execução está em processamento. Pode conter linhas ou campos faltantes, portanto não o trate como um resultado completo.

partialSchemaValid
boolean

Indica se partial é válido segundo o schema JSON da solicitação. Presente apenas quando há um partial e a solicitação incluiu um schema.

status
enum<string>
Opções disponíveis:
processing,
completed,
failed
stopReason
enum<string>

Motivo pelo qual uma execução que falhou foi interrompida antes do término. credit_limit_reached significa que a execução atingiu o limite definido em maxCredits. Presente apenas quando o status é failed.

Opções disponíveis:
credit_limit_reached
success
boolean