KI-Integrations-Guide

jinflow verwendet Claude (Anthropic) fuer zwei verschiedene Faehigkeiten: interaktive Analyse und Finding-Erklaerungen.

Einrichtung

# API-Key setzen (einmalig, gespeichert in ~/.jinflow/secrets.yml)
jin us --api-key sk-ant-api03-...

# Oder ueber Umgebungsvariable
export ANTHROPIC_API_KEY=sk-ant-api03-...

Beide Features teilen denselben API-Key. Keine weitere Konfiguration noetig.

Zwei KI-Modi

1. Evolve (Interaktive Analyse)

jin evolve ist ein konversationelles REPL fuer KI-gestuetzte Datenexploration. Die KI hat vollen Zugriff auf den KLS, kann SQL schreiben, Signals inspizieren und bei der Untersuchung von Findings helfen.

Aspekt	Detail
Befehl	jin evolve --tenant millesime.domaine_zufferey
Modell	Claude Opus oder Sonnet (konfigurierbar via jin us --model)
Kontext	Mehrstufige Konversation mit Datenzugang
Kosten	~$0.10–0.50 pro Konversation
Anwendung	Tiefe Untersuchung, Thesis-Exploration, Signal-Design

Die KI ist auf genau einen Tenant beschraenkt — sie kann nicht ueber Tenant-Schemas hinweg abfragen.

2. Finding Explainer (Einzelanfrage)

Der “Im Detail erklaeren”-Button auf Finding-Detailseiten generiert ein CFO-taugliches Narrativ aus der Evidenz eines einzelnen Findings.

Aspekt	Detail
Ausloeser	Klick auf “Im Detail erklaeren” bei jedem Finding
Modell	Claude Haiku (schnell, ~1-2 Sekunden)
Ueberschreibung	JINFLOW_AI_MODEL Umgebungsvariable
Kontext	Einzelnes Finding + Entity-Attribute + Signal-Metadaten
Kosten	~$0.01 pro Erklaerung
Anwendung	Schnelles Narrativ fuer Praesentationen, Audits, Berichte

Der Explainer reichert das Finding mit Entity-Attributen aus Gold und Signal-Metadaten aus der Registry an, bevor der Prompt erstellt wird. Die Antwort wird als Markdown gerendert.

Modellauswahl

Feature	Standard-Modell	Ueberschreibung
Evolve	Konfiguriert via jin us --model	Pro Sitzung
Finding Explainer	claude-haiku-4-5-20251001	JINFLOW_AI_MODEL Umgebungsvariable
Guide-Uebersetzung	claude-haiku-4-5-20251001	JINFLOW_AI_MODEL Umgebungsvariable

Datenschutz

• Die KI sieht nur die Daten, die du sendest — Finding-Evidenz, Entity-Attribute, Signal-Metadaten
• Evolve ist auf einen Tenant beschraenkt (durchgesetzt durch das REPL)
• Keine Daten werden von Anthropic gespeichert (API-Nutzung, kein Training)
• Der API-Key wird lokal in ~/.jinflow/secrets.yml gespeichert (nie im Repository)

Guide-Uebersetzung

scripts/translate_guides.py verwendet Claude um Guide-Markdown-Dateien von Englisch nach Deutsch und Franzoesisch zu uebersetzen. Dies laeuft als Build-Schritt, nicht zur Laufzeit.

python3 scripts/translate_guides.py           # geaenderte Guides uebersetzen
python3 scripts/translate_guides.py --check   # Trockenlauf
python3 scripts/translate_guides.py --force   # alles neu uebersetzen

Uebersetzungen werden via SHA-256-Manifest gecacht — unveraenderte Quelldateien werden uebersprungen.