Qué es un agente

El agente es el componente que ejecuta las automatizaciones en tu infraestructura. Es el músculo de la plataforma: mientras Nexus decide qué y cuándo ejecutar, el agente es quien realmente abre el navegador, mueve el mouse, lee el Excel y hace el trabajo, en una máquina tuya.

Es la aplicación Zoan Agent (parte del instalador Zoan Platform) ejecutándose en un computador o servidor Windows. Se conecta a Nexus, anuncia que está disponible y espera órdenes.

¿Por qué se ejecuta en mi máquina y no en la nube?

Porque tus bots necesitan acceder a tus aplicaciones: el ERP instalado en tu red, el Excel de tu equipo, sistemas internos que no están expuestos a internet. El agente vive donde viven esas aplicaciones. Nexus, en la nube, solo lo coordina.

Qué hace un agente

• Mantiene la conexión con Nexus y envía heartbeats periódicos (señal de “sigo vivo”).
• Descarga el paquete de automatización cuando recibe una orden de ejecución.
• Ejecuta el proceso localmente con el Runner, paso a paso.
• Envía los logs en tiempo real mientras se ejecuta.
• Reporta el resultado (éxito o error) al finalizar.

Modos de funcionamiento

Modo	Cómo se ejecuta	Cuándo usarlo
Atendido	Dentro de una sesión de usuario de Windows abierta	Asistentes personales; automatizaciones que un usuario lanza en su equipo
Desatendido	Como servicio de Windows en segundo plano, en un servidor/VM sin nadie presente	Procesos automáticos, típicamente programados

La elección se hace al instalar. Ver Instalación en Windows.

Desatendido + automatización de interfaz

Si un proceso desatendido automatiza la interfaz (escritorio o navegador con ventana), necesita un escritorio de Windows donde actuar — y en un servidor sin nadie conectado, ese escritorio no existe por sí solo. Para eso están las sesiones de robot: una cuenta de Windows que el agente usa para abrir la sesión de escritorio del bot. Se elige al lanzar la ejecución.

¿Cuál elijo?

En la práctica, la mayoría de los procesos de negocio van en desatendido: son los que quieres que se ejecuten solos, de noche o por horario, sin ocupar el equipo de nadie. El atendido es para casos donde una persona participa.

Elige atendido si…	Elige desatendido si…
Un usuario lo lanza a mano en su propio equipo cuando lo necesita	Se ejecuta solo, por horario o en cola, sin intervención
El bot asiste a la persona en su trabajo diario (un “copiloto”)	Procesa lotes o tareas repetitivas en segundo plano
Necesita la sesión y los permisos de ese usuario	Debe ejecutarse 24/7 en un servidor o VM dedicada
El volumen es ocasional y puntual	Quieres escalar con varios bots en paralelo

La regla simple

Si la frase “quiero que esto se ejecute solo de madrugada sin que nadie esté” describe tu proceso → desatendido (en un servidor, con una sesión de robot). Si es “quiero darle a un botón en mi PC y que el bot me ayude” → atendido.

Cómo se lanza cada modo

La diferencia clave está en desde dónde se inicia la ejecución:

• Atendido — desde la app del Agent. La aplicación Zoan Agent (la del icono en la bandeja del sistema) muestra la lista de procesos del entorno publicados en Nexus, cada uno con un botón Ejecutar ▶. Al pulsarlo, el proceso se ejecuta en esa misma máquina, dentro de la sesión de Windows del usuario que tiene la app abierta. Es la vía para que una persona lance sus automatizaciones cuando las necesita.

  

• Desatendido — desde Nexus. Las ejecuciones desatendidas se lanzan desde el portal de Nexus —con Nueva ejecución o un trigger— eligiendo el agente y una sesión de robot. Nexus despacha la orden al agente, que abre la sesión de escritorio del bot y la ejecuta sin que haya nadie delante.

Desatendido requiere el servicio de Windows

Para ejecutar procesos desatendidos, el agente debe estar instalado como servicio de Windows (ZoanAgentService). Un agente que solo se ejecuta como app atendida rechazará una ejecución desatendida con el mensaje “Este agente está en modo atendido y no puede ejecutar procesos desatendidos”. Ver Instalación en Windows.

Cómo se conecta a Nexus

1. El agente arranca y se autentica contra Nexus con su Machine Key.
2. Establece una conexión WebSocket persistente y segura (saliente, sobre el puerto 443).
3. Nexus lo marca como online y ya puede asignarle ejecuciones.
4. El agente envía un heartbeat periódico para indicar que sigue activo.
5. Si la conexión se pierde, Nexus lo marca como offline tras un período de gracia.

El agente siempre inicia la conexión hacia Nexus; Nexus nunca abre conexiones hacia el agente. Esto simplifica la red: basta con permitir salida HTTPS/WSS. Ver Arquitectura › Cómo se comunican.

Machine Key

La Machine Key es la clave secreta que identifica a un agente frente a Nexus — su “contraseña”. Se genera automáticamente al crear el agente en el portal y se configura en el Agent una sola vez.

Se muestra una sola vez

La Machine Key solo aparece una vez, al crear o regenerar el agente. Cópiala y guárdala en un lugar seguro antes de cerrar el modal. Si la pierdes, tendrás que regenerarla (lo que invalida la anterior) y reconfigurar el Agent.

Un agente = una máquina

Cada agente representa una máquina física o virtual. No está diseñado para ejecutar varias instancias con la misma Machine Key: cada máquina debe tener su propia clave. Para ejecutar varios procesos en paralelo, necesitas varios agentes (varias máquinas o VM).

Siguientes pasos

• Instalación en Windows — instalar y conectar el Agent paso a paso.
• Configuración — ajustes del agente.
• Monitoreo y estados — vigilar agentes desde el portal.