MVP Agente

Orquestador multiagente en Python con API REST, bots de Telegram y Discord, memoria de corto y largo plazo y cambio de proveedor de LLM sin modificar los agentes.

MVP en desarrollo activo · licencia MITSistema multiagente · LLM2026
Contexto y objetivo
Un asistente que atiende por Telegram, Discord, terminal y API REST, con historial persistido, base de datos relacional y un catálogo de herramientas (búsqueda, correo, análisis forense de imagen y audio).
Problema
Integrar varios canales y varios proveedores de LLM en un único núcleo, sin acoplar los agentes a un proveedor específico y manteniendo la memoria por usuario entre reinicios.
Tecnologías
pythonfastapipydanticsqlalchemypostgresqlchromadbmemcachedjwtdockerpytestreacttypescript
01 / Arquitectura

Arquitectura utilizada

  1. telegram · discord · api
  2. manager
  3. planner
  4. executor
  5. tools registry
  6. llm strategy
  7. postgres · chromadb
telegram · discord · api → managermanager → plannerplanner → executorexecutor → tools registrymanager → llm strategymanager → postgres · chromadb

Agentes

Manager conversa y orquesta; Planner arma un plan de acción (pipeline JSON) a partir del catálogo de tools; Executor ejecuta las funciones indicadas.

Canales

Bot de Discord; webhook de Telegram y API REST de chat con FastAPI, con autenticación JWT.

LLMs (Strategy)

OpenAI, Anthropic, Google Gemini y Ollama (modelos locales) detrás de la misma interfaz.

Memoria

Corto plazo en PostgreSQL (se recarga tras un reinicio); largo plazo con RAG en ChromaDB, filtrado por usuario; caché en Memcached.

Tools

Registry con auto-discovery: búsqueda web, SMTP y notificaciones con lista de destinatarios permitidos, cifrado Fernet, procesamiento de imagen y análisis de audio.

02 / Decisiones

Decisiones técnicas

Y el trade-off detrás de cada una.

  • Patrón Strategy para los LLM: cambiar de proveedor no modifica los agentes.
  • Inyección de dependencias entre agentes y registry de tools con auto-discovery.
  • Embeddings generados localmente por ChromaDB (all-MiniLM-L6-v2), compatibles con cualquier LLM.
  • ChromaDB y Memcached opcionales: si no están disponibles, el agente sigue solo con el historial reciente.
  • Memcached deduplica los webhooks de Telegram y guarda la intención detectada durante 1 hora, lo que ahorra llamadas al LLM.
  • Herramientas de correo y notificación restringidas a destinatarios autorizados explícitamente.
03 / Desafíos

Desafíos enfrentados

Por completar

¿Cuáles fueron los problemas difíciles? ¿Qué no funcionó en el primer intento?

04 / Resultados

Resultados obtenidos

Por completar

Resultados medidos (tiempo, costo, usuarios, aprendizajes). Prefiere números.