Saltar al contenido principal
Volver al glosario Glosario IA municipal

Orchestrator

Componente de software que coordina el flujo de un agente IA: decide qué herramientas puede usar el modelo, en qué orden, valida resultados y limita iteraciones para evitar bucles.

Definición completa

El orchestrator (orquestador) es la pieza intermedia entre el modelo de IA y las herramientas externas. Sin él, un modelo de lenguaje no podría ejecutar acciones reales de forma controlada.

Responsabilidades típicas:

- Validar las herramientas que el modelo puede invocar en cada turno (control de permisos).
- Limitar el número de iteraciones (evita bucles infinitos).
- Ejecutar tools server-side y devolver resultados al modelo.
- Registrar cada acción en log para auditoría.
- Aplicar redacción PII antes de pasar datos al modelo.
- Aplicar circuit breaker si una tool falla.

En Pueblania, el orchestrator es código propio (no un framework externo) que controla qué puede hacer el agente en cada conversación, según el rol del usuario (vecino vs administrador) y el contexto de su municipio.

Ejemplos prácticos

  • El orchestrator impide que el agente abra una puerta sin confirmación previa del usuario.
  • El orchestrator escala al funcionariado cuando el agente no encuentra respaldo documental, sin que el modelo lo decida solo.
  • El orchestrator limita a 5 iteraciones de herramientas por turno, evitando que un caso ambiguo bloquee el sistema.