Para desarrolladores
Use el workflow de IA como si fuera una API
Activar, consultar resultados, resolver aprobaciones y obtener artefactos, todo por REST, sin tener que mantener usted mismo las llamadas al modelo, los reintentos y las colas.
# Activar una ejecución POST /api/webhooks/{id}/trigger → {"executionId": "exec_51a2"} # Sondear el estado: esta vez se detuvo en la aprobación manual GET /api/v1/executions/exec_51a2 → {"status": "AWAITING_APPROVAL"} # Tras la aprobación continúa (los valores se pueden modificar antes de aprobar) POST /api/v1/approvals/{approvalId}/approve # Al terminar, obtener el resultado y los artefactos GET /api/v1/executions/exec_51a2/result GET /api/v1/executions/exec_51a2/artifacts
Ruta de integración
15 minutos, desde crear el Webhook hasta obtener el primer resultado
Cuatro solicitudes HTTP recorren todo el proceso, sin necesidad de SDK; cualquier lenguaje capaz de enviar solicitudes puede integrarse.
01Cree el Webhook y obtenga la URL y la KeyEn la consola, agregue un disparador de Webhook al workflow para obtener una URL exclusiva; luego cree una API Key con el ámbito WEBHOOK_TRIGGER.
02Un POST activa la ejecuciónLos campos de nivel superior del JSON se asignan automáticamente a variables del workflow con el mismo nombre, y también se pueden asignar explícitamente con variableMapping; el payload tiene un límite de 1MB.
03Sondee el estado de la ejecución y obtenga el resultadoUse el executionId devuelto para consultar los detalles de la ejecución; una vez terminada, obtenga la salida desde el endpoint result y descargue los archivos desde el endpoint artifacts.
04Las acciones que requieren revisión humana pasan por la API de aprobacionesLa ejecución se detiene en el paso manual_approval; use el endpoint de aprobaciones para listar los elementos pendientes y aprobarlos o rechazarlos; si se rechaza o expira el tiempo, no se modifica nada.
# Paso 2: envíe un POST desde su sistema curl -X POST https://your-host/api/webhooks/{id}/trigger \ -H "X-API-Key: <your-api-key>" \ -d '{"ticket_id": "T-1024", "lang": "zh"}' # Los campos de nivel superior se asignan automáticamente a variables del workflow con el mismo nombre → {"executionId": "exec_51a2"} # Paso 3: sondee el estado y, al terminar, obtenga el resultado curl https://your-host/api/v1/executions/exec_51a2/result \ -H "X-API-Key: <your-api-key>"
Lista de capacidades
Seis cosas que le importan a quien escribe código
Pasos de código en sandbox para 7 lenguajesSe puede escribir en Python, JavaScript, TypeScript, Bash, Ruby, Lua y CLI; las variables se inyectan como variables de entorno WF_VAR_*, con un tiempo de espera de 30 segundos por defecto, y en producción se ejecutan en un sandbox de Docker con salida a red controlada.
Definición en YAML, siguiendo su flujo de GitUn workflow es un archivo YAML: commit, diff y reversión, todo en el repositorio que ya conoce; el lienzo y el YAML se sincronizan de forma bidireccional, así que puede editar cualquiera de los dos.
MCP para integrar sus propias herramientasEnvuelva sus servicios internos como un MCP Server y adjúntelo al Agent, y los pasos de IA podrán llamar directamente a su sistema sin esperar a que la plataforma publique un conector.
Depurador con puntos de interrupción9 tipos de puntos de interrupción: al alcanzarse, se pausa, se modifican las variables y se continúa; tras un fallo se reejecuta desde el paso indicado, y los pasos de LLM ya completados no se vuelven a facturar.
v1 API de 14 endpoints, con permisos mínimosActivar ejecuciones, consultar resultados, resolver aprobaciones y descargar artefactos tienen cada uno su propio ámbito de permisos; combine los 6 ámbitos según sea necesario y emita una Key propia para cada sistema integrado.
Activación encadenada DELAYED_COMPLETIONTras completarse A, se activa automáticamente B pasados N segundos, con la posibilidad de fijar un límite maxRuns; los procesos largos se dividen en tramos, y cada tramo tiene sus propios registros y costos.
Límites con honestidad
Tres cosas, dichas de antemano
Para no descubrirlas a mitad de la integración.
No hay cientos de conectores SaaSLas llamadas a sistemas externos se escriben en pasos de código, o se envuelven como herramientas MCP y se adjuntan al Agent; para un equipo que escribe código, este paso son unas pocas líneas de solicitud HTTP.
No hay una API de estimación de costos previa a la ejecuciónEl consumo de tokens y el costo de cada ejecución se registran una por una y el cálculo posterior es detallado; pero antes de ejecutar no se obtiene una cotización, y el control del presupuesto se apoya en el control de aprobaciones y en maxRuns.
Los límites se declaran de antemanoEl payload del Webhook tiene un límite de 1MB; los pasos de código tienen un tiempo de espera de 30 segundos por defecto; la firma HMAC-SHA256 se mantiene solo como modo de compatibilidad, y las nuevas integraciones usan API Key.
Punto de acceso a la documentación
Tres artículos que vale la pena leer antes de integrar
Referencia de la API v1Campos de solicitud y respuesta de los 14 endpoints, códigos de error y cómo configurar los 6 ámbitos de permisos.Abrir la documentación →Disparador WebhookObtención de la URL y la Key, reglas de asignación de variables, modo de compatibilidad HMAC y límite de 1MB.Abrir la documentación →Sintaxis YAMLLos 8 tipos de paso y cómo escribir modificadores como condition, retry y manual_approval.Abrir la documentación →
Integre su primer workflow en su sistema
El plan Free ya le permite montar workflows y ejecutarlos manualmente; cuando necesite activación por Webhook y programación temporal, actualice a Pro.