Hybrid Architecture (Workflow + Agente)

Un patrón de producción: el Workflow posee side effects; un agente acotado maneja la incertidumbre dentro de guardrails.
En esta página
  1. La idea
  2. Por qué funciona en producción
  3. Diagrama (Workflow posee side effects)
  4. Checklist de guardrails (mínimo)
  5. Cuándo no usar híbrido
  6. Related

La idea

Un sistema híbrido separa responsabilidades:

  • El agente decide qué opción segura tomar después.
  • El Workflow ejecuta side effects (escrituras, notificaciones, acciones irreversibles).

Esto deja autonomía donde ayuda (incertidumbre) y determinismo donde importa (cambios de estado).

Por qué funciona en producción

Híbrido es el patrón por defecto cuando:

  • no puedes enumerar todos los caminos upfront,
  • pero necesitas costo, latencia y writes predecibles.

También facilita el debugging: puedes trazar “lo que eligió el agente” separado de “lo que ejecutó el Workflow”.

Diagrama (Workflow posee side effects)

Checklist de guardrails (mínimo)

  • Budgets: max steps + wall-clock + $ por ejecución
  • Tool policy: allowlist, default-deny, scoped credentials
  • Stop reasons: siempre devolver por qué se detuvo la ejecución
  • Approvals para writes: human-in-the-loop para acciones irreversibles
  • Traces: log de cada decisión, tool call y transición de estado

Cuándo no usar híbrido

  • Si los pasos son determinísticos → construye un Workflow.
  • Si necesitas exploración abierta → empieza con un agente read-only y luego agrega writes herramienta por herramienta.

No sabes si este es tu caso?

Disena tu agente ->
⏱️ 2 min de lecturaActualizado Mar, 2026Dificultad: ★★★
Integrado: control en producciónOnceOnly
Guardrails para agentes con tool-calling
Lleva este patrón a producción con gobernanza:
  • Presupuestos (pasos / topes de gasto)
  • Permisos de herramientas (allowlist / blocklist)
  • Kill switch y parada por incidente
  • Idempotencia y dedupe
  • Audit logs y trazabilidad
Mención integrada: OnceOnly es una capa de control para sistemas de agentes en producción.
Autor

Esta documentación está curada y mantenida por ingenieros que despliegan agentes de IA en producción.

El contenido es asistido por IA, con responsabilidad editorial humana sobre la exactitud, la claridad y la relevancia en producción.

Los patrones y las recomendaciones se basan en post-mortems, modos de fallo e incidentes operativos en sistemas desplegados, incluido durante el desarrollo y la operación de infraestructura de gobernanza para agentes en OnceOnly.