# ¿Qué es Volkom Mesh? > Documento explicativo, autocontenido. Para entender qué es Volkom Mesh sin > tecnicismos primero, y con la arquitectura real después. --- ## En una frase **Volkom Mesh es una plataforma para construir, correr y monitorear agentes de automatización a medida para PyMEs — y mostrar, en lenguaje de negocio, qué hicieron y cuánto valieron.** No vendemos software para que el cliente aprenda a usar. Vendemos que el trabajo repetitivo se haga solo, y que el cliente lo vea pasar en un portal claro. --- ## El problema que resuelve Las PyMEs pierden horas todos los días en trabajo manual y repetitivo: cargar datos, conciliar, generar reportes, monitorear sistemas, mover archivos entre aplicaciones. Las opciones del mercado no encajan: - **Herramientas enterprise** (UiPath, Automation Anywhere): caras, complejas, pensadas para corporaciones con equipo de IT. - **SaaS genérico**: no se adapta al proceso particular de cada negocio. - **Chatbots de IA**: "conversan", pero no *ejecutan* trabajo real. Volkom Mesh ataca ese hueco: automatización **a medida**, **gestionada** (el cliente no instala ni mantiene nada) y con **resultados visibles**. --- ## Cómo funciona (en simple) Tres momentos: 1. **Construir.** Volkom desarrolla un agente a medida para el proceso de mayor valor del cliente, partiendo de una base común (el "carcass") que ya trae toda la plomería resuelta. Esto hace que armar un agente nuevo tome días, no meses. 2. **Correr.** El agente se ejecuta solo — programado (cada X tiempo) o disparado por un flujo de trabajo de varios pasos. Corre en infraestructura del cliente; Volkom no tiene que entrar a su red. 3. **Mostrar.** Cada vez que el agente trabaja, **emite telemetría**: qué hizo y cuánto valió. Eso aparece en un portal pensado para gente de negocio. --- ## Las dos cosas que reporta cada agente Esta es la idea central del producto. Un agente no solo dice "corrió bien" — reporta en **dos canales separados**: | Canal | Responde | Ejemplos | |-------|----------|----------| | **Ejecución** | ¿Qué hizo? (da confianza) | arrancó → buscó correos → procesó 1.240 filas → terminó en 16s | | **Negocio** | ¿Cuánto valió? (da valor) | 42 pedidos, US$ 9.500 facturados, 95% a tiempo | El canal de **ejecución** demuestra que funciona, paso a paso, sin errores. El de **negocio** es lo que el dueño realmente quiere ver: los KPIs de su operación. --- ## Lo que lo hace especial: el motor es genérico El portal que muestra la telemetría es **data-driven**: el agente declara qué mide (la etiqueta, la unidad: plata, cantidad, porcentaje, tiempo) y el portal lo muestra **sin código a medida**. Agregar un KPI o un agente de un dominio nuevo **no toca la interfaz**. Por eso el mismo motor sirve, sin reescribirse, para industrias que no se parecen en nada: e-commerce, logística, salud, manufactura, finanzas, MLOps, moderación de contenido. Eso es lo que permite escalar. --- ## Quién controla qué - **Volkom controla la flota**: desarrolla los agentes, los versiona, los deploya, los agenda, gestiona las credenciales y monitorea todo desde un panel central. - **El cliente ve sus resultados**: entra a su portal, ve la actividad y sus KPIs, puede pausar/reactivar un agente y renombrarlo — pero no toca infraestructura ni se preocupa por seguridad. - **Aislamiento por cliente**: cada cliente (tenant) tiene su propia base de datos. - **Trazabilidad**: un audit log registra quién hizo qué en la plataforma. En la práctica: Volkom es el equipo técnico que el cliente no tiene que contratar. --- ## Los nombres (importante) - **Volkom Mesh** = la **solución que se vende** al cliente (lo que el cliente ve y usa). "Mesh" por la idea de una malla de agentes distribuidos corriendo en las operaciones de muchos clientes, observados desde un solo lugar. - **`volkom-core`** = la **librería interna versionada** que potencia todo (el motor, el carcass, el exporter de telemetría). Es el acelerador: improve once, propaga a todos los clientes al subir de versión. > Mesh es la promesa; core es la máquina. --- ## Arquitectura real (para una mirada técnica) Dos instalables + N agentes. Comunicación **push-only** (el cliente empuja telemetría hacia afuera; Volkom nunca entra a la red del cliente). ``` ┌─────────────────────────────┐ ┌──────────────────────────────┐ │ PAQUETE DEL CLIENTE │ │ CONTROL PLANE (Volkom) │ │ (corre en infra cliente) │ │ (corre en infra Volkom) │ │ │ push │ │ │ - Orquestador (Temporal) │ ──────► │ - API de ingest │ │ - Agentes (workflows) │ token │ - ClickHouse (telemetría) │ │ - Exporter de telemetría │ Bearer │ - Portal cliente + Admin │ │ - Lee datos locales │ │ - Alerting │ └─────────────────────────────┘ └──────────────────────────────┘ ``` - **Paquete del cliente** (Installable A): orquestador + exporter + los agentes de *ese* cliente. Una build por cliente — no comparten agentes. - **Control Plane** (Installable B): API de ingest + ClickHouse + dos frontends (portal del cliente *volkommesh* y panel admin *adminvm*) + alerting. Uno solo, central, observando a todos los clientes. - **El Core** (el acelerador): el esqueleto reutilizable (orquestador + contrato `BaseAgent` + exporter) como librería versionada `volkom-core`. Cada build de cliente la importa y agrega solo sus agentes. **Reglas de diseño clave:** - El control plane **solo observa** — no deploya remotamente ni se conecta hacia el cliente. Sumar un agente es una acción manual de Volkom dentro del paquete del cliente. - Comunicación **push-only**: el cliente abre solo egress de salida, sin puertos de entrada. Auth por token Bearer por agente (rotación/revocación). - **Una sola API y una sola base por tenant**: tanto el portal del cliente como el panel admin leen exactamente lo mismo. No hay data desincronizada entre fronts. > Nota de alcance (MVP): los "agentes" son **workflows deterministas** (sin LLM en > runtime); "agente" es la etiqueta comercial. Los agentes MVP son **headless** > (APIs, archivos, bases). Automatización que maneja una GUI de escritorio es un > tier aparte, fuera del MVP. --- ## En resumen Volkom Mesh convierte procesos manuales de PyMEs en agentes que trabajan solos, gestionados de punta a punta por Volkom, y reporta en lenguaje de negocio qué hicieron y cuánto valieron — sobre un motor genérico que escala a cualquier industria sin reescribirse. > Para el detalle de cómo un agente reporta su telemetría, ver la > [Guía de telemetría](../guia/) (explicativa) y la > [Referencia de la API](../api/) (técnica).