Hermes Agent Builder Lab

De una idea a un agente que recuerda, usa tools y entrega.

Una experiencia práctica para construir un asistente en EC2, conectarlo a Telegram y ampliar sus capacidades con Composio.

Ruta de la sesión

Concepto breve. Construcción práctica. Cierre responsable.

15 min · Entender

ChatGPT vs. agente, anatomía de Hermes y ciclo de ejecución.

Bloque principal · Construir

EC2, Hermes, Telegram, toolsets, Composio y prueba de un flujo.

10 min · Cerrar

Ética, permisos, human-in-the-loop y ejercicio corto.

ChatGPT vs. agente

La diferencia no es hablar mejor. Es poder sostener trabajo.

ChatGPT

Responde dentro de una conversación. El usuario aporta contexto, decide el siguiente paso y ejecuta fuera del chat.

Hermes Agent

Mantiene identidad y memoria, elige herramientas, ejecuta pasos, observa resultados y continúa hasta completar un objetivo.

EstadoDe contexto temporal a continuidad entre sesiones.
AcciónDe texto generado a tools con permisos definidos.
ControlDe respuesta única a ciclo con verificación y aprobación.
Anatomía del agente

Hermes es un sistema compuesto, no un modelo aislado.

Modelo

Interpreta, razona, decide y redacta.

Instrucciones

Definen identidad, propósito, reglas y criterio.

Memoria

Conserva hechos, decisiones y continuidad.

Tools

Le permiten observar y actuar fuera del chat.

Gateway y canales

Reciben eventos desde Telegram y otros medios.

Humano en el circuito

Aprueba acciones sensibles y valida el resultado.

Ciclo del agente

Un agente avanza en ciclos, no en una sola respuesta.

01Observar

Leer mensaje, memoria y entorno.

02Planear

Elegir el siguiente paso útil.

03Actuar

Responder o ejecutar una tool.

04Inspeccionar

Interpretar la respuesta de la tool.

05Verificar

Confirmar si el objetivo quedó cumplido.

Hermes Agent

Hermes le da cuerpo operativo a un modelo.

Puede vivir en una laptop o una VM, conversar por varios canales, ejecutar tools, programar tareas y delegar trabajo.

Canales

CLI, Telegram, Discord, Slack, WhatsApp, Signal y email.

Toolsets

Web, terminal, archivos, browser, media y automatización.

Skills

Procedimientos reutilizables que capturan experiencia.

Delegación

Subagentes para trabajos paralelos y aislados.

De conversación a workspace

Una sesión de Hermes puede convertirse en un espacio de trabajo.

El agente combina archivos, herramientas, memoria y ejecución para mantener un proyecto en movimiento.

Archivos

Lee, compara, crea y corrige entregables.

Terminal

Ejecuta comandos y valida resultados.

Browser

Navega interfaces cuando una API no basta.

Cron

Programa tareas con entrega por canal.

Toolsets de Hermes

No existe una tool mágica. Existe una caja bien seleccionada.

Web

Buscar, extraer y contrastar información.

Terminal & files

Comandos, procesos, lectura y edición.

Browser & media

Automatización visual, visión, imagen y voz.

Agent ops

Memoria, cron, skills, clarificación y delegación.

Composio

Composio conecta Hermes con las apps donde ya vive el trabajo.

Gestiona autenticación y expone acciones como tools. Hermes decide cuándo usarlas; el humano controla cuentas, permisos y aprobaciones.

Hermes

Entiende el objetivo y selecciona una acción.

→
Composio

Resuelve conexión, toolkit y autenticación.

→
App

Devuelve datos o ejecuta el cambio autorizado.

Cadena de capacidades

El modelo piensa en lenguaje.

Hermes organiza el trabajo. Composio conecta aplicaciones. Los toolkits convierten intención en acciones concretas.

La cadena completa

Modelo → Hermes → MCP → Composio → toolkit → tool → app → verificación.

Cloudflare entra cuando el proyecto necesita publicarse y vivir fuera de la demo.

AWS puede apoyar infraestructura; Cloudflare sirve para hosting/deploy visible, dominios y publicar artifacts web.

Despliegue en EC2

De una cuenta AWS a un agente disponible 24/7.

01EC2

Ubuntu 24.04, t3.medium y disco cifrado.

02Acceso

SSH desde My IP y llave .pem protegida.

03Hermes

Instalación, modelo, memoria y toolsets.

04Gateway

Telegram conectado y servicio persistente.

05Composio

MCP remoto, OAuth y tools seleccionadas.

Dentro de Composio

No son “plugins” genéricos: son toolkits, conexiones y tools.

Cada toolkit representa una aplicación; cada cuenta conectada autoriza un alcance; cada tool ejecuta una operación específica.

Toolkit

Gmail, Google Drive, Calendar, GitHub, Notion, Slack y más.

Connected account

La cuenta exacta y sus permisos OAuth.

Tool

Buscar correo, crear evento, leer archivo o abrir issue.

Toolkits para el laboratorio

Empezamos con lectura. Los writes llegan después de aprobar.

Google Drive

Encontrar archivos, leer metadatos y descargar fuentes.

Gmail

Buscar y resumir mensajes sin enviarlos.

Calendar

Consultar disponibilidad antes de crear eventos.

GitHub

Leer repos, issues y estado antes de escribir.

Principio: descubrir → inspeccionar esquema → probar lectura → pedir aprobación → escribir una vez → verificar.

Diseño del flujo

Primero se diseña el criterio. Después se conectan tools.

Identidad

Qué agente estamos construyendo.

Fuentes

Qué datos puede consultar.

Protocolo

Qué pasos debe seguir siempre.

Aprobación

Qué acciones nunca toma solo.

Práctica 1

Crear el agente en Hermes.

Instrucciones

Rol, objetivo, tono, límites y criterio de éxito.

→
Memoria

Usuario, proyecto, decisiones y continuidad.

→
Tools

Toolsets de Hermes y MCP de Composio.

Práctica guiada

Cada persona conecta una capacidad y completa un flujo.

Drive

Encontrar evidencia → resumir → entregar enlace verificado.

Web

Contrastar fuentes → sintetizar → citar evidencia.

GitHub

Leer issue → proponer plan → dejar prueba reproducible.

Prueba de calidad

Si no lo podés explicar, verificar y repetir, todavía no está listo.

Problema

Qué necesidad concreta resolvimos.

Proceso

Qué instrucciones y tools usamos.

Evidencia

Qué archivo, acción o recibo demuestra el resultado.

Frontera personal

Un asistente poderoso necesita límites visibles.

No compartir

  • Contraseñas o llaves privadas
  • Tokens en chats o capturas
  • Información ajena sin permiso
  • Datos que no necesita

Sí construir

  • Permisos mínimos
  • Cuentas separadas
  • Aprobaciones para writes
  • Registro de acciones
Human-in-the-loop

El humano no desaparece. Se mueve al punto de decisión.

Puede avanzar solo

  • Leer archivos
  • Investigar fuentes
  • Preparar borradores
  • Ejecutar pruebas reversibles

Debe pedir aprobación

  • Enviar mensajes
  • Publicar o comprar
  • Modificar datos sensibles
  • Eliminar o sobrescribir
Permisos mínimos

Cada capacidad debe corresponder a una necesidad real.

Sin acceso

La app no forma parte del trabajo.

Solo lectura

Puede consultar y resumir.

Escritura limitada

Puede crear dentro de un alcance específico.

Aprobación

El humano confirma acciones sensibles.

IA mal usada: deuda cognitiva.

Dejas que la herramienta piense por vos. Copias sin entender, aceptas sin revisar y perdes habilidad.

Ejercicio final · 5 minutos

¿Autónomo, con aprobación o prohibido?

En parejas, clasifiquen cada escenario y justifiquen el límite.

Escenario A

Leer tres archivos y preparar un resumen con enlaces.

Escenario B

Enviar el resumen por correo a un cliente.

Escenario C

Copiar credenciales del usuario para evitar OAuth.

Respuesta esperada: autónomo · aprobación · prohibido.

Brain
trainer
Cierre

Las ideas avanzan cuando un agente puede convertirlas en trabajo verificable.

Hermes aporta el sistema. Composio abre las conexiones. Vos aportás el criterio, la responsabilidad y el propósito.