Orquestación
Se convierten ejecuciones puntuales de agentes en flujos de trabajo repetibles y revisables.
Defina un flujo de trabajo como un DAG de nodos de agente y de ejecución, valídelo y luego ejecútelo. Cada ejecución produce un registro que puede observar en vivo y revisar después. Empiece desde una plantilla o constrúyalo en el lienzo. Todo está acotado por inquilino tras la seguridad a nivel de fila.
trigger
manual / cron
agent · plan
claude-code
exec · test
npm test
agent · fix
claude-code
exec · merge
git · gate
Cómo funciona
1
Definir el DAG
Se disponen los nodos de agente (una sesión de Claude Code con un prompt) y los nodos de ejecución (un comando de shell), con las aristas entre ellos.
2
Validar
El servidor comprueba el grafo (sin ciclos, cada dependencia se resuelve) antes de que se ejecute nada.
3
Ejecutarlo
Se inicia el flujo de trabajo manualmente o de forma programada. Cada nodo se ejecuta en orden, respetando sus dependencias.
4
Observar la ejecución
Se sigue el registro de la ejecución en vivo en el lienzo y el visor de ejecución, y se revisa la ejecución completada más tarde.
Análisis a fondo
Nodos de agente + de ejecución
Un nodo de agente es una sesión de Claude Code guiada por un prompt; un nodo de ejecución es un comando de shell. Se combinan en un DAG para encadenar planificación, cambios de código, pruebas y controles en una sola ejecución.
Tiempos de espera de nodo → SIGTERM
Cada nodo puede llevar un tiempo de espera. Al superarse, se le envía SIGTERM, de modo que un agente atascado o un comando descontrolado no puedan mantener la ejecución abierta de forma indefinida.
Plantillas y lienzo visual
Se puede empezar desde una plantilla de inicio integrada y luego editar en el lienzo visual. El visor de ejecución muestra el estado de cada nodo a medida que avanza la ejecución.
Definir y ejecutar un flujo de trabajo
config · workflow.yaml
name: ci-triage
nodes:
- id: plan
type: agent
prompt: "triage the failing build"
timeout: 15m # SIGTERM on breach
- id: test
type: exec
run: npm test
needs: [plan]
$ synaptyx workflow run ci-triage
✓ validated DAG · 2 nodes · no cycles
run_id: wf_3c8a… · watch the run record live in the canvas
Orquestación auditable, no opaca.
Un flujo de trabajo es solo un DAG que puede leer, versionar y revisar. Cada ejecución queda registrada, así que se ve exactamente qué hizo cada nodo: nada de automatización de caja negra.
Comparativa
| Caldyr | Scripts de shell | CI genérico | |
|---|---|---|---|
| Nodos nativos de agente | sí | no | no |
| Validación del DAG antes de ejecutar | ciclos + deps comprobados | no | parcial |
| Registro de ejecución en vivo | lienzo + visor de ejecución | solo registros | solo registros |
| Tiempo de espera de nodo → SIGTERM | por nodo | manual | solo a nivel de tarea |
| Aislamiento por inquilino | acotado por RLS | no | ejecutores compartidos |
Preguntas frecuentes
Hoy hay dos tipos: un nodo de agente ejecuta una sesión de Claude Code a partir de un prompt, y un nodo de ejecución corre un comando de shell. Se conectan en un DAG y se enlaza la salida de cada nodo con el siguiente a través de sus dependencias.
Cada nodo puede declarar un tiempo de espera. Al superarse, se le envía SIGTERM, de modo que un agente atascado o un comando de larga duración se detiene en lugar de mantener abierta toda la ejecución.
No. Hay plantillas de inicio para clonar y un lienzo/editor visual para ajustar el grafo. También puede definir un flujo de trabajo como una definición y ejecutarlo vía la API.
No. Los flujos de trabajo y sus ejecuciones están acotados por inquilino y se aplican con seguridad a nivel de fila en Postgres, así que solo son visibles dentro de la empresa que los posee.
¿Listo para orquestar sus agentes?
Solicite acceso en minutos, o hable con nosotros sobre sus patrones de flujo de trabajo.