Guide d'intégration IA

jinflow utilise Claude (Anthropic) pour deux capacités distinctes : l’analyse interactive et les explications de findings.

Configuration

# Set API key (one-time, stored in ~/.jinflow/secrets.yml)
jin us --api-key sk-ant-api03-...

# Or via environment variable
export ANTHROPIC_API_KEY=sk-ant-api03-...

Les deux fonctionnalités partagent la même clé API. Aucune autre configuration n’est requise.

Deux modes IA

1. Evolve (analyse interactive)

jin evolve est un REPL conversationnel pour l’exploration de données assistée par IA. L’IA a un accès complet au KLS, peut écrire du SQL, inspecter les Signals et aider à investiguer les findings.

Aspect	Détail
Commande	jin evolve --tenant millesime.domaine_zufferey
Modèle	Claude Opus ou Sonnet (configurable via jin us --model)
Contexte	Conversation multi-tours avec accès aux données
Coût	~$0.10–0.50 par conversation
Cas d’usage	Investigation approfondie, exploration de Thesis, conception de Signal

L’IA est limitée à exactement un tenant — elle ne peut pas interroger d’autres schémas tenant.

2. Finding Explainer (one-shot)

Le bouton « Explain in detail » sur les pages de détail des findings génère un narratif prêt pour la direction financière à partir des preuves d’un seul Finding.

Aspect	Détail
Déclencheur	Cliquer « Explain in detail » sur n’importe quel Finding
Modèle	Claude Haiku (rapide, ~1-2 secondes)
Override	Variable d’environnement JINFLOW_AI_MODEL
Contexte	Finding unique + attributs Entity + métadonnées Signal
Coût	~$0.01 par explication
Cas d’usage	Narratif rapide pour présentations, audits, rapports

L’explainer enrichit le Finding avec les attributs Entity depuis Gold et les métadonnées Signal depuis le registre avant de construire le prompt. La réponse est rendue en Markdown.

Sélection du modèle

Fonctionnalité	Modèle par défaut	Override
Evolve	Configuré via jin us --model	Par session
Finding Explainer	claude-haiku-4-5-20251001	Variable d’env JINFLOW_AI_MODEL
Traduction des guides	claude-haiku-4-5-20251001	Variable d’env JINFLOW_AI_MODEL

Confidentialité

• L’IA ne voit que les données que vous lui envoyez — preuves de Finding, attributs Entity, métadonnées Signal
• Evolve est limité à un tenant (imposé par le REPL)
• Aucune donnée n’est stockée par Anthropic (utilisation API, pas d’entraînement)
• La clé API est stockée localement dans ~/.jinflow/secrets.yml (jamais dans le dépôt)

Traduction des guides

scripts/translate_guides.py utilise Claude pour traduire les fichiers markdown de guides de l’anglais vers l’allemand et le français. Cela s’exécute comme étape de build, pas à l’exécution.

python3 scripts/translate_guides.py           # translate changed guides
python3 scripts/translate_guides.py --check   # dry-run
python3 scripts/translate_guides.py --force   # retranslate everything

Les traductions sont cachées via un manifeste SHA-256 — les fichiers source inchangés sont ignorés.