Kontextreferenzen — Präzise Zitate

Willkommen zurück zu unserer Hermes-Agent-Serie! Heute tauchen wir in etwas ein, das deinen Agenten deutlich nützlicher macht: Kontextreferenzen. Falls du dir je gewünscht hast, dass dein Agent genau darauf hinweisen kann, woher es Informationen hat – wie eine richtige wissenschaftliche Arbeit mit Zitaten –, dann ist dies das richtige Feature für dich.

Was sind Kontextreferenzen?

Stell dir Kontextreferenzen wie Fußnoten in einem Buch vor. Wenn dein Agent ein Dokument, ein Gespräch oder eine Datei verarbeitet, kann er sich jetzt merken, woher bestimmte Informationen stammen. Anstatt nur zu sagen „Der Himmel ist blau“, kann er sagen „Der Himmel ist blau (aus wetterbericht.md, Zeile 42).“

Das ist ein Game-Changer für:

• Recherche-Aufgaben — Quellen sofort verifizieren
• Code-Reviews — nachvollziehen, wo ein Bug eingeführt wurde
• Rechts- oder Compliance-Arbeit — belegen, woher eine Tatsache stammt
• Lange Gespräche — sich merken, welche Nachricht ein wichtiges Detail enthielt

Wie es funktioniert

Die Magie passiert im Hintergrund. Wenn du deinem Agenten Dokumente, Chat-Verläufe oder Dateien fütterst, verfolgt Hermes automatisch den Ursprung jedes Inhalts. Du musst nichts Besonderes tun – es funktioniert einfach.

Hier ist ein einfaches Beispiel:

hermes chat --with file:vertrag.pdf

Stell eine Frage wie „Wie lautet die Kündigungsklausel?“ und der Agent antwortet mit einem Zitat, das auf den genauen Abschnitt der PDF verweist.

Die neuen Konfigurationsoptionen

Das neueste Update bringt einige leistungsstarke neue Möglichkeiten, um zu steuern, wie sich Kontextreferenzen verhalten. Alle davon befinden sich in deiner ~/.hermes/config.yaml-Datei.

Aktivieren und Deaktivieren

Standardmäßig sind Kontextreferenzen für dateibasierte Inhalte aktiviert. Du kannst sie jedoch pro Sitzung steuern:

context_references:
  enabled: true              # Hauptschalter
  include_line_numbers: true # Zeilennummern zu Zitaten hinzufügen
  max_citations: 5           # Begrenzung der Referenzen pro Antwort

Zitatformate

Du kannst wählen, wie Zitate in Antworten erscheinen:

context_references:
  format: markdown  # Optionen: markdown, plain, json

• markdown — [Quelle: datei.md, Zeile 12] (rendert schön in Chat-Oberflächen)
• plain — (datei.md:12) (kompakt, gut für Terminals)
• json — strukturierte Ausgabe für programmatische Nutzung

Arbeiten mit Sitzungen

Kontextreferenzen glänzen in langlebigen Sitzungen. Der Agent merkt sich, welche Nachricht eine Tatsache eingeführt hat, sogar Stunden später:

hermes chat --session forschungsprojekt

Frag „Was haben wir vorhin über die Preisgestaltung gelernt?“ und erhalte ein Zitat, das auf die genaue Nachricht von vor zwei Stunden verweist.

Praktische Tipps

1. Verwende aussagekräftige Dateinamen

Das Zitat enthält den Dateinamen, also mach sie aussagekräftig:

hermes chat --with docs/Q3-Finanzbericht.md

Besser als datei1.txt, oder?

2. Kombiniere mit dem Gedächtnis

Kontextreferenzen funktionieren wunderbar mit dem Gedächtnissystem von Hermes. Wenn der Agent etwas in memories/ speichert, zeichnet er auch die Quelle auf. Später, wenn er sich an diese Erinnerung erinnert, kann er dir sagen, woher die Informationen ursprünglich stammen.

3. Überprüfe deine Konfiguration

Nach dem Aktualisieren von Hermes führe Folgendes aus:

hermes config check
hermes config migrate

Das stellt sicher, dass du alle neuesten Optionen zur Verfügung hast.

Ein kurzes Beispiel

Lass uns das in Aktion sehen:

hermes chat --with ~/notizen/meeting-notizen.md

Du: „Welche Aktionspunkte haben wir vereinbart?“

Agent: „Basierend auf den Meeting-Notizen hast du Folgendes vereinbart:

1. Das Q3-Budget finalisieren (aus meeting-notizen.md, Zeile 15)
2. Die Kunden-Demo planen (aus meeting-notizen.md, Zeile 22)
3. Den Projektzeitplan aktualisieren (aus meeting-notizen.md, Zeile 28)“

Siehst du, wie jeder Punkt sein eigenes Zitat hat? Das sind Kontextreferenzen bei der Arbeit.

Erinnerung an die Konfigurations-Priorität

Denke daran, Einstellungen werden in dieser Reihenfolge aufgelöst:

1. CLI-Argumente — höchste Priorität
2. config.yaml — deine Hauptkonfigurationsdatei
3. .env — nur für Geheimnisse
4. Integrierte Standardwerte — Fallback

Du kannst also Kontextreferenz-Einstellungen pro Befehl überschreiben:

hermes chat --with file:bericht.pdf --set context_references.format=plain

Zusammenfassung

Kontextreferenzen verwandeln deinen Agenten von einer „Black Box“ in einen transparenten, verifizierbaren Assistenten. Ob du recherchierst, Code debugst oder einfach deinen Agenten-Antworten mehr vertrauen möchtest – dieses Feature liefert dir die Belege.

Probier es mit deinen eigenen Dokumenten aus und sieh, wie viel selbstbewusster du dich fühlst, wenn jede Antwort mit einer Quelle kommt. Dein zukünftiges Ich – das versucht, sich zu erinnern, woher diese Tatsache stammt – wird es dir danken.

Viel Spaß beim Zitieren! 🎯