Sistemas
Arquitecturas completas de proyectos reales con agentes, con diagrama, componentes, código esencial, evaluación, costes y riesgos.
SistemasUn sistema es un proyecto completo explicado de principio a fin: qué problema resuelve, qué piezas tiene, cómo fluye una petición y qué decisiones de diseño hay detrás. Aquí se juntan las lecciones, los patrones y las recetas en algo que podrías poner en producción.
Qué sistemas hay
- RAG con citas verificables: responde sobre tus documentos, cita la fuente y se abstiene si no la encuentra. Buen primer sistema.
- Extracción documental a JSON: facturas y contratos a JSON validado, con revisión humana de los casos dudosos.
- Agente de soporte con aprobación humana: resuelve tickets con herramientas y pide permiso antes de reembolsar.
- Asistente sobre tu base de datos con MCP: consultas en lenguaje natural sobre tu base de datos, con un servidor MCP de solo lectura.
- Agente de código: lee el repositorio, propone cambios, ejecuta tests y deja una propuesta revisable.
- Sistema multiagente de investigación: un orquestador reparte la pregunta entre subagentes que buscan en paralelo.
- Agente de voz: voz a texto, modelo con herramientas y texto a voz, con la latencia como problema central.
Cómo leer cada ficha
La cabecera de cada sistema resume cuatro datos:
| Dato | Qué te dice |
|---|---|
| Complejidad (1–3) | Cuánto cuesta construirlo y mantenerlo |
| Tiempo | Lo que lleva una primera versión funcional |
| Stack y componentes | Las piezas que necesitas |
| Patrones | Qué patrones de agentes combina, con enlace a cada uno |
Después viene siempre la misma estructura: problema, diagrama, componentes, flujo paso a paso, decisiones de diseño y alternativas, código esencial, cómo evaluarlo, costes y riesgos, variantes y por dónde empezar.
7 arquitecturas
complejidad · tiempo · stack-
RAG con citas verificables
Arquitectura de un asistente que responde sobre tus documentos citando la fuente exacta, comprueba en código que cada cita existe y se abstiene cuando no hay evidencia.
- Ingesta y troceado
- Índice híbrido
- Reranker
- Generador con citas
- +2
Python · API de Claude · base vectorial 2 patrones -
Agente de soporte con aprobación humana
Arquitectura de un agente que resuelve tickets consultando pedidos y documentación, y que propone reembolsos o cambios para que una persona los apruebe antes de ejecutarse.
- Canal de entrada
- Agente con herramientas
- Capa de políticas
- Cola de aprobación
- +2
Python · API de Claude · API de pedidos 3 patrones -
Sistema multiagente de investigación
Arquitectura de un orquestador que divide una pregunta abierta, lanza subagentes de búsqueda en paralelo con contexto propio y sintetiza un informe con fuentes verificadas.
- Agente líder
- Subagentes de búsqueda
- Herramientas de búsqueda y lectura
- Memoria del plan
- +2
Python · asyncio · API de Claude 3 patrones -
Agente de código
Arquitectura de un agente que lee un repositorio, propone cambios acotados, ejecuta los tests en un sandbox y abre una propuesta revisable por una persona.
- Entrada de la tarea
- Sandbox con el repositorio
- Herramientas de lectura
- Herramienta de edición
- +2
Python · API de Claude · contenedor aislado 3 patrones -
Extracción documental a JSON
Arquitectura para convertir facturas y contratos en JSON validado con esquema, comprobar reglas de negocio en código y mandar a revisión humana solo los casos dudosos.
- Ingesta y extracción de texto
- Extractor con esquema
- Validador de reglas
- Enrutador de confianza
- +2
Python · API de Claude · Pydantic 2 patrones -
Asistente sobre tu base de datos con MCP
Arquitectura de un servidor MCP de solo lectura sobre una base de datos que permite hacer preguntas en lenguaje natural con límites de filas, tiempo y tablas visibles.
- Cliente MCP
- Servidor MCP de datos
- Capa de permisos de la base de datos
- Validador de consultas
- +2
Python · SDK de MCP (MCPServer) · SQLite o PostgreSQL 2 patrones -
Agente de voz
Arquitectura de un agente que escucha, decide con herramientas y responde hablando, con streaming de punta a punta, gestión de interrupciones y confirmaciones antes de actuar.
- Transporte de audio
- Detección de actividad de voz
- Voz a texto
- Agente con herramientas
- +3
Python · asyncio · API de Claude 2 patrones