Zum Inhalt springen
GraphRAG Compass
  • Grundlagen
  • Architekturen
  • Praxis
  • Business Cases
  • Lernpfad
  • Simulation
  • Landkarte
GraphRAG Compass

Öffentlicher Field Guide für GraphRAG, Knowledge Graphs, AI-Architekturen und bessere Entscheidungen in komplexen Wissenssystemen.

Erkunden

  • Grundlagen
  • Architekturen
  • Praxis
  • Business Cases
  • Simulation
  • Landkarte

Lernen

  • Lernpfad
  • Mini-Use-Case
  • GraphRAG Poster
  • Glossar

Über

  • About
  • LinkedIn

Discovery

  • llms.txt
  • llms-full.txt
  • sitemap.xml

Rechtliches

  • Impressum
  • Datenschutz

© 2026 Meierhoff Systems · GraphRAG Compass

Orientierung für Entscheidungen in Wissenssystemen

Zurück zum Architekturmuster

Architektur-Detail · Agenten-Kontext

Context Graph Pipeline

Jeder Reasoning-Schritt eines Agenten wird als Knoten im Graphen gespeichert — mit Zeitstempel, Ausgangszustand, Entscheidung und Ergebnis. Kanten verbinden Entscheidungsschritte zu nachvollziehbaren Kausalketten. Für regulierte Branchen ist das oft eine Voraussetzung, nicht ein Nice-to-have.

Fortgeschritten
Aufwand: hoch
Datenreife: hoch
Team-Reife: hoch

Kuratierte Architekturentscheidung auf Basis der lokalen Compass-Daten

Relevant wenn

Wenn Agenten-Handlungen auditierbar sein müssen, regulatorische Anforderungen bestehen oder Entscheidungen über Zeit rekonstruierbar sein sollen.

Quellenlage

Compass-Komposition aus realen Bausteinen: LangGraph-State, Tracing, Graphiti/Zep-Kontextgraphen und Auditierbarkeit. Der Name ist ein Compass-Begriff, kein offizieller Standard.

Welches Problem löst das Muster?

Agenten-Handlungen, Reasoning-Schritte und Entscheidungen sollen nachvollziehbar, auditierbar und persistent sein.

Systemkarte

Wie der Architekturfluss aussieht

Die Motion Map verdichtet das Muster auf seine wichtigsten Stationen: Eingabe, Daten- oder Graphschicht, Retrieval, Kontrolle und Antwort. Sie ist bewusst kleiner als die Referenzarchitektur darunter und soll zuerst die Leserichtung und die Systemgrenzen sichtbar machen.

Motion Map

Context Graph

Ziel
Quellen
Claims
Zustand
Agent
Entscheid

Der Graph hält den aktuellen Arbeitszustand, nicht die ganze Welt.

Architekturblick

Was du bauen, betreiben und messen musst

Diese Seite ist eine Entscheidungshilfe für den Stack. Der Blick liegt auf Datenfluss, Failure Modes, Evaluation, Tooling und dem nächsten sinnvollen Migrationsschritt.

Stack-Schnitt

Workflow StateSource NodesClaim NodesTool TraceDecision NodesOpen QuestionsAudit Export

Runtime-Datenfluss

Während einer Aufgabe werden Ziele, Quellen, Claims, Tool-Ergebnisse, Entscheidungen und offene Fragen als Arbeitsgraph gepflegt. Der Graph steuert nächste Schritte und macht Herleitung sichtbar.

Migrationspfad

Mit Task Graph für einzelne Arbeitsschritte starten, dann Tool Traces, Decision Graph und auditierbare Übergaben ergänzen.

Failure Modes

  • Der Graph wird zum ungefilterten Log.
  • Claims und Quellen werden vermischt.
  • Lebensdauer und Archivierung bleiben ungeklärt.

Evaluation

  • Prüfen, ob offene Fragen wirklich weniger übersehen werden.
  • Claim-Evidenz und Entscheidungsherleitung testen.
  • Tool-Trace-Vollständigkeit messen.

Tooling & Betrieb

  • LangGraph State
  • Graphiti oder Neo4j
  • Tracing
  • Workflow Store
  • Review UI

Referenzarchitektur

Wie eine Context Graph Pipeline arbeitet

Ein Context Graph beschreibt den aktuellen Arbeitszustand eines Agenten oder Workflows. Anders als Agent Memory ist er ein strukturierter Zwischenstand: Ziel, Quellen, Claims, Tool-Ergebnisse, Entscheidungen und offene Fragen bleiben explizit sichtbar.

  1. 01

    Aufgabe initialisieren

    Ein Ziel, eine Frage, ein Nutzerauftrag oder ein Workflow startet den Context Graph. Der Graph beschreibt den aktuellen Arbeitszustand.

  2. 02

    Kontextobjekte anlegen

    Quellen, Claims, Annahmen, offene Fragen, Entscheidungen, Tool-Ergebnisse und Zwischenergebnisse werden als eigene Knoten sichtbar.

  3. 03

    Beziehungen schreiben

    Kanten zeigen, welche Quelle welchen Claim stützt, welche Entscheidung aus welcher Analyse folgt und welche Frage noch offen ist.

  4. 04

    Agentenarbeit steuern

    Der Agent nutzt den Context Graph, um nächste Schritte zu planen, Lücken zu erkennen und nicht dieselbe Arbeit mehrfach zu tun.

  5. 05

    Zustand aktualisieren

    Neue Beobachtungen, Tool-Antworten, Nutzerkorrekturen und Entscheidungen verändern den Graph während der Aufgabe.

  6. 06

    Ergebnis auditieren

    Am Ende bleibt nachvollziehbar, welche Quellen, Zwischenschritte und Entscheidungen zur Antwort geführt haben.

Aufwand
hoch

Implementierungs-, Integrations- und Betriebsaufwand.

Datenreife
hoch

Qualität, Struktur und Zugänglichkeit der Daten vor dem Pilot.

Team-Reife
hoch

Erfahrung mit RAG, Graphdenken, Infrastruktur und Evaluation.

Nicht ideal wenn

Tracing, Archivierung und Löschkonzepte noch nicht geklärt sind.

Trade-offs

Audit-Graphen wachsen schnell — Archivierungs- und Pruning-Strategien müssen von Anfang an mitgeplant werden. Jeder Reasoning-Schritt kostet zusätzliche Schreib-Latenz. Debugging komplexer Kausalketten erfordert spezialisiertes Graph-Tooling.

Graphmodell

Welche Knoten im Context Graph liegen

Der Context Graph wird nützlich, wenn Arbeitszustände typisiert werden. Dann kann ein Agent gezielt fragen: Welche Claims sind belegt? Welche Quellen fehlen? Welche Entscheidungen wurden schon getroffen?

Goal

Das Ziel oder die Leitfrage des Arbeitsprozesses. Ohne Goal wird der Graph schnell nur ein Log.

Source

Dokument, API-Antwort, Datenbankauszug, Mail, Ticket oder Webseite, aus der Kontext stammt.

Claim

Eine prüfbare Aussage, die aus Quellen oder Tool-Ergebnissen abgeleitet wurde.

Decision

Eine getroffene Entscheidung inklusive Begründung, Alternativen und verantwortlichem Schritt.

OpenQuestion

Eine Lücke im Kontext, die noch recherchiert, geklärt oder vom Nutzer beantwortet werden muss.

ToolResult

Ein konkretes Ergebnis eines Tools, inklusive Parameter, Zeitpunkt, Status und möglicher Fehler.

Qualitätshebel

Wo Context Graphs schwierig werden

Context Graphs können Agentenarbeit transparent machen, aber auch sehr schnell unübersichtlich werden. Die Architektur muss entscheiden, was wirklich als Zustand zählt und wie lange dieser Zustand lebt.

Graph nicht zum Log verkommen lassen

Wenn jeder Zwischenschritt ungefiltert gespeichert wird, entsteht Rauschen. Der Graph braucht klare Typen und Speicherkriterien.

Claims von Quellen trennen

Eine Quelle ist nicht automatisch eine Wahrheit. Claims sollten explizit mit Evidenz, Unsicherheit und Herkunft verbunden werden.

Offene Fragen sichtbar halten

Ein Context Graph ist besonders nützlich, wenn er Wissen speichert und zeigt, was noch unklar ist.

Lebensdauer begrenzen

Context Graphs sind oft auf Aufgaben oder Fälle bezogen. Ohne Archivierungs- und Löschstrategie werden sie zu unkontrolliertem Memory.

Stack-Komponenten

Neo4jGraphitiLangGraphZeitstempel-KantenAudit-API

Ausbaustufen

Vom Task Graph zum auditierbaren Workflow

Der Context Graph kann klein starten: ein Ziel, ein paar Quellen, Claims und offene Fragen. Erst wenn dieser Arbeitszustand nützlich ist, lohnt sich der Ausbau zu Tool-Traces, Entscheidungsgraphen und auditierbaren Workflows.

  1. Stufe 1

    Starte mit Ziel, Quellen, Claims und offenen Fragen für eine einzelne Aufgabe.

  2. Stufe 2

    Ergänze Tool-Aufrufe, Parameter, Ergebnisse und Fehler, damit Agentenarbeit nachvollziehbar wird.

  3. Stufe 3

    Modelliere Entscheidungen, Begründungen, Alternativen und Auswirkungen über mehrere Schritte.

  4. Stufe 4

    Ergänze Rollen, Aufbewahrung, Review, Export und Verbindung zu Agent Memory oder Governance.

Konkrete Beispiele

In welchem Kontext das Muster typischerweise Sinn ergibt und welchen Beitrag es dort leistet.

Agenten-Run dokumentieren

Ein Agent recherchiert, filtert Quellen und erstellt eine Empfehlung.

Der Context Graph hält Zwischenschritte und Kontextzustände fest.

Projektlage aktualisieren

Risiken, Entscheidungen und Verantwortlichkeiten ändern sich fortlaufend.

Die Pipeline aktualisiert Kontext, Verlauf und neue Textchunks gemeinsam.

Einsteigerbeispiel: Analyseauftrag

Ein Agent soll Tools und Plattformen für GraphRAG vergleichen. Während der Arbeit entstehen Quellen, Claims, offene Fragen, Zwischenentscheidungen und ausgeschlossene Optionen.

Der Context Graph hält diesen Arbeitszustand fest, damit später nachvollziehbar bleibt, warum eine Empfehlung entstanden ist.

Nächste Umsetzungsschritte

  1. 1

    Audit-Ereignisse modellieren

  2. 2

    Aufbewahrungsregeln festlegen

  3. 3

    Tracing vor autonomen Aktionen einführen

Verwandte Konzepte, Tools und Plattformen

Context GraphsAgent MemoryGraphiti / ZepMCP & A2A
Vorheriges ThemaAgent Memory StackNächstes ThemaMCP Graph-Backend