Pipelines de Agentes IA: agent-pool en Google AI

Automatización de Agentes de IA: Flujos, Señales y Programadores en agent-pool

El servidor MCP agent-pool simplifica la gestión de equipos fractales de agentes directamente desde tu IDE y la CLI de Gemini. Los trabajadores delegan tareas, formando subgrupos. Antes, la orquestación requería coordinación manual; ahora, flujos, lógica de reenvío, programadores cron y ejecutores SSH están disponibles bajo una sola suscripción a Google AI.

¿Cuál es el mayor desafío? Las herramientas de orquestación desperdician recursos esperando pasos dependientes (análisis → refactorización → pruebas). En cambio, el demonio del flujo ejecuta trabajadores en segundo plano, propagando automáticamente las dependencias.

Flujos para Cadenas de Tareas

La herramienta create_pipeline define los pasos de antemano. El demonio desconectado inicia trabajadores al activarse:

• on_complete — se ejecuta tras un paso específico.
• on_complete_all — espera a que un grupo de trabajadores finalice (fan-in).
• on_file — responde a la creación de un archivo.

Flujo de ejemplo:

          ┌─ frontend ─┐
research ─┤            ├── deploy
          └─ backend  ─┘

El demonio sobrevive al reinicio del IDE, asegurando continuidad.

Señales y Reenvío para Comunicación

Los agentes indican la finalización mediante signal_step_complete. Si los datos son incompletos, bounce_back devuelve la tarea para revisión con una razón de error—similar a la función "Solicitar cambios" de GitHub.

El límite maxBounces evita bucles infinitos. Los trabajadores reciben retroalimentación (por ejemplo, "faltan registros"), corrigen los problemas y vuelven a señalar.

Programador de Tareas Cron

schedule_task vincula un agente a una expresión cron, como 0 9 *. El programador utiliza bloqueos atómicos de archivos para garantizar una única ejecución, incluso entre múltiples sesiones del IDE.

Los resultados se guardan en .agents/scheduled-results/. Ideal para monitoreo de servidores o informes automatizados.

Ejecutores Remotos por SSH

Configura SSH en agent-pool.config.json:

{
  "runners": {
    "remote": {
      "type": "ssh",
      "host": "dev-server.company.com",
      "user": "agent",
      "geminiPath": "/home/agent/.nvm/versions/node/v22.0.0/bin/gemini"
    }
  }
}

Delega tareas:

delegate_task(
  prompt: "Ejecutar pruebas en un entorno aislado",
  runner: "remote"
)

Las tareas continúan incluso después de cerrar la sesión local. Los agentes trabajan en ramas, aplican cambios y envían solicitudes de fusión.

Sesiones para Transferencia de Contexto

La CLI de Gemini almacena el historial en sesiones. Al pasar session_id, puedes continuar:

# Análisis
delegate_task(prompt: "Analizar src/auth/") -> task_1

# Resultado
get_task_result(task_1) -> { session_id: "abc-123" }

# Continuar
delegate_task(
  prompt: "Usando los resultados del análisis, escribir pruebas",
  session_id: "abc-123"
)

list_sessions muestra las sesiones activas.

Políticas de Acceso y Directorios

policy limita el acceso a herramientas:

• read-only — solo lectura de archivos.
• safe-edit — edición sin ejecutar comandos de shell.

Ejemplo:

delegate_task_readonly(
  prompt: "Verificar src/auth/ en busca de vulnerabilidades",
  policy: "read-only"
)

include_dirs amplía la visibilidad más allá del directorio de trabajo.

Grupos de Agentes e Integración con Flujos

create_group agrupa configuraciones:

create_group({
  name: "backend",
  runner: "remote",
  skill: "node-dev",
  policy: "safe-edit",
  max_agents: 3
})

delegate_to_group("backend", "Refactorizar módulo de autenticación", count: 2)

Los grupos se almacenan en .agents/groups.json. En flujos:

create_pipeline({
  name: "Construir y Probar",
  steps: [{
    name: "run_tests",
    group: "backend",
    count: 3,
    prompt: "Ejecutar tu suite de pruebas"
  }]
})

El demonio inicia count agentes con AGENT_INDEX, espera a todos y falla rápidamente: si uno falla, los demás se cancelan.

Conclusiones Clave

• Los flujos automatizan las dependencias, liberando al orquestador.
• El reenvío con límites evita bucles.
• Los ejecutores SSH y cron permiten ejecución distribuida.
• Las políticas y grupos reducen la duplicación de configuración.
• Las sesiones preservan todo el contexto entre agentes.

— Editorial Team