Communitygithub.com

Agent Designer - Multi-Agenten-Systemarchitektur

Ein umfassendes Toolkit zum Entwerfen, Architekturieren und Bewerten von Multi-Agenten-Systemen

Was ist Agent Designer - Multi-Agenten-Systemarchitektur?

Agent Designer ist ein umfassendes Toolkit für die Planung, Architektur und Bewertung von Multi-Agenten-Systemen. Es bietet strukturierte Ansätze für Agentenarchitekturmuster, Tool-Design-Prinzipien, Kommunikationsstrategien und Leistungsbewertungs-Frameworks, die zum Bau robuster, skalierbarer KI-Agentensysteme benötigt werden. Das Skill unterstützt Entwickler dabei, die richtigen Architekturmuster (z. B. Einzelagent, Supervisor, Schwarm, Hierarchie, Pipeline) auszuwählen, Agentenrollen und -verantwortlichkeiten zu definieren und Sicherheitsmaßnahmen (Guardrails) sowie Evaluierungsmetriken zu integrieren. Es eignet sich für Ingenieure und Architekten, die mit Claude Code, Cursor, Codex oder anderen KI-Agenten-Plattformen arbeiten, und hilft bei der effektiven Orchestrierung komplexer Workflows.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Agent Designer - Multi-Agenten-Systemarchitektur?

Stufe: LEISTUNGSSTARK
Kategorie: Engineering
Tags: KI-Agenten, Architektur, Systemdesign, Orchestrierung, Multi-Agenten-Systeme

Überblick

Agent Designer ist ein umfassendes Toolkit zum Entwerfen, Architekturieren und Bewerten von Multi-Agenten-Systemen. Es bietet strukturierte Ansätze für Agentenarchitekturmuster, Tool-Design-Prinzipien, Kommunikationsstrategien und Leistungsbewertungs-Frameworks zum Bau robuster, skalierbarer KI-Agentensysteme.

Kernfunktionen

1. Agentenarchitekturmuster

Einzelagentenmuster

  • Einsatzfall: Einfache, fokussierte Aufgaben mit klaren Grenzen
  • Vorteile: Minimale Komplexität, einfaches Debugging, vorhersagbares Verhalten
  • Nachteile: Begrenzte Skalierbarkeit, einzelner Fehlerpunkt
  • Implementierung: Direkte Benutzer-Agenten-Interaktion mit umfassendem Toolzugriff

Supervisormuster

  • Einsatzfall: Hierarchische Aufgabenzerlegung mit zentralisierter Steuerung
  • Architektur: Ein Supervisor-Agent koordiniert mehrere Spezialisten-Agenten
  • Vorteile: Klare Befehlskette, zentralisierte Entscheidungsfindung
  • Nachteile: Supervisoren-Engpass, komplexe Koordinationslogik
  • Implementierung: Supervisor erhält Aufgaben, delegiert an Spezialisten, aggregiert Ergebnisse

Schwarmmuster

  • Einsatzfall: Verteiltes Problemlösen mit Peer-to-Peer-Zusammenarbeit
  • Architektur: Mehrere autonome Agenten mit gemeinsamen Zielen
  • Vorteile: Hohe Parallelität, Fehlertoleranz, emergente Intelligenz
  • Nachteile: Komplexe Koordination, mögliche Konflikte, schwerer vorhersagbar
  • Implementierung: Agentenentdeckung, Konsensmechanismen, verteilte Aufgabenverteilung

Hierarchisches Muster

  • Einsatzfall: Komplexe Systeme mit mehreren Organisationsebenen
  • Architektur: Baumstruktur mit Managern und Arbeitern auf verschiedenen Ebenen
  • Vorteile: Natürliche organisatorische Abbildung, klare Verantwortlichkeiten
  • Nachteile: Kommunikationsaufwand, mögliche Engpässe auf jeder Ebene
  • Implementierung: Mehrstufige Delegation mit Rückkopplungsschleifen

Pipeline-Muster

  • Einsatzfall: Sequenzielle Verarbeitung mit spezialisierten Stufen
  • Architektur: Agenten in einer Verarbeitungspipeline angeordnet
  • Vorteile: Klarer Datenfluss, spezielle Optimierung pro Stufe
  • Nachteile: Sequenzielle Engpässe, starre Verarbeitungsreihenfolge
  • Implementierung: Nachrichtenwarteschlangen zwischen Stufen, Zustandsübergaben

2. Agentenrollendefinition

Rahmenwerk für Rollenspezifikation

  • Identität: Name, Zweckerklärung, Kernkompetenzen
  • Verantwortlichkeiten: Primäre Aufgaben, Entscheidungsgrenzen, Erfolgskriterien
  • Fähigkeiten: Erforderliche Tools, Wissensdomänen, Verarbeitungsgrenzen
  • Schnittstellen: Ein-/Ausgabeformate, Kommunikationsprotokolle
  • Einschränkungen: Sicherheitsgrenzen, Ressourcenlimits, Betriebsrichtlinien

Häufige Agenten-Archetypen

Koordinator-Agent

  • Orchestriert Multi-Agenten-Workflows
  • Trifft Entscheidungen auf hoher Ebene und weist Ressourcen zu
  • Überwacht Systemgesundheit und -leistung
  • Behandelt Eskalationen und Konfliktlösungen

Spezialist-Agent

  • Tiefes Fachwissen in bestimmten Domänen (Code, Daten, Forschung)
  • Optimierte Tools und Wissen für spezialisierte Aufgaben
  • Hochwertige Ausgaben innerhalb eines engen Bereichs
  • Klare Übergabeprotokolle für Anfragen außerhalb des Bereichs

Schnittstellen-Agent

  • Handhabt externe Interaktionen (Benutzer, APIs, Systeme)
  • Protokollübersetzung und Formatkonvertierung
  • Authentifizierungs- und Autorisierungsmanagement
  • Optimierung der Benutzererfahrung

Überwachungs-Agent

  • Systemgesundheitsüberwachung und Warnungen
  • Sammlung und Analyse von Leistungsmetriken
  • Anomalieerkennung und -meldung
  • Compliance- und Prüfpfadwartung

3. Tool-Design-Prinzipien

Schemadefinition

  • Eingabevalidierung: Starke Typisierung, erforderliche vs. optionale Parameter
  • Ausgabekonsistenz: Standardisierte Antwortformate, Fehlerbehandlung
  • Dokumentation: Klare Beschreibungen, Nutzungsbeispiele, Randfälle
  • Versionierung: Abwärtskompatibilität, Migrationspfade

Fehlerbehandlungsmuster

  • Sanfte Verschlechterung: Teilfunktionalität bei Abhängigkeitsausfällen
  • Wiederholungslogik: Exponentielles Backoff, Leitungsunterbrecher, maximale Versuche
  • Fehlerweitergabe: Strukturierte Fehlerantworten, Fehlerklassifizierung
  • Wiederherstellungsstrategien: Fallback-Methoden, alternative Ansätze

Idempotenzanforderungen

  • Sichere Operationen: Leseoperationen ohne Seiteneffekte
  • Idempotente Schreiboperationen: Gleiche Operation kann sicher wiederholt werden
  • Zustandsverwaltung: Versionsnachverfolgung, Konfliktlösung
  • Atomarität: Alles-oder-Nichts-Abschluss der Operation

4. Kommunikationsmuster

Nachrichtenaustausch

  • Asynchrone Nachrichtenübermittlung: Entkoppelte Agenten, Nachrichtenwarteschlangen
  • Nachrichtenformat: Strukturierte Nutzlasten mit Metadaten
  • Liefergarantien: Mindestens einmal, exakt einmal Semantik
  • Routing: Direkte Nachrichtenübermittlung, Publish-Subscribe, Broadcast

Gemeinsamer Zustand

  • Zustandsspeicher: Zentrale Datenrepositorien
  • Konsistenzmodelle: Starke, eventual, schwache Konsistenz
  • Zugriffsmuster: Leselastig, schreiblästig, gemischte Workloads
  • Konfliktlösung: Letzter-Schreiber-gewinnt, Merge-Strategien

Ereignisgesteuerte Architektur

  • Ereignisquellen: Unveränderliche Ereignisprotokolle, Zustandsrekonstruktion
  • Ereignistypen: Domänenereignisse, Systemereignisse, Integrationsereignisse
  • Ereignisverarbeitung: Echtzeit, Stapel, Stream-Verarbeitung
  • Ereignisschema: Versionierte Ereignisformate, Abwärtskompatibilität

5. Sicherheitsvorkehrungen und -maßnahmen

Eingabevalidierung

  • Schema-Durchsetzung: Erforderliche Felder, Typüberprüfung, Formatvalidierung
  • Inhaltsfilterung: Erkennung schädlicher Inhalte, PII-Bereinigung
  • Ratenbegrenzung: Anforderungsdrosselung, Ressourcenkontingente
  • Authentifizierung: Identitätsüberprüfung, Autorisierungsprüfungen

Ausgabefilterung

  • Inhaltsmoderation: Entfernung schädlicher Inhalte, Qualitätsprüfungen
  • Konsistenzvalidierung: Logikprüfungen, Einschränkungsüberprüfung
  • Formatierung: Standardisierte Ausgabeformate, saubere Präsentation
  • Prüfprotokollierung: Entscheidungsprotokolle, Compliance-Aufzeichnungen

Mensch im Kreislauf

  • Genehmigungsworkflows: Kritische Entscheidungsprüfpunkte
  • Eskalationsauslöser: Konfidenzschwellenwerte, Risikobewertung
  • Übersteuerungsmechanismen: Menschenurteil hat Vorrang
  • Rückkopplungsschleifen: Menschliche Korrekturen verbessern das Systemverhalten

6. Bewertungsrahmen

Aufgabenerfüllungsmetriken

  • Erfolgsquote: Prozentsatz der erfolgreich abgeschlossenen Aufgaben
  • Teilerfüllung: Fortschrittsmessung für komplexe Aufgaben
  • Aufgabenklassifizierung: Erfolgskriterien nach Aufgabentyp
  • Fehleranalyse: Ursachenidentifikation und -kategorisierung

Qualitätsbewertung

  • Ausgabequalität: Genauigkeit, Relevanz, Vollständigkeitsmaße
  • Konsistenz: Antwortvariabilität über ähnliche Eingaben hinweg
  • Kohärenz: Logischer Fluss und interne Konsistenz
  • Benutzerzufriedenheit: Bewertungsergebnisse, Nutzungsmuster

Kostenanalyse

  • Token-Nutzung: Ein-/Ausgabe-Token-Verbrauch pro Aufgabe
  • API-Kosten: Nutzung und Gebühren externer Dienste
  • Rechenressourcen: CPU-, Arbeitsspeicher-, Speichernutzung
  • Time-to-Value: Kosten pro erfolgreichem Aufgabenabschluss

Latenzverteilung

  • Antwortzeit: Ende-zu-Ende-Aufgabenabschlusszeit
  • Verarbeitungsstufen: Engpassidentifikation pro Stufe
  • Wartezeiten: Wartezeiten in Verarbeitungspipelines
  • Ressourcenkonkurrenz: Auswirkungen paralleler Operationen

7. Orchestrierungsstrategien

Zentrale Orchestrierung

  • Workflow-Engine: Zentrale Koordinator verwaltet alle Agenten
  • Zustandsverwaltung: Zentralisierte Workflow-Zustandsverfolgung
  • Entscheidungslogik: Komplexe Routing- und Verzweigungsregeln
  • Überwachung: Umfassende Sicht auf alle Operationen

Dezentrale Orchestrierung

  • Peer-to-Peer: Agenten koordinieren sich direkt miteinander
  • Dienstentdeckung: Dynamische Agentenregistrierung und -suche
  • Konsensprotokolle: Verteilte Entscheidungsfindung
  • Fehlertoleranz: Kein einzelner Fehlerpunkt

Hybride Ansätze

  • Domänengrenzen: Zentralisiert innerhalb von Domänen, föderiert domänenübergreifend
  • Hierarchische Koordination: Mehrere Orchestrierungsebenen
  • Kontextabhängig: Strategieauswahl basierend auf Aufgabentyp
  • Lastverteilung: Verteilung der Koordinationsverantwortung

8. Speichermuster

Kurzzeitspeicher

  • Kontextfenster: Arbeitsgedächtnis für aktuelle Aufgaben
  • Sitzungszustand: Temporäre Daten für laufende Interaktionen
  • Cache-Verwaltung: Leistungsoptimierungsstrategien
  • Speicherdruck: Umgang mit Kapazitätsgrenzen

Langzeitspeicher

  • Dauerhafte Speicherung: Langlebige Daten über Sitzungen hinweg
  • Wissensbasis: Akkumuliertes Domänenwissen
  • Erfahrungswiedergabe: Lernen aus vergangenen Interaktionen
  • Speicherkonsolidierung: Übertragung von Kurzzeit- in Langzeitspeicher

Gemeinsamer Speicher

  • Kollaboratives Wissen: Gemeinsames Lernen über Agenten hinweg
  • Synchronisation: Strategien zur Konsistenzerhaltung
  • Zugriffskontrolle: Berechtigungsbasierter Speicherzugriff
  • Speicherpartitionierung: Isolation zwischen Agentengruppen

9. Skalierungsaspekte

Horizontale Skalierung

  • Agentenreplikation: Mehrere Instanzen desselben Agententyps
  • Lastverteilung: Anforderungsrouting über Agenteninstanzen hinweg
  • Ressourcenpooling: Gemeinsame Nutzung von Rechen- und Speicherressourcen
  • Geografische Verteilung: Mehrregionenbereitstellungen

Vertikale Skalierung

  • Fähigkeitserweiterung: Leistungsstärkere einzelne Agenten
  • Tool-Erweiterung: Breiterer Toolzugriff pro Agent
  • Kontexterweiterung: Größere Arbeitsgedächtniskapazität
  • Rechenleistung: Höherer Durchsatz pro Agent

Leistungsoptimierung

  • Caching-Strategien: Antwort-Caching, Tool-Ergebnis-Caching
  • Parallele Verarbeitung: Gleichzeitige Aufgabenausführung
  • Ressourcenoptimierung: Effiziente Ressourcennutzung
  • Engpassbeseitigung: Systematische Leistungsoptimierung

10. Fehlerbehandlung

Wiederholungsmechanismen

  • Exponentielles Backoff: Zunehmende Verzögerungen zwischen Wiederholungen
  • Jitter: Zufällige Verzögerungsvariationen zur Vermeidung von Herdenverhalten
  • Maximale Versuche: Begrenztes Wiederholungsverhalten
  • Wiederholungsbedingungen: Klassifizierung vorübergehender vs. dauerhafter Fehler

Fallback-Strategien

  • Sanfte Verschlechterung: Reduzierte Funktionalität bei Systemausfällen
  • Alternative Ansätze: Unterschiedliche Methoden für gleiche Ziele
  • Standardantworten: Sichere Fallback-Verhaltensweisen
  • Benutzerkommunikation: Klare Fehlermeldungen

Leitungsunterbrecher

  • Fehlererkennung: Überwachung von Fehlerraten und Antwortzeiten
  • Zustandsverwaltung: Offene, geschlossene, halboffene Leitungszustände
  • Wiederherstellungstests: Schrittweise Rückkehr zum Normalbetrieb
  • Kaskadierende Fehlerprävention: Schutz vorgelagerter Systeme

Implementierungsrichtlinien

Architekturentscheidungsprozess

  1. Anforderungsanalyse: Systemziele, Einschränkungen, Skalierung verstehen
  2. Musterauswahl: Geeignetes Architekturmuster auswählen
  3. Agentendesign: Rollen, Verantwortlichkeiten, Schnittstellen definieren
  4. Tool-Architektur: Tool-Schemata und Fehlerbehandlung entwerfen
  5. Kommunikationsdesign: Nachrichtenmuster und -protokolle auswählen
  6. Sicherheitsimplementierung: Schutzmaßnahmen und Validierung einbauen
  7. Bewertungsplanung: Erfolgsmetriken und Überwachung definieren
  8. Bereitstellungsstrategie: Skalierungs- und Fehlerbehandlung planen

Qualitätssicherung

  • Teststrategie: Unit-, Integrations- und Systemtestansätze
  • Überwachung: Echtzeit-Systemgesundheits- und Leistungsverfolgung
  • Dokumentation: Architekturdokumentation und Runbooks
  • Sicherheitsüberprüfung: Bedrohungsmodellierung und Sicherheitsbewertungen

Kontinuierliche Verbesserung

  • Leistungsüberwachung: Laufende Systemleistungsanalyse
  • Benutzerfeedback: Einbeziehung von Benutzererfahrungsverbesserungen
  • A/B-Tests: Kontrollierte Experimente für Systemverbesserungen
  • Wissensbasis-Updates: Kontinuierliches Lernen und Anpassen

Dieses Skill bietet die Grundlage für das Design robuster, skalierbarer Multi-Agenten-Systeme, die komplexe Aufgaben bewältigen können, während Sicherheit, Zuverlässigkeit und Leistung im großen Maßstab erhalten bleiben.

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".

Verwandte Skills