Conceptos clave

Esta página explica el vocabulario de la plataforma. No hace falta memorizarlo: vuelve aquí cuando un término no te quede claro. Al final verás cómo encajan todos.

Cómo se relacionan

flowchart TD
  T["Tenant<br/>tu organización"] --> E["Entorno<br/>ej. Producción"]
  E --> A["Agentes<br/>las máquinas que ejecutan"]
  E --> S["Sesiones de robot<br/>cuentas de Windows (desatendido)"]
  E --> P["Procesos<br/>paquete + versión, listo para ejecutarse"]
  P --> X["Ejecuciones<br/>cada ejecución concreta"]
  E --> Tr["Triggers<br/>cuándo se lanza un proceso"]
  E --> C["Credenciales<br/>secretos para acceder a sistemas"]
  PK["Paquete<br/>diseñado en el Designer"] -->|se asigna a| P

Tenant

Un tenant es tu organización dentro de Zoan Nexus: un espacio completamente aislado del de cualquier otro cliente. Tiene su propio subdominio (tu-empresa.nexus.zoansoftware.com), sus usuarios, sus datos y su configuración. Nada se comparte entre tenants. Ver Arquitectura › Multi-tenancy.

Entorno

Un entorno (environment) agrupa los recursos de un contexto de trabajo: agentes, procesos, credenciales y triggers. Lo habitual es separar Producción, Pruebas y Desarrollo, para que un experimento no afecte lo que ya está en marcha. Un recurso siempre vive dentro de un entorno. Ver Entornos.

Agente

Un agente es el componente que ejecuta las automatizaciones en tu infraestructura. Es el programa Zoan Agent ejecutándose en un computador o servidor: se conecta a Nexus, anuncia que está disponible y espera órdenes. Cada agente pertenece a un entorno. Ver Qué es un agente.

Estados posibles:

Estado	Descripción
`online`	Conectado y disponible para recibir ejecuciones
`busy`	Ejecutando un proceso en este momento
`offline`	Desconectado o sin señal reciente (heartbeat)

Machine Key

La Machine Key es la clave secreta que un Agent usa para identificarse ante Nexus la primera vez que se conecta. Se genera al crear el agente en el portal y se muestra una sola vez. Piénsala como la “contraseña” de esa máquina. Ver Instalación en Windows.

Sesión de robot

Una sesión de robot es una cuenta de usuario de Windows que el bot usa para ejecutarse en modo desatendido. Le da al robot un escritorio donde trabajar cuando no hay nadie con sesión iniciada en la máquina — necesario para automatizar la interfaz (escritorio o navegador con ventana) en un servidor. Se elige al lanzar la ejecución. Ver Sesiones de robot.

Paquete

Un paquete es el artefacto que contiene la lógica de tu automatización —lo que diseñaste en el Designer— empaquetado y publicado en la plataforma con un número de versión semántico (ej. 1.2.0). Versionar te permite mejorar una automatización sin romper la que ya está en producción. Ver Publicar y versionar.

Playbook

Un playbook es una automatización concreta: la secuencia de actividades que se ejecuta. Un paquete puede contener uno o varios playbooks (uno principal y otros invocables). “Playbook” es lo que ves y editas en el Designer; “paquete” es cómo se publica y distribuye. Ver Vista general del Designer.

Actividad

Una actividad es el bloque mínimo de una automatización: hace una acción concreta (abrir un navegador, leer un Excel, enviar un correo, decidir entre dos caminos). Construyes un playbook combinando actividades. El catálogo completo está en Actividades.

Proceso

Un proceso es la configuración que asocia un paquete (en una versión específica) a un entorno. Es la “unidad ejecutable”: lo que el agente se ejecuta cuando recibe una orden. Separar paquete y proceso te permite, por ejemplo, tener el mismo paquete ejecutándose en Pruebas con la versión 1.3.0 y en Producción con la 1.2.0. Ver Crear un proceso.

Ejecución

Una ejecución (execution) es cada vez que un proceso se ejecuta en un agente. Tiene su propio ciclo de vida y genera logs consultables desde el portal. Si un proceso se ejecuta tres veces hoy, son tres ejecuciones. Ver Estados y ciclo de vida.

Estados posibles:

Estado	Descripción
`queued`	En cola, esperando que un agente esté disponible
`running`	Ejecutándose en el agente
`completed`	Finalizó con éxito
`failed`	Finalizó con error
`cancelled`	Cancelada manualmente

Trigger

Un trigger (disparador) define cuándo se lanza una ejecución. Puede ser manual (lo lanzas tú desde el portal o vía API) o programado (con una expresión cron, para que se ejecute solo a una hora o frecuencia). Ver Triggers.

Credencial

Una credencial almacena de forma segura información sensible —contraseñas, tokens, claves de API— para que tus bots accedan a sistemas que requieren login sin escribir el secreto en el playbook. El agente la obtiene en tiempo de ejecución y nunca queda expuesta en el código ni en los logs. Ver Gestión de credenciales.

Cola (Queue)

Una cola es una lista de elementos de trabajo pendientes (por ejemplo, 500 facturas por procesar). Permite repartir trabajo y que uno o varios bots vayan tomando elementos uno a uno, marcando cada uno como exitoso o fallido. Es la base para automatizaciones de alto volumen y para reintentar lo que falló.

Siguientes pasos

Arquitectura — cómo se comunican los componentes.
Primeros pasos — pon en práctica estos conceptos.