2.2 KiB
Architektur und Vertrauensgrenzen
Agent knowledge/ ──ro──┐
Agent runs.jsonl ──ro──┼──► Ingest ─► Graph + Vectors ─► Retrieval/Inference ─► SSE/Web UI
KB staging/ ──────rw───┘ │
├──► AI Edge (staging)
├──► optional SearXNG evidence
└──► AI-THINK JSON in staging
Edge-Klassen
categorized_as,mentions,derived_from: deterministisch aus JSON.research_evidence: aus einer explizit gestarteten Recherche, weiterhinstaging.related_to,depends_on,supports,contradicts,extends,same_topic,caused_by: Qwen-Inferenz mit Confidence und Evidence.rejected: intern gespeicherte Prüfung ohne sichtbare Beziehung; verhindert Endlosschleifen.
Ereignismodell
Activity ist von der Graph-Persistenz getrennt. Eine Anfrage verändert deshalb nicht automatisch die Wissensbasis. Erst der sequenzielle Enrichment-Schritt darf eine neue Edge oder einen AI-THINK-Entwurf anlegen.
Datenhoheit
Produktive JSON-Dateien werden niemals verändert. Der einzige schreibende Fremdpfad ist das explizit konfigurierte Staging-Verzeichnis. Alle Dateien werden atomar über Temporärdatei und Rename geschrieben.
Hierarchische Render-Schicht
Der persistierte Wissensgraph bleibt unverändert vollständig. Das Frontend leitet daraus eine temporäre, hierarchische Render-Schicht ab:
Full Graph
└── Cortex-Region
└── Themenwolke (LOD 2)
└── lokale Gruppe (LOD 1)
└── einzelner Wissensknoten (LOD 0)
Die sichtbare Ebene wird durch Zoom, Fokus und Aktivitätszeiten bestimmt. Außenkanten werden nach sichtbaren Endpunkten, Relationstyp, Richtung, Herkunft und Status aggregiert. Eine Aktivierung öffnet ausschließlich den betroffenen Pfad der Hierarchie; nach Ablauf der Offenhaltezeit wird dieser wieder verdichtet. Die KI-, Retrieval- und Persistenzlogik arbeitet weiterhin ausschließlich mit den echten Node- und Edge-IDs.