Obtenir la trace d’exécution d’un agent

Obtenir la trace d’exécution d’une tâche d’agent

curl --request GET \
  --url https://api.firecrawl.dev/v2/agent/{jobId}/trace \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.firecrawl.dev/v2/agent/{jobId}/trace', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v2/agent/{jobId}/trace",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v2/agent/{jobId}/trace"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v2/agent/{jobId}/trace")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "activeBrowserSessions": [
    {
      "id": "<string>",
      "liveViewUrl": "<string>",
      "viewport": {
        "height": 123,
        "width": 123
      }
    }
  ],
  "creditsUsed": 123,
  "events": [
    {
      "agent": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "role": "orchestrator",
        "parentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "eventId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "occurredAt": "2023-11-07T05:31:56Z",
      "producerSequence": 123,
      "runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "schemaVersion": 1,
      "type": "run.started"
    }
  ],
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "success": true
}

{
  "error": "Trace is only available for Spark 2 extracts"
}

{
  "error": "Agent job not found"
}

GET

agent

{jobId}

trace

Obtenir la trace d’exécution d’une tâche d’agent

curl --request GET \
  --url https://api.firecrawl.dev/v2/agent/{jobId}/trace \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.firecrawl.dev/v2/agent/{jobId}/trace', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v2/agent/{jobId}/trace",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v2/agent/{jobId}/trace"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v2/agent/{jobId}/trace")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "activeBrowserSessions": [
    {
      "id": "<string>",
      "liveViewUrl": "<string>",
      "viewport": {
        "height": 123,
        "width": 123
      }
    }
  ],
  "creditsUsed": 123,
  "events": [
    {
      "agent": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "role": "orchestrator",
        "parentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "eventId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "occurredAt": "2023-11-07T05:31:56Z",
      "producerSequence": 123,
      "runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "schemaVersion": 1,
      "type": "run.started"
    }
  ],
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "success": true
}

{
  "error": "Trace is only available for Spark 2 extracts"
}

{
  "error": "Agent job not found"
}

Chaque exécution d’agent enregistre une trace d’exécution canonique : un flux ordonné d’événements décrivant tout ce qu’elle a fait — les outils qu’elle a appelés et leurs résultats, des résumés de raisonnement, des mises à jour de progression, des sessions de navigateur et des modifications de ses artefacts de sortie. Il s’agit du même flux d’événements qui alimente la vue Activité en direct dans l’Agent Playground.

À quoi cela sert

Débogage des exécutions — consultez les recherches, scrapes et extractions exacts effectués par l’agent, les entrées (tool_call.started) et résultats (tool_call.finished) de chaque outil, ainsi que l’étape à laquelle une exécution a échoué (error.occurred, ainsi que l’outcome et l’error structuré de l’événement terminal run.finished).
Interfaces de suivi en direct — interrogez la trace pendant qu’une tâche d’agent est en processing afin d’afficher en temps réel ce que fait l’agent. Les événements progress.reported indiquent la phase de l’exécution (planning, working, finalizing) avec un message lisible par un humain, et les événements reasoning.summary décrivent le raisonnement de l’agent.
Vue Browser en direct — ajoutez ?liveView=true pendant qu’une exécution est en cours pour obtenir activeBrowserSessions : les sessions de navigateur actives de l’exécution, chacune avec une liveViewUrl que vous pouvez intégrer pour observer (ou présenter) la navigation de l’agent.
Suivi des coûts — creditsUsed indique les crédits consommés jusqu’à présent, plafonnés à maxCredits pour l’exécution si cette valeur a été définie.

Fonctionnement

Les événements sont émis par les agents de l’exécution — l’orchestrator et ses subagents — et chacun identifie son émetteur dans le champ agent. Les opérations du Browser s’effectuent dans la session de navigateur propre à l’agent et sont signalées via des événements browser.session.*, et non par des agents de navigateur distincts. Triez les événements selon producerSequence (pour chaque agent émetteur). Le champ type distingue les 13 variantes d’événements ; consultez le schéma de réponse ci-dessous pour obtenir la liste complète et les champs de chaque variante. Les événements artifact.updated ne contiennent pas le contenu de l’artefact lui-même : ils y font référence via snapshotId, que vous récupérez avec le point de terminaison de snapshot. Des événements peuvent continuer à arriver pendant un court instant après la réception de run.finished. Si vous interrogez une exécution en cours, maintenez une courte fenêtre de délai avant d’afficher l’état final.

Les traces sont enregistrées pour les exécutions Spark 2, c’est-à-dire toutes les nouvelles exécutions. Les tâches d’agent démarrées sur des modèles Spark 1 avant leur retrait ne disposent d’aucune trace et renvoient 400.

Êtes-vous un agent IA ayant besoin d’une clé API Firecrawl ? Consultez firecrawl.dev/agent-onboarding/SKILL.md pour les instructions d’intégration automatisée.

Autorisations

Authorization

string

header

requis

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

Paramètres de chemin

jobId

string<uuid>

requis

L’ID de la tâche d’agent

Paramètres de requête

liveView

enum<string>

Si « true », inclure les sessions de navigateur actuellement actives avec les URL de vue en direct.

Options disponibles:

true,

false

Réponse

Réponse réussie

activeBrowserSessions

object[]

Sessions de navigateur actuellement actives (présentes uniquement lorsque liveView=true).

Show child attributes

creditsUsed

number

Crédits consommés jusqu’à présent, plafonnés à maxCredits si cette valeur a été définie.

events

Événements d’exécution canoniques pour l’exécution ; classés selon producerSequence. Les événements artifact.updated contiennent les valeurs snapshotId utilisées par le point de terminaison des instantanés.

Événement d’exécution canonique issu d’une exécution d’agent. Chaque événement contient les champs d’enveloppe schemaVersion, eventId, runId, occurredAt, producerSequence et agent ; le champ type distingue la variante. Les événements usage.recorded sont internes et ne sont jamais exposés, et les événements agent.started omettent le champ model.

Show child attributes

string<uuid>

success

boolean

Utilisation de l’API

Points de terminaison de recherche

Points de terminaison de scraping

Points de terminaison Interact

Points de terminaison de Research Index

Points de terminaison de l’index développeur

Points de terminaison de cartographie

Points de terminaison d’analyse

Points de terminaison crawl

Points de terminaison de surveillance

Points de terminaison Agent

Points de terminaison de retour

Points de terminaison de débogage agentique

Points de terminaison du compte

Charges utiles de webhook

Intégration partenaire

Obtenir la trace d’exécution d’un agent

À quoi cela sert

Fonctionnement

Autorisations

Paramètres de chemin

Paramètres de requête

Réponse

​À quoi cela sert

​Fonctionnement

Autorisations

Paramètres de chemin

Paramètres de requête

Réponse

À quoi cela sert

Fonctionnement