Communitygithub.com

Diseñador de Agentes - Arquitectura de Sistemas Multiagente

Un completo conjunto de herramientas para diseñar, arquitecturar y evaluar sistemas multiagente, proporcionando patrones de arquitectura, principios de diseño de herramientas, estrategias de comunicación y marcos de evaluación para construir sistemas de IA robustos y escalables.

¿Qué es Diseñador de Agentes - Arquitectura de Sistemas Multiagente?

Diseñador de Agentes es un skill integral para arquitectos de sistemas e ingenieros que diseñan sistemas multiagente complejos. Proporciona una guía estructurada sobre patrones de arquitectura de agentes (como supervisor, enjambre, jerárquico y pipeline), definición de roles de agente (coordinador, especialista, interfaz y monitor), principios de diseño de herramientas (validación de esquemas, manejo de errores, idempotencia) y patrones de comunicación (paso de mensajes, estado compartido, eventos). También cubre salvaguardas de seguridad, marcos de evaluación (métricas de finalización, calidad, costos, latencia), estrategias de orquestación (centralizada, descentralizada, híbrida), patrones de memoria (corto plazo, largo plazo, compartida), consideraciones de escalado y manejo de fallos (reintentos, estrategias de respaldo, interruptores de circuito). Es útil para cualquier persona que construya sistemas multiagente en plataformas como Claude Code, Cursor o Codex, ya que ofrece un enfoque sistemático para diseñar sistemas robustos y escalables.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/agent-designer

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Diseñador de Agentes - Arquitectura de Sistemas Multiagente?

Nivel: PODEROSO
Categoría: Ingeniería
Etiquetas: Agentes de IA, arquitectura, diseño de sistemas, orquestación, sistemas multiagente

Resumen

Diseñador de Agentes es un conjunto completo de herramientas para diseñar, arquitecturar y evaluar sistemas multiagente. Proporciona enfoques estructurados para patrones de arquitectura de agentes, principios de diseño de herramientas, estrategias de comunicación y marcos de evaluación de rendimiento para construir sistemas de agentes de IA robustos y escalables.

Capacidades Principales

1. Patrones de Arquitectura de Agentes

Patrón de Agente Único

  • Caso de Uso: Tareas simples y enfocadas con límites claros
  • Ventajas: Complejidad mínima, depuración fácil, comportamiento predecible
  • Desventajas: Escalabilidad limitada, punto único de fallo
  • Implementación: Interacción directa usuario-agente con acceso completo a herramientas

Patrón de Supervisor

  • Caso de Uso: Descomposición jerárquica de tareas con control centralizado
  • Arquitectura: Un agente supervisor que coordina múltiples agentes especialistas
  • Ventajas: Estructura de mando clara, toma de decisiones centralizada
  • Desventajas: Cuello de botella del supervisor, lógica de coordinación compleja
  • Implementación: El supervisor recibe tareas, delega en especialistas, agrega resultados

Patrón de Enjambre

  • Caso de Uso: Resolución de problemas distribuida con colaboración entre pares
  • Arquitectura: Múltiples agentes autónomos con objetivos compartidos
  • Ventajas: Alto paralelismo, tolerancia a fallos, inteligencia emergente
  • Desventajas: Coordinación compleja, conflictos potenciales, difícil de predecir
  • Implementación: Descubrimiento de agentes, mecanismos de consenso, asignación distribuida de tareas

Patrón Jerárquico

  • Caso de Uso: Sistemas complejos con múltiples capas organizativas
  • Arquitectura: Estructura de árbol con gerentes y trabajadores en diferentes niveles
  • Ventajas: Mapeo organizativo natural, responsabilidades claras
  • Desventajas: Sobrecarga de comunicación, posibles cuellos de botella en cada nivel
  • Implementación: Delegación multinivel con bucles de retroalimentación

Patrón de Pipeline

  • Caso de Uso: Procesamiento secuencial con etapas especializadas
  • Arquitectura: Agentes dispuestos en un pipeline de procesamiento
  • Ventajas: Flujo de datos claro, optimización especializada por etapa
  • Desventajas: Cuellos de botella secuenciales, orden de procesamiento rígido
  • Implementación: Colas de mensajes entre etapas, transferencias de estado

2. Definición de Roles de Agente

Marco de Especificación de Roles

  • Identidad: Nombre, declaración de propósito, competencias principales
  • Responsabilidades: Tareas principales, límites de decisión, criterios de éxito
  • Capacidades: Herramientas requeridas, dominios de conocimiento, límites de procesamiento
  • Interfaces: Formatos de entrada/salida, protocolos de comunicación
  • Restricciones: Límites de seguridad, límites de recursos, pautas operativas

Arquetipos Comunes de Agentes

Agente Coordinador

  • Orquesta flujos de trabajo multiagente
  • Toma decisiones de alto nivel y asignación de recursos
  • Monitorea la salud y el rendimiento del sistema
  • Maneja escalamientos y resolución de conflictos

Agente Especialista

  • Experiencia profunda en un dominio específico (código, datos, investigación)
  • Herramientas y conocimiento optimizados para tareas especializadas
  • Resultados de alta calidad dentro de un alcance limitado
  • Protocolos claros de transferencia para solicitudes fuera del alcance

Agente de Interfaz

  • Maneja interacciones externas (usuarios, APIs, sistemas)
  • Traducción de protocolos y conversión de formatos
  • Gestión de autenticación y autorización
  • Optimización de la experiencia del usuario

Agente Monitor

  • Monitoreo de salud del sistema y alertas
  • Recopilación y análisis de métricas de rendimiento
  • Detección y reporte de anomalías
  • Mantenimiento de cumplimiento y pistas de auditoría

3. Principios de Diseño de Herramientas

Diseño de Esquemas

  • Validación de Entrada: Tipado fuerte, parámetros requeridos vs opcionales
  • Consistencia de Salida: Formatos de respuesta estandarizados, manejo de errores
  • Documentación: Descripciones claras, ejemplos de uso, casos límite
  • Versionado: Compatibilidad hacia atrás, rutas de migración

Patrones de Manejo de Errores

  • Degradación Gradual: Funcionalidad parcial cuando fallan las dependencias
  • Lógica de Reintento: Retroceso exponencial, interruptores de circuito, intentos máximos
  • Propagación de Errores: Respuestas de error estructuradas, clasificación de errores
  • Estrategias de Recuperación: Métodos de respaldo, enfoques alternativos

Requisitos de Idempotencia

  • Operaciones Seguras: Operaciones de lectura sin efectos secundarios
  • Escrituras Idempotentes: La misma operación se puede repetir de forma segura
  • Gestión de Estado: Seguimiento de versiones, resolución de conflictos
  • Atomicidad: Finalización de operación de todo o nada

4. Patrones de Comunicación

Paso de Mensajes

  • Mensajería Asíncrona: Agentes desacoplados, colas de mensajes
  • Formato de Mensaje: Cargas útiles estructuradas con metadatos
  • Garantías de Entrega: Semántica al menos una vez, exactamente una vez
  • Enrutamiento: Mensajería directa, publicar-suscribir, difusión

Estado Compartido

  • Almacenes de Estado: Repositorios de datos centralizados
  • Modelos de Consistencia: Consistencia fuerte, eventual, débil
  • Patrones de Acceso: Carga intensiva de lectura, escritura, mixta
  • Resolución de Conflictos: El último escritor gana, estrategias de fusión

Arquitectura Basada en Eventos

  • Fuente de Eventos: Registros de eventos inmutables, reconstrucción de estado
  • Tipos de Eventos: Eventos de dominio, eventos del sistema, eventos de integración
  • Procesamiento de Eventos: Tiempo real, por lotes, procesamiento de flujos
  • Esquema de Eventos: Formatos de eventos versionados, compatibilidad hacia atrás

5. Salvaguardas y Seguridad

Validación de Entrada

  • Cumplimiento del Esquema: Campos requeridos, verificación de tipos, validación de formato
  • Filtrado de Contenido: Detección de contenido dañino, eliminación de PII
  • Limitación de Velocidad: Aceleración de solicitudes, cuotas de recursos
  • Autenticación: Verificación de identidad, comprobaciones de autorización

Filtrado de Salida

  • Moderación de Contenido: Eliminación de contenido dañino, comprobaciones de calidad
  • Validación de Consistencia: Comprobaciones de lógica, verificación de restricciones
  • Formateo: Formatos de salida estandarizados, presentación limpia
  • Registro de Auditoría: Pistas de decisiones, registros de cumplimiento

Humano en el Bucle

  • Flujos de Aprobación: Puntos de control de decisiones críticas
  • Disparadores de Escalamiento: Umbrales de confianza, evaluación de riesgos
  • Mecanismos de Anulación: Precedencia del juicio humano
  • Bucles de Retroalimentación: Las correcciones humanas mejoran el comportamiento del sistema

6. Marcos de Evaluación

Métricas de Finalización de Tareas

  • Tasa de Éxito: Porcentaje de tareas completadas con éxito
  • Finalización Parcial: Medición del progreso para tareas complejas
  • Clasificación de Tareas: Criterios de éxito por tipo de tarea
  • Análisis de Fallos: Identificación y categorización de causas raíz

Evaluación de Calidad

  • Calidad de Salida: Medidas de precisión, relevancia, integridad
  • Consistencia: Variabilidad de respuestas en entradas similares
  • Coherencia: Flujo lógico y consistencia interna
  • Satisfacción del Usuario: Puntuaciones de retroalimentación, patrones de uso

Análisis de Costos

  • Uso de Tokens: Consumo de tokens de entrada/salida por tarea
  • Costos de API: Uso y cargos de servicios externos
  • Recursos de Cómputo: Utilización de CPU, memoria, almacenamiento
  • Tiempo hasta el Valor: Costo por finalización exitosa de tarea

Distribución de Latencia

  • Tiempo de Respuesta: Tiempo de finalización de tarea de extremo a extremo
  • Etapas de Procesamiento: Identificación de cuellos de botella por etapa
  • Tiempos de Cola: Tiempos de espera en pipelines de procesamiento
  • Contención de Recursos: Impacto de operaciones concurrentes

7. Estrategias de Orquestación

Orquestación Centralizada

  • Motor de Flujo de Trabajo: Coordinador central gestiona todos los agentes
  • Gestión de Estado: Seguimiento centralizado del estado del flujo de trabajo
  • Lógica de Decisión: Reglas complejas de enrutamiento y bifurcación
  • Monitoreo: Visibilidad completa de todas las operaciones

Orquestación Descentralizada

  • Peer-to-Peer: Los agentes se coordinan directamente entre sí
  • Descubrimiento de Servicios: Registro y búsqueda dinámica de agentes
  • Protocolos de Consenso: Toma de decisiones distribuida
  • Tolerancia a Fallos: Sin punto único de fallo

Enfoques Híbridos

  • Límites de Dominio: Centralizado dentro de dominios, federado entre ellos
  • Coordinación Jerárquica: Múltiples niveles de orquestación
  • Dependiente del Contexto: Selección de estrategia según el tipo de tarea
  • Balance de Carga: Distribución de la responsabilidad de coordinación

8. Patrones de Memoria

Memoria a Corto Plazo

  • Ventanas de Contexto: Memoria de trabajo para tareas actuales
  • Estado de Sesión: Datos temporales para interacciones en curso
  • Gestión de Caché: Estrategias de optimización del rendimiento
  • Presión de Memoria: Manejo de restricciones de capacidad

Memoria a Largo Plazo

  • Almacenamiento Persistente: Datos duraderos entre sesiones
  • Base de Conocimiento: Conocimiento de dominio acumulado
  • Reproducción de Experiencias: Aprendizaje de interacciones pasadas
  • Consolidación de Memoria: Transferencia de corto a largo plazo

Memoria Compartida

  • Conocimiento Colaborativo: Aprendizaje compartido entre agentes
  • Sincronización: Estrategias de mantenimiento de consistencia
  • Control de Acceso: Acceso a memoria basado en permisos
  • Particionamiento de Memoria: Aislamiento entre grupos de agentes

9. Consideraciones de Escalado

Escalado Horizontal

  • Replicación de Agentes: Múltiples instancias del mismo tipo de agente
  • Distribución de Carga: Enrutamiento de solicitudes entre instancias de agentes
  • Agrupación de Recursos: Recursos de cómputo y almacenamiento compartidos
  • Distribución Geográfica: Despliegues en múltiples regiones

Escalado Vertical

  • Mejora de Capacidad: Agentes individuales más potentes
  • Expansión de Herramientas: Acceso más amplio a herramientas por agente
  • Expansión de Contexto: Mayor capacidad de memoria de trabajo
  • Potencia de Procesamiento: Mayor rendimiento por agente

Optimización del Rendimiento

  • Estrategias de Caché: Caché de respuestas, caché de resultados de herramientas
  • Procesamiento en Paralelo: Ejecución concurrente de tareas
  • Optimización de Recursos: Uso eficiente de los recursos
  • Eliminación de Cuellos de Botella: Ajuste sistemático del rendimiento

10. Manejo de Fallos

Mecanismos de Reintento

  • Retroceso Exponencial: Demoras crecientes entre reintentos
  • Jitter: Variación aleatoria de demora para evitar avalanchas
  • Intentos Máximos: Comportamiento de reintento acotado
  • Condiciones de Reintento: Clasificación de fallos transitorios vs permanentes

Estrategias de Respaldo

  • Degradación Gradual: Funcionalidad reducida cuando fallan los sistemas
  • Enfoques Alternativos: Diferentes métodos para los mismos objetivos
  • Respuestas Predeterminadas: Comportamientos de respaldo seguros
  • Comunicación al Usuario: Mensajes de error claros

Interruptores de Circuito

  • Detección de Fallos: Monitoreo de tasas de fallo y tiempos de respuesta
  • Gestión de Estado: Estados de circuito abierto, cerrado, semiabierto
  • Pruebas de Recuperación: Retorno gradual a la operación normal
  • Prevención de Fallos en Cascada: Protección de sistemas ascendentes

Pautas de Implementación

Proceso de Decisión de Arquitectura

  1. Análisis de Requisitos: Comprender objetivos del sistema, restricciones, escala
  2. Selección de Patrón: Elegir el patrón de arquitectura apropiado
  3. Diseño de Agentes: Definir roles, responsabilidades, interfaces
  4. Arquitectura de Herramientas: Diseñar esquemas de herramientas y manejo de errores
  5. Diseño de Comunicación: Seleccionar patrones de mensajes y protocolos
  6. Implementación de Seguridad: Construir salvaguardas y validación
  7. Planificación de Evaluación: Definir métricas de éxito y monitoreo
  8. Estrategia de Despliegue: Planificar escalado y manejo de fallos

Aseguramiento de la Calidad

  • Estrategia de Pruebas: Pruebas unitarias, de integración y del sistema
  • Monitoreo: Seguimiento en tiempo real de la salud y el rendimiento del sistema
  • Documentación: Documentación de arquitectura y runbooks
  • Revisión de Seguridad: Modelado de amenazas y evaluaciones de seguridad

Mejora Continua

  • Monitoreo del Rendimiento: Análisis continuo del rendimiento del sistema
  • Retroalimentación del Usuario: Incorporación de mejoras en la experiencia del usuario
  • Pruebas A/B: Experimentos controlados para mejoras del sistema
  • Actualizaciones de la Base de Conocimiento: Aprendizaje y adaptación continuos

Este skill proporciona la base para diseñar sistemas multiagente robustos y escalables que pueden manejar tareas complejas mientras mantienen seguridad, fiabilidad y rendimiento a escala.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

Skills relacionados