Qué es un agente

El agente es el componente que ejecuta las automatizaciones en tu infraestructura. Es el músculo de la plataforma: mientras Zoan Cloud 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 Zoan Cloud, anuncia que está disponible y espera órdenes.

En el portal, cada equipo con el Agent aparece como una máquina, en Centro › Máquinas (donde también están las Sesiones de robot). Desde ahí creas una con Nueva máquina, y en su menú ⋮ puedes Cambiar nombre, Regenerar clave, Desconectar ya, Suspender o Eliminar. Para que los procesos de una carpeta corran en una máquina, asígnala en la pestaña Acceso › Máquinas de esa carpeta.

Procesos sin pantalla en Zoan Cloud

Los procesos Sin pantalla (que no necesitan un escritorio) también pueden correr en Zoan Cloud, sin instalar nada: aparece como una máquina más al lanzar la ejecución.

¿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. Zoan Cloud, en la nube, solo lo coordina.

Qué hace un agente

• Mantiene la conexión con Zoan Cloud 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 ambiente publicados en Zoan Cloud, 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.

  La persona inicia sesión en el Agent con su cuenta de Zoan Cloud: el Agent abre el navegador en la página Autorizar Zoan Agent, ella confirma y vuelve a la app. Si ya inició sesión en Zoan Designer, el Agent usa esa misma sesión y no se la vuelve a pedir (desde la versión 1.2.30; ver La cuenta de la persona). Cada ejecución atendida queda a su nombre (en la lista de ejecuciones, con tipo Atendida) y requiere su licencia de Robot atendido; sin ella, el botón Ejecutar queda deshabilitado. Ver Licencias.

  

• Desatendido — desde Zoan Cloud. Las ejecuciones desatendidas se lanzan desde el portal de Zoan Cloud —con Iniciar ejecución o un disparador— eligiendo la máquina y una sesión de robot. Zoan Cloud 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 Zoan Cloud

1. El agente arranca y se autentica contra Zoan Cloud con su Machine Key.
2. Establece una conexión WebSocket persistente y segura (saliente, sobre el puerto 443).
3. Zoan Cloud 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, Zoan Cloud lo marca como offline tras un período de gracia.

El agente siempre inicia la conexión hacia Zoan Cloud; Zoan Cloud 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 Zoan Cloud — 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.