Lancer un run et le suivre en Live

Choisir l'effort, estimer le coût, fixer un plafond, puis suivre l'agent en direct et intervenir : pause, consigne, prise de main, correction, arrêt.

Un run est une exécution d'un agent sur une entrée. Pendant qu'il tourne, le Live montre tout ce que fait l'agent : ce qu'il cherche, les outils qu'il appelle, les pages qu'il lit, ce qu'il coûte. Vous pouvez intervenir à tout moment.

Choisir l'effort

Effort	Tours de modèle	Appels d'outils	Durée max	Usage type
`low`	8	15	60 s	Contrôle rapide d'un SIREN
`medium`	30	80	5 min	Fiche KYB complète avec bénéficiaires effectifs
`high`	120	400	20 min	Due diligence approfondie, sources croisées
`build`	150	400	30 min	Livrable produit : tableur, slides, tableau de bord

Estimer et lancer

Avant chaque lancement, l'app affiche le coût attendu et le coût maximal. Par API, POST /v1/runs/estimate renvoie expected_credits, max_credits et sufficient. Le plafond max_cost_eur borne la dépense : à 80 % du plafond, l'agent passe en finalisation et rend une sortie partielle plutôt que rien. Le temps passé en pause ou en attente humaine n'est pas décompté de la durée.

curl -X POST https://api.forge.example/v1/runs \
  -H "Authorization: Bearer $FORGE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kyb-acme-2026-10-12" \
  -d '{
    "agent_id": "8f1c2a4e-…",
    "input": { "company_name": "ACME SAS" },
    "effort": "low",
    "max_cost_eur": 0.5
  }'

Suivre le run en Live

Fil d'activité : pensées résumées, appels d'outils et résultats, fichiers écrits, erreurs. Chaque ligne se déplie pour afficher le détail.
Écran de l'agent : navigateur en direct, fichier en cours d'écriture ou résultat d'outil mis en forme.
Jauges : étape en cours, durée, coût face au plafond, nombre d'appels d'outils.
Par API : WebSocket /v1/runs/:id/live?from_seq=N (les commandes de contrôle passent par la même connexion) ou SSE /v1/runs/:id/live/sse. from_seq reprend le flux là où vous l'aviez quitté.

# Flux SSE (reprise avec l'en-tête Last-Event-ID)
curl -N https://api.forge.example/v1/runs/<run_id>/live/sse \
  -H "Authorization: Bearer $FORGE_API_KEY"

# Le même fil d'activité dans le terminal
forge runs live <run_id>

# Envoyer une consigne en cours de route
forge runs control <run_id> steer "Ignore la filiale belge"

Intervenir

Action	Valeur `action`	Effet
Pause, reprise	`pause`, `resume`	Arrêt propre à la fin de l'action en cours, puis reprise au même point.
Consigne	`steer`	Message injecté au prochain tour, par exemple « ignore la filiale belge ».
Prise de main	`takeover`, `release`	Vous pilotez le navigateur (captcha, connexion), puis vous rendez la main.
Corriger	`correct`	Vous modifiez un résultat intermédiaire ; l'agent repart de la correction.
Approuver, refuser	`approve`, `reject`	Décision sur un outil à effet de bord en mode `confirm`.
Arrêter	`cancel`	Annulation ; seuls les crédits déjà consommés sont débités.

Chaque intervention est tracée avec son auteur, apparaît dans le rapport et sert à améliorer l'agent. Par API : POST /v1/runs/:id/control avec { "action": "steer", "message": "…" }.

Rejouer et partager

Tout run terminé se rejoue comme une vidéo : événements dans l'ordre, curseur, vitesse réglable, vidéo du navigateur synchronisée (GET /v1/runs/:id/replay). Pour partager un rapport hors de votre organisation, créez un lien public (POST /v1/runs/:id/share) valable 1 à 365 jours. Il n'est pas indexé par les moteurs de recherche, sauf si vous activez indexable, et se révoque à tout moment (DELETE /v1/runs/:id/share).