Zum Inhalt springen

Das agentix-Muster

Anwendungsarchitektur legt fest, wie Code aufgebaut ist. Agentenarchitektur legt fest, wer zur Laufzeit was tun darf, wenn ein Modell den nächsten Schritt wählt. Beide treffen sich am MCP-Server: in der einen Sicht ein Adapter, in der anderen eine Fähigkeitsgrenze. Das agentix-Muster ist die Form, um die open-agentix für die zweite Frage gebaut ist.

Agentenarchitektur und Anwendungsarchitektur treffen sich am MCP-ServerOberes Band: Agentenarchitektur, entschieden zur Laufzeit; Agenten, einer pro Schritt, rufen Werkzeuge über ein Policy-Gate mit Audit auf. Unteres Band: Anwendungsarchitektur, entschieden zur Entwurfszeit; jedes System hat seine eigenen Schichten. Die MCP-Server liegen auf der Linie zwischen den Bändern: in der Anwendungssicht ein Adapter, in der Agentensicht eine Fähigkeitsgrenze.Agentenarchitektur: wer darf was, zur LaufzeitFähigkeiten, Wirkungsradius, Freigaben, Übergaben, KostenAgenten, einer pro SchrittPolicy-Gate + Auditjira-MCPcrm-MCPMCP-Server: Adapter (App-Sicht)und Fähigkeitsgrenze (Agent)JiraAPI / PortDomäneDatenCRMAPI / PortDomäneDatenAnwendungsarchitektur: wie Code gebaut ist, zur EntwurfszeitSchichten, Services, Datenhoheit, Deploy-Einheiten
Zwei Fragen, die senkrecht zueinander stehen. Sie treffen sich am MCP-Server.

Jedes System, das ein Agent berühren darf, liegt hinter genau einem MCP-Server. Dieser hält die Zugangsdaten und bietet die Fähigkeiten des Systems als typisierte Werkzeuge an, getrennt nach Lesen und Schreiben. Jeder Geschäftsprozess ist ein versionierter Plan aus Schritten; jeden Schritt führt ein eigener, eng begrenzter Agent aus, der nur die Werkzeuge seines Schritts hält, ein typisiertes Ergebnis übergibt und jedes System nur über ein deterministisches Policy-Gate erreicht, das jede Entscheidung unter der Run-ID festhält.

Antimuster und agentix-Muster im VergleichOben: Ein Agent mit allen Werkzeugen spricht mit einem Alles-Könner-MCP-Server, der die Zugangsdaten von zehn Anwendungen hält. Unten: das agentix-Muster. Drei Agenten, einer pro Schritt (Research liest, Analyse hat keine Werkzeuge, Action schreibt genau eine Sache), erreichen Systeme nur über ein Policy-Gate mit Audit, und jedes System liegt hinter einem eigenen MCP-Server; den Git-Server bekommt kein Schritt.Antimuster: ein Gott-Agent, ein Alles-Könner-MCP-Serverein Agent, alle Werkzeugeein MCP-Server, zehn Apps, alle ZugangsdatenApp 1App 2App 3App 4App 5App 6App 7App 8App 9App 10agentix-Muster: ein Agent pro Schritt, ein MCP-Server pro Systemresearchliest jira, crmanalysisnur Modellactionjira: issue.createPolicy-Gate (erlauben / ablehnen / Freigabe) + Audit, Run-IDjira-MCPcrm-MCPgit-MCPnicht freigegeben
Oben ein Agent und ein MCP-Server für alles. Unten das agentix-Muster: ein Agent pro Schritt, ein MCP-Server pro System, dazwischen ein Gate.
RegelIn einem Satz
R1Ein MCP-Server pro System oder Bounded Context, die einzige Tür dorthin. Typisierte Werkzeuge, Lesen und Schreiben getrennt, Zugangsdaten nur dort. Unterschiedliche Risikoklassen: getrennte Werkzeugsätze und Policy pro Werkzeug.
R2Ein Prozess wird zu 1..n Agenten, standardmäßig einer pro Schritt. Trennen, wenn sich Risiko, Datenklasse, Rechte, Modell, Fehlerbehandlung, Kosten oder Freigabe unterscheiden; zusammenlassen, wenn Schritte Kontext und Rechte teilen. Kein Gott-Agent.
R3Agenten erreichen Systeme nie direkt: Jeder Werkzeugaufruf läuft durch das Policy-Gate und in den Audit-Trail.
R4Übergaben sind ausdrücklich, per Schema typisiert und knapp, kein gemeinsamer Speicher und kein freier Chat zwischen Agenten.
R5Orchestrierung ist Daten: ein versionierter Plan, kein allwissender Orchestrator-Agent.
R6Budgets, Grenzen und Identität pro Agent.
R7Alles ist über Run-ID und Agenten-ID nachvollziehbar.
Durchgerechnetes Beispiel: Ticket-TriageEin Ereignis startet den Research-Agenten, der nur Lesewerkzeuge der MCP-Server für Jira und CRM aufrufen darf. Er übergibt typisierte Befunde an den Analyse-Agenten, der keine Werkzeuge hat. Dieser übergibt eine typisierte Entscheidung an den Action-Agenten, der genau ein Schreibwerkzeug aufrufen darf, issue.create am Jira-MCP-Server, und das erst nach Freigabe durch einen Menschen. Jeder Aufruf läuft durch das Policy-Gate und wird protokolliert.Ereignis: ticket.createdresearchliest nuranalysisnur Modell, keine Werkzeugeactionschreibt nach Freigabefindings.jsondecision.jsonPolicy-Gate + Auditjira-MCP-Serverlesenissue.getlesenissue.searchschreibenissue.createcrm-MCP-Serverlesencustomer.getschreibencustomer.updateFreigabe durch einen Menschen vor dem Aufrufjeder Aufruf an einen MCP-Server läuft durch das Gate und ins Audit (Run-ID)
Lesen und Schreiben sind getrennte Werkzeuge. Nur der Action-Schritt darf schreiben, einmal, nach Freigabe.

Gott-Agent, ein Alles-Könner-MCP-Server für viele Systeme, ein MCP-Server pro Endpunkt, geteilte Zugangsdaten, freier Chat zwischen Agenten, ein Orchestrator-Agent mit allen Werkzeugen und Policy, die im Prompt steht.

Verfügbar in 0.1 Pipelines aus 1..n Agenten in agents.md mit Werkzeugen, Argumentregeln, Freigaben, Modell und Budget pro Agent; das deterministische Policy-Gate; der verkettete Audit-Trail; Schritte und Kosten pro Lauf und Agent.

Roadmap Schemaprüfung von Übergaben (heute wird die vorige Ausgabe als Text weitergereicht, format: json wird geparst, aber nicht geprüft), bedingte Planschritte, benannte Lese- und Schreibprofile pro MCP-Server, Zugangsdaten pro Lauf und isolierte Worker (v0.2) sowie Agent Check und die Erzeugung von Agent Plans (beratend). Siehe die Roadmap.

Abgerufen am 4. Oktober 2026. Das Muster ist unsere eigene Synthese. Es ist mit diesen Seiten vereinbar, die es nicht vorschreiben: MCP-Server stellen „specific capabilities“ bereit, und jedes Werkzeug führt „a single operation“ aus; Subagenten bekommen über eine tools-Allowlist „specific tool access“. Typisierte Übergaben (R4) und Pläne statt eines orchestrierenden Agenten (R5) gehen über diese Quellen hinaus.

Begründung, ein durchgerechnetes Beispiel und die Abwägungen stehen im Blogbeitrag Agentenarchitektur ist keine Anwendungsarchitektur.