Appuyez sur / pour rechercher

Toute la documentation
docs ▸Apprendre à l’agent ▸Référence des étapes

S’exécute surWrit CloudDesktopAuto-hébergé

Extraction étape

Appel API

L’étape api_call effectue une requête HTTP depuis la page en direct, en portant donc les cookies de la session — souvent plus rapide et plus robuste que de piloter l’interface, surtout contre des endpoints découverts dans le trafic réseau du site lui-même.

Dans un workflow, il s’agit d’un objet d’étape avec "type": "api_call". Les étapes s’exécutent dans l’ordre, et chaque étape peut lire les sorties des étapes précédentes. Consultez la référence des workflows complète pour les 30+ types d’étapes.

Writ s’exécute sur vos propres comptes, avec vos propres identifiants et données, sur des sites que vous êtes autorisé à utiliser.

Champs

ChampTypeDescription
url requis string L’URL de l’endpoint (placeholders pris en charge).
method string GET, POST, PUT, PATCH ou DELETE.
headers map En-têtes de la requête ; référencez des secrets {{vault:name}}, ne les incorporez jamais.
body json Corps de la requête pour les méthodes d’écriture ; les valeurs {{extracted:key}} des étapes précédentes s’y résolvent.

Exemple

Une seule étape api_call telle qu’elle apparaît dans le tableau steps :

{
  "type": "api_call",
  "config": {
    "method": "GET",
    "url": "https://example.com/api/products?page={{page}}",
    "headers": { "Authorization": "Bearer {{vault:api_token}}" }
  }
}

Comportement

  • S’exécute comme une requête dans la page : la session connectée des étapes précédentes est réutilisée.
  • Les valeurs de réponse peuvent être nommées et chaînées vers les étapes suivantes via {{extracted:key}}.
  • N’appelez que des endpoints de services que vous êtes autorisé à utiliser.

Où elle s’exécute

L’étape api_call s’exécute là où l’exécution a lieu. Sur votre agent local ou BYO il n’y a aucun frais de calcul et l’agent peut atteindre des systèmes accessibles uniquement en intranet ; sur le cloud Writ, l’exécution est facturée au temps d’exécution (~0,12 $ par heure de navigateur au-delà de l’allotissement de votre forfait) depuis votre portefeuille prépayé.

Et ensuite

  • Workflows - le vocabulaire complet des étapes et l’objet workflow.
  • Enregistreur - capturez des étapes en cliquant à travers un site.
  • Managed endpoints - transformez le workflow en un endpoint REST, ou en un outil MCP.