Pulsa / para buscar

Toda la documentación
docs ▸Enseñar al agente ▸Referencia de pasos

Se ejecuta enWrit CloudDesktopAutoalojado

Extracción paso

Llamada API

El paso api_call realiza una petición HTTP desde la página en vivo, por lo que lleva las cookies de la sesión — a menudo más rápido y robusto que manejar la interfaz, sobre todo contra endpoints descubiertos en el propio tráfico de red del sitio.

En un workflow, esto es un objeto de paso con "type": "api_call". Los pasos se ejecutan en orden, y cada paso puede leer las salidas de los pasos anteriores. Consulta la referencia de workflows completa para conocer los 30+ tipos de paso.

Writ se ejecuta en tus propias cuentas, con tus propias credenciales y datos, en sitios que estás autorizado a usar.

Campos

CampoTipoDescripción
url requerido string La URL del endpoint (admite placeholders).
method string GET, POST, PUT, PATCH o DELETE.
headers map Encabezados de la petición; referencia secretos {{vault:name}}, nunca los incrustes.
body json Cuerpo de la petición para métodos de escritura; los valores {{extracted:key}} de pasos anteriores se resuelven aquí.

Ejemplo

Un único paso api_call tal como aparece en el array steps :

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

Cómo se comporta

  • Se ejecuta como petición dentro de la página: la sesión iniciada por pasos anteriores se reutiliza.
  • Los valores de la respuesta pueden nombrarse y encadenarse a pasos posteriores como {{extracted:key}}.
  • Llama solo a endpoints de servicios que estés autorizado a usar.

Dónde se ejecuta

El paso api_call se ejecuta allí donde se ejecuta la run. En tu agent local o BYO no hay cargo de cómputo y el agent puede alcanzar sistemas accesibles solo por intranet; en el cloud de Writ la ejecución se mide por tiempo de ejecución (~$0,12 por hora de navegador) con cargo al uso incluido de tu plan, desde tu wallet prepago.

Qué sigue

  • Workflows - el vocabulario completo de pasos y el objeto workflow.
  • Grabador - captura pasos haciendo clic por un sitio.
  • Managed endpoints - convierte el workflow en un endpoint REST, o en una herramienta MCP.