---
type: Blog Post
title: "Agents IA dans le Secteur Financier : Le Guide Pratique d'Implémentation"
description: "Agents IA dans le Secteur Financier : Le Guide Pratique d'Implémentation. Un guide pratique complet pour l'implémentation d'agents IA dans le secteur..."
resource: "https://www.contextstudios.ai/fr/blog/agents-ia-dans-le-secteur-financier-le-guide-pratique-dimplmentation"
tags: [Agents IA, Finance, Implémentation, Python, MCP]
language: fr
timestamp: "2026-05-31T12:51:41.983Z"
---

# Agents IA dans le Secteur Financier : Le Guide Pratique d'Implémentation

Agents IA dans le secteur financier : Le guide pratique d'implémentation

De l'architecture au code prêt pour la production – avec des évaluations honnêtes

---

À qui s'adresse ce guide ?

Ce guide s'adresse aux développeurs et professionnels de la finance techniquement avertis qui souhaitent non seulement comprendre les agents IA, mais aussi les construire eux-mêmes. Vous y trouverez :

- Décisions d'architecture avec justifications
- Exemples de code complets à adapter
- Définitions de skills au format YAML
- Workflows Multi-Agent avec patterns de coordination
- Patterns de Context Engineering pour des résultats fiables
- Évaluations honnêtes des limites et des risques

Chaque cas d'usage suit la même structure : Problème → Architecture → Skill → Implémentation → Évaluation → Évaluation honnête.

---

Partie 1 : Fondamentaux et patterns d'architecture

Avant d'aborder les cas d'usage, nous devons comprendre les composants de base.

Qu'est-ce qui définit un agent ?

Un agent se distingue d'un chatbot par sa capacité à agir de manière autonome :

Les cinq patterns d'architecture

| Pattern | Description | Complexité | Meilleure utilisation |
|---------|-------------|------------|----------------------|
| ReAct | Penser → Agir → Observer → Répéter | Basse | Tâches uniques avec objectif clair |
| Plan-Execute | D'abord planifier, puis exécuter les étapes | Moyenne | Processus à plusieurs étapes |
| Multi-Agent | Agents spécialisés avec handoffs | Moyenne-Haute | Différentes expertises |
| Supervisor | Coordinateur distribue le travail en parallèle | Haute | Analyses critiques en termes de temps |
| Human-in-Loop | L'agent pause pour approbation humaine | Variable | Décisions critiques |

Context Engineering : La clé des agents fiables

Le concept le plus important pour les agents prêts pour la production est le Context Engineering – la conception systématique de ce que l'agent "voit".

MCP Server : L'infrastructure pour les tools

Le Model Context Protocol (MCP) standardise la façon dont les agents communiquent avec les systèmes externes.

---

Cas d'utilisation 1 : Analyse des Earnings Calls

Le problème en détail

Les Earnings Calls contiennent des informations critiques, mais :
- Plus de 50 pages de transcription par appel
- Les éléments importants sont cachés entre des formules standard
- Changements subtils dans les prévisions ou le ton
- Pression temporelle : tout le monde analyse en même temps

L'architecture : ReAct avec des outils spécialisés

Le Skill : earnings-analyzer

Phase 1 : SEGMENTATION
├── Input : Transcription complète
├── Action : segment_transcript()
└── Output : {prepared_remarks, qa_section, participants}

Phase 2 : EXTRACTION DES KPI
├── Input : prepared_remarks
├── Action : extract_kpis(metrics=["revenue", "eps", "margin", "guidance"])
└── Output : {metric: {value, yoy_change, source_quote, timestamp}}

Phase 3 : COMPARAISON DE LA GUIDANCE (si trimestre précédent disponible)
├── Input : current_guidance, prior_guidance
├── Action : compare_guidance()
└── Output : {metric: {direction, magnitude, explanation_given}}

Phase 4 : ANALYSE DU TON
├── Input : qa_section
├── Action : analyze_tone()
├── Sub-Actions :
│   ├── detect_hedging() → Langage de couverture
│   ├── count_deflections() → Réponses évasives
│   └── sentiment_shift() → Changement de sentiment
└── Output : {overall_tone, confidence_level, evidence[]}

Phase 5 : DÉTECTION DES RED FLAGS
├── Input : Tous les résultats précédents
├── Action : categorize_red_flags()
└── Output : [{type, severity, description, citation}]

Phase 6 : SYNTHÈSE
├── Input : Outputs de toutes les phases
├── Action : generate_summary()
└── Output : Résumé exécutif (max 200 mots)
json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": ["company", "quarter", "kpis", "executive_summary"],
  "properties": {
    "company": {"type": "string"},
    "quarter": {"type": "string", "pattern": "^Q[1-4] \\d{4}$"},
    "analysis_timestamp": {"type": "string", "format": "date-time"},

    "kpis": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "required": ["value", "source"],
        "properties": {
          "value": {"type": ["number", "string"]},
          "unit": {"type": "string"},
          "yoy_change": {"type": "string"},
          "qoq_change": {"type": "string"},
          "vs_consensus": {"type": "string"},
          "source": {"type": "string", "description": "Citation avec timestamp"}
        }
      }
    },

    "guidance": {
      "type": "object",
      "properties": {
        "current": {"type": "object"},
        "prior": {"type": "object"},
        "changes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "metric": {"type": "string"},
              "direction": {"enum": ["raised", "lowered", "maintained", "withdrawn"]},
              "magnitude": {"type": "string"},
              "management_explanation": {"type": "string"}
            }
          }
        }
      }
    },

    "tone_analysis": {
      "type": "object",
      "properties": {
        "overall": {"enum": ["confident", "neutral", "cautious", "defensive"]},
        "hedging_score": {"type": "number", "minimum": 0, "maximum": 1},
        "deflection_count": {"type": "integer"},
        "key_quotes": {"type": "array", "items": {"type": "string"}}
      }
    },

    "red_flags": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["type", "severity", "description"],
        "properties": {
          "type": {"enum": ["guidance_cut", "tone_shift", "analyst_concern",
                           "inconsistency", "evasion", "accounting_flag"]},
          "severity": {"enum": ["low", "medium", "high", "critical"]},
          "description": {"type": "string"},
          "citation": {"type": "string"},
          "prior_context": {"type": "string"}
        }
      }
    },

    "executive_summary": {
      "type": "string",
      "maxLength": 1500
    }
  }
}

Severity : CRITICAL
- Retrait de guidance > 10%
- Changement d'auditeur mentionné
- Material Weakness

Severity : HIGH
- Baisse de guidance 5-10%
- Changement de CFO
- "Challenging environment" > 3x

Severity : MEDIUM
- Réponses évasives aux questions directes
- Augmentation du Hedging > 50% vs trimestre précédent

Severity : LOW
- Guidance inchangée malgré un environnement modifié
- Questions de suivi des analystes sur le même sujet > 2

Analyse l'Earnings Call Q3 2025 de TechCorp.
Focus sur : Cloud Revenue, évolution des marges, Guidance 2026.
La transcription du trimestre précédent est jointe.
json
{
  "company": "TechCorp Inc.",
  "quarter": "Q3 2025",
  "kpis": {
    "cloud_revenue": {
      "value": 8.2,
      "unit": "billion USD",
      "yoy_change": "+23%",
      "vs_consensus": "+2%",
      "source": "[14:23] CEO: 'Cloud revenue reached 8.2 billion...'"
    },
    "operating_margin": {
      "value": 34.5,
      "unit": "percent",
      "yoy_change": "-150bps",
      "source": "[18:45] CFO: 'Operating margin of 34.5 percent...'"
    }
  },
  "guidance": {
    "changes": [
      {
        "metric": "FY2026 Revenue",
        "direction": "lowered",
        "magnitude": "from $38-40B to $36-38B",
        "management_explanation": "Macro uncertainty in enterprise spending"
      }
    ]
  },
  "tone_analysis": {
    "overall": "cautious",
    "hedging_score": 0.67,
    "deflection_count": 3,
    "key_quotes": [
      "[Q&A 12:34] 'We're being prudent given the environment'",
      "[Q&A 23:45] 'It's difficult to predict with certainty'"
    ]
  },
  "red_flags": [
    {
      "type": "guidance_cut",
      "severity": "high",
      "description": "Guidance Revenue FY2026 abaissée de 5%",
      "citation": "[19:23] CFO revises full-year outlook",
      "prior_context": "En Q2, la guidance avait été confirmée"
    }
  ],
  "executive_summary": "TechCorp a livré de solides résultats Q3 avec une croissance Cloud au-dessus des attentes (+23% YoY). Cependant, la guidance FY2026 a été abaissée de 5%, justifiée par l'incertitude macro. Le ton dans le Q&A était plus défensif qu'en Q2, avec un Hedging accru sur les questions de demande Enterprise. Pression sur les marges due aux investissements dans l'infrastructure AI. Point clé à surveiller : conversion du pipeline en Q4."
}

L'implémentation

transcript
{transcript[:35000]}
prior_transcript
{prior[:15000]}

Évaluation et Monitoring

Évaluation honnête

Ce qui fonctionne (avec chiffres) :
- Extraction des KPI : ~85% de précision pour les calls structurés
- Détection de la guidance : ~90% quand explicitement mentionnée
- Gain de temps : 70% pour l'analyse initiale

Ce qui ne fonctionne pas :
- Ironie subtile : 0% - non détectée
- Changements de guidance implicites : ~30% de rappel
- Nuances spécifiques au secteur : fortement dépendant de l'entraînement

Quand NE PAS utiliser :
- Comme seule base de décision
- Pour des entreprises avec des calls non structurés
- Sans validation humaine des Red Flags

---

Cas d'Usage 2 : Due Diligence M&A

Le Problème en Détail

Due Diligence pour les acquisitions d'entreprises :
- Des milliers de documents dans la data room
- Formats variés (PDF, Excel, contrats)
- Risques interdépendants entre les domaines
- Pression temporelle extrême (4-6 semaines)

L'Architecture : Multi-Agent avec Superviseur

Le Skill : due-diligence-coordinator

yaml
name: financial_analyst
role: Analyste Financier Senior
focus_areas:
  - Qualité du Revenu (récurrent vs. ponctuel)
  - Besoins en Fonds de Roulement
  - Structure de la Dette (échéances, covenants)
  - Qualité du Cash Flow (FCF vs. Résultat Net)
  - Red Flags Comptables (reconnaissance agressive)
  - Concentration Clients
  - Dépendances Fournisseurs

tools:
  - name: parse_financial_statements
    description: Extrait les données des bilans et P&L
  - name: calculate_ratios
    description: Calcule les Ratios Financiers
  - name: detect_accounting_anomalies
    description: Identifie les pratiques comptables inhabituelles
  - name: analyze_cohorts
    description: Analyse les cohortes clients et la rétention

output_schema:
  type: object
  properties:
    risk_score:
      type: number
      minimum: 1
      maximum: 10
    findings:
      type: array
      items:
        type: object
        properties:
          area: {type: string}
          severity: {enum: [low, medium, high, critical]}
          description: {type: string}
          evidence: {type: string}
          mitigation: {type: string}
    key_metrics:
      type: object
    recommendations:
      type: array
yaml
name: legal_reviewer
role: Conseiller Juridique Senior
focus_areas:
  - Clauses de Changement de Contrôle
  - Contrats Matériels (Top 10 clients/fournisseurs)
  - Contentieux en Cours
  - Propriété IP et Charges
  - Contrats de Travail (Personnes Clés)
  - Conformité Réglementaire
  - Responsabilités Environnementales

tools:
  - name: parse_contract
    description: Analyse les clauses contractuelles
  - name: search_litigation_db
    description: Recherche dans les bases de données juridiques
  - name: verify_ip_ownership
    description: Vérifie les enregistrements IP
  - name: check_regulatory_filings
    description: Vérifie les dépôts réglementaires

output_schema:
  similaire à financial_analyst
yaml
name: market_analyst
role: Analyste de Recherche Sectorielle
focus_areas:
  - Marché Total Adressable (TAM)
  - Position Concurrentielle
  - Tendances Technologiques
  - Perception Client
  - Réputation du Management
  - Paysage des Brevets

tools:
  - name: web_search
    description: Recherche dans les sources publiques
  - name: search_patents
    description: Analyse le paysage des brevets
  - name: analyze_glassdoor
    description: Évalue les avis des employés
  - name: search_news_archive
    description: Recherche dans les archives de presse

output_schema:
  similaire à financial_analyst

┌─────────────────────────────────────────────────────────────┐
│ Phase 1 : PLANIFICATION                                     │
│                                                             │
│ Entrée : Paramètres du Deal, Accès Data Room                │
│ Actions :                                                   │
│ 1. Inventorier les documents                                │
│ 2. Définir les priorités selon le type de deal              │
│ 3. Définir les paquets de travail pour les sous-agents      │
│ Sortie : Plan d'Analyse                                     │
│                                                             │
│ Checkpoint : plan_complete                                  │
└─────────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────────┐
│ Phase 2 : ANALYSE PARALLÈLE                                 │
│                                                             │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐            │
│ │  Analyse    │ │   Analyse   │ │  Analyse    │            │
│ │  Financière │ │  Juridique  │ │   Marché    │            │
│ │             │ │             │ │             │            │
│ │ ~2-4 heures │ │ ~3-5 heures │ │ ~1-2 heures │            │
│ └─────────────┘ └─────────────┘ └─────────────┘            │
│                                                             │
│ Checkpoint : analysis_complete (par agent)                  │
└─────────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────────┐
│ Phase 3 : SYNTHÈSE                                          │
│                                                             │
│ Entrée : Tous les Résultats d'Analyse                       │
│ Actions :                                                   │
│ 1. Dédupliquer les résultats                                │
│ 2. Identifier les corrélations de risques                   │
│ 3. Calculer le Score de Risque Composite                    │
│ 4. Marquer les Deal Breakers                                │
│ 5. Dériver les recommandations conditionnelles              │
│ Sortie : Matrice de Risques                                 │
│                                                             │
│ Checkpoint : synthesis_complete                             │
└─────────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────────┐
│ Phase 4 : RAPPORT                                           │
│                                                             │
│ Templates :                                                 │
│ 1. Résumé Exécutif (1 page)                                │
│    - Vue d'Ensemble du Deal                                 │
│    - Risques Clés (Top 5)                                   │
│    - Recommandation                                         │
│                                                             │
│ 2. Rapport Détaillé                                         │
│    - Analyse Financière                                     │
│    - Analyse Juridique                                      │
│    - Analyse Marché                                         │
│    - Matrice de Risques                                     │
│                                                             │
│ 3. Annexe                                                   │
│    - Index des Preuves                                      │
│    - Documents Sources                                      │
│                                                             │
│ Sortie : Rapport DD Final (Word/PDF)                        │
└─────────────────────────────────────────────────────────────┘
json
{
  "deal": {
    "target": "string",
    "deal_type": "acquisition | merger | investment",
    "deal_value": "number",
    "analysis_date": "date"
  },

  "overall_assessment": {
    "composite_score": 1-10,
    "recommendation": "proceed | proceed_with_conditions | do_not_proceed",
    "confidence": 0-1,
    "key_considerations": ["string"]
  },

  "category_scores": {
    "financial": {
      "score": 1-10,
      "weight": 0.4,
      "key_risks": ["string"],
      "key_strengths": ["string"]
    },
    "legal": {
      "score": 1-10,
      "weight": 0.3,
      "key_risks": ["string"],
      "key_strengths": ["string"]
    },
    "market": {
      "score": 1-10,
      "weight": 0.3,
      "key_risks": ["string"],
      "key_strengths": ["string"]
    }
  },

  "deal_breakers": [
    {
      "issue": "string",
      "category": "string",
      "evidence": "string",
      "impact": "string"
    }
  ],

  "conditions_for_proceed": [
    {
      "condition": "string",
      "rationale": "string",
      "verification_method": "string"
    }
  ],

  "further_investigation_required": [
    {
      "area": "string",
      "questions": ["string"],
      "suggested_approach": "string"
    }
  ]
}

L'Implémentation

Évaluation Honnête

Ce qui fonctionne :
- La parallélisation économise ~60% de temps
- Couverture cohérente de tous les domaines
- Le checkpointing permet l'interruption/continuation
- La Matrice de Risques structurée permet la comparabilité

Ce qui ne fonctionne pas :
- Confidentialité : Les données de la data room ne doivent pas passer par des APIs externes
- L'obscurcissement intentionnel n'est pas détecté
- Les nuances spécifiques à l'industrie nécessitent une personnalisation
- L'interprétation juridique reste avec l'avocat

Quand NE PAS utiliser :
- Pour des deals très sensibles sans solution on-premise
- Comme seule base de décision
- Sans validation humaine des résultats critiques

---

Cas d'Usage 3 : Surveillance Conformité AML/KYC

Le Problème en Détail

Les processus Anti-Blanchiment d'Argent (AML) et Know-Your-Customer (KYC) sont :
- Chronophages : Vérification manuelle de milliers de transactions quotidiennement
- Sujets aux erreurs : Faux positifs sur 95%+ des alertes
- Critiques réglementairement : Amendes élevées en cas de manquement
- Dynamiques : Les listes de sanctions changent quotidiennement

L'Architecture : Human-in-the-Loop avec Niveaux d'Escalade

Le Skill : compliance-monitor

Score Risque = Σ (Poids_Facteur × Score_Facteur)

Facteurs :
┌─────────────────────────┬────────┬─────────────────────────────────┐
│ Facteur                 │ Poids  │ Critères de Score               │
├─────────────────────────┼────────┼─────────────────────────────────┤
│ Correspondance Sanctions│ 0.35   │ 1.0 = Correspondance Exacte     │
│                         │        │ 0.7 = Corresp. Floue > 85%      │
│                         │        │ 0.3 = Correspondance Partielle  │
├─────────────────────────┼────────┼─────────────────────────────────┤
│ Pattern Transaction     │ 0.25   │ 1.0 = Structuring Clair         │
│                         │        │ 0.6 = Anomalie Vélocité         │
│                         │        │ 0.3 = Irrégularité Mineure      │
├─────────────────────────┼────────┼─────────────────────────────────┤
│ Risque Juridiction      │ 0.20   │ 1.0 = Liste Noire GAFI          │
│                         │        │ 0.7 = Liste Grise GAFI          │
│                         │        │ 0.3 = Risque Élevé              │
├─────────────────────────┼────────┼─────────────────────────────────┤
│ Statut PEP              │ 0.15   │ 1.0 = PEP Direct                │
│                         │        │ 0.6 = Associé PEP               │
│                         │        │ 0.3 = Ancien PEP                │
├─────────────────────────┼────────┼─────────────────────────────────┤
│ Alertes Historiques     │ 0.05   │ Basé sur nombre d'alertes       │
└─────────────────────────┴────────┴─────────────────────────────────┘

Phase 1 : FILTRAGE
├── Entrée : Données Entité/Transaction
├── Actions (parallèles) :
│   ├── check_sanctions_list() → OFAC, UE, ONU, UK
│   ├── search_pep_database() → Statut PEP
│   ├── get_jurisdiction_risk() → Risque Pays
│   └── analyze_transaction_pattern() → Analyse Comportementale
└── Sortie : Facteurs de Risque Bruts

Phase 2 : SCORING RISQUE
├── Entrée : Facteurs de Risque Bruts
├── Action : calculate_risk_score()
└── Sortie : Score de Risque Composite (0-1)

Phase 3 : DÉCISION ROUTAGE
├── Entrée : Score de Risque
├── Arbre de Décision :
│   ├── < 0.3 : AUTO_CLEAR
│   ├── 0.3-0.7 : L1_REVIEW
│   ├── 0.7-0.9 : SENIOR_REVIEW (Assisté par Agent)
│   └── > 0.9 : BLOCAGE_IMMÉDIAT + ESCALADE
└── Sortie : Décision Routage + Matériaux Préparés

Phase 4 : RÉVISION HUMAINE (si requis)
├── Entrée : Résumé de cas préparé par agent
├── Actions Humaines :
│   ├── APPROUVER → Libérer transaction
│   ├── REJETER → Bloquer + SAR potentiel
│   └── ESCALADER → Autorité supérieure
└── Sortie : Décision Finale

Phase 5 : AUDIT & FEEDBACK
├── Logger toutes décisions de manière immuable
├── Mettre à jour profil de risque entité
└── Alimenter entraînement modèle
json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": ["entity", "screening_id", "risk_assessment", "routing"],
  "properties": {
    "entity": {
      "type": "object",
      "properties": {
        "name": {"type": "string"},
        "type": {"enum": ["individual", "organization"]},
        "identifiers": {"type": "object"}
      }
    },
    "screening_id": {"type": "string", "format": "uuid"},
    "timestamp": {"type": "string", "format": "date-time"},

    "risk_assessment": {
      "type": "object",
      "properties": {
        "composite_score": {"type": "number", "minimum": 0, "maximum": 1},
        "risk_level": {"enum": ["LOW", "MEDIUM", "HIGH", "CRITICAL"]},
        "factors": {
          "type": "object",
          "properties": {
            "sanctions": {"type": "object"},
            "transaction_pattern": {"type": "object"},
            "jurisdiction": {"type": "object"},
            "pep_status": {"type": "object"}
          }
        }
      }
    },

    "routing": {
      "type": "object",
      "properties": {
        "decision": {"enum": ["AUTO_CLEAR", "L1_REVIEW", "SENIOR_REVIEW", "IMMEDIATE_BLOCK"]},
        "assigned_to": {"type": "string"},
        "deadline": {"type": "string", "format": "date-time"},
        "priority": {"enum": ["LOW", "MEDIUM", "HIGH", "URGENT"]}
      }
    },

    "evidence_package": {
      "type": "object",
      "description": "Préparé pour révision humaine",
      "properties": {
        "summary": {"type": "string"},
        "key_findings": {"type": "array"},
        "similar_cases": {"type": "array"},
        "recommended_action": {"type": "string"},
        "supporting_documents": {"type": "array"}
      }
    }
  }
}

L'Implémentation

Évaluation Honnête

Ce qui fonctionne :
- Évaluation structurée du risque : Cohérente et traçable
- Réduction des faux positifs : ~40% grâce à l'analyse multi-facteurs
- Piste d'audit : Documentation complète de toutes les décisions
- Efficacité : Évaluation initiale 70% plus rapide

Ce qui ne fonctionne pas :
- Nouvelles typologies : Les patterns de blanchiment inconnus ne sont pas détectés
- Correspondance de noms : Les variations culturelles restent problématiques
- Décision finale : Reste aux humains (exigence réglementaire)

Quand NE PAS utiliser :
- Comme seule autorité décisionnelle
- Sans mises à jour régulières du modèle
- Sans surveillance humaine des décisions auto-clear

---

Cas d'usage 4 : Recherche d'investissement

Le problème en détail

La recherche Equity Research nécessite :
- Analyse de plus de 100 points de données par entreprise
- Intégration de diverses sources (Fondamentaux, Actualités, Sentiment)
- Comparaison avec les pairs et l'industrie
- Pression temporelle lors des événements (Résultats, M&A)

L'architecture : Pattern Supervisor avec agents spécialisés

Le Skill : investment-researcher

yaml
name: fundamental_analyst
role: Analyste Equity Senior (Fondamentaux)
focus_areas:
  - Analyse des états financiers
  - Qualité des bénéfices
  - Analyse des flux de trésorerie
  - Solidité du bilan
  - Moteurs de croissance
  - Analyse des marges
  - Allocation du capital

metrics_to_analyze:
  income_statement:
    - Revenus (croissance, mix, qualité)
    - Marge brute (tendance, vs pairs)
    - Marge opérationnelle (levier)
    - Résultat net (ajustements)

  balance_sheet:
    - Dette/Capitaux propres
    - Ratio de liquidité
    - Fonds de roulement
    - Goodwill/Incorporels

  cash_flow:
    - Cash Flow opérationnel
    - Free Cash Flow
    - Conversion FCF
    - Intensité CapEx

  quality_checks:
    - Reconnaissance des revenus
    - Ratio d'accruals
    - Cash vs Bénéfices
    - Tendances DSO/DPO

output:
  fundamental_score: 1-10
  quality_score: 1-10
  growth_score: 1-10
  key_drivers: [string]
  red_flags: [string]
  valuation_inputs: {object}
yaml
name: industry_analyst
role: Analyste Sectoriel Senior
focus_areas:
  - Taille du marché (TAM/SAM/SOM)
  - Paysage concurrentiel
  - Tendances sectorielles
  - Environnement réglementaire
  - Disruption technologique
  - Barrières à l'entrée

analysis_framework:
  porter_five_forces:
    - Rivalité concurrentielle
    - Pouvoir des fournisseurs
    - Pouvoir des acheteurs
    - Menace de substitution
    - Menace de nouveaux entrants

  competitive_position:
    - Part de marché
    - Tendance des parts
    - Avantages concurrentiels
    - Analyse SWOT

output:
  industry_attractiveness: 1-10
  competitive_position: 1-10
  moat_strength: none | narrow | wide
  industry_trends: [string]
  competitive_threats: [string]
yaml
name: sentiment_analyst
role: Analyste Sentiment & Catalyseurs
focus_areas:
  - Analyse du flux d'actualités
  - Sentiment des réseaux sociaux
  - Sentiment des analystes
  - Activité des initiés
  - Intérêt court
  - Flux d'options
  - Calendrier des événements

data_sources:
  - APIs d'actualités (Reuters, Bloomberg)
  - Réseaux sociaux (Twitter, Reddit, StockTwits)
  - Dépôts SEC (Form 4, 13F)
  - Données d'options
  - Rapports d'intérêt court

output:
  overall_sentiment: very_negative | negative | neutral | positive | very_positive
  sentiment_score: -1 to 1
  sentiment_trend: improving | stable | deteriorating
  upcoming_catalysts: [{event, date, expected_impact}]
  insider_activity_summary: string

Phase 1 : DISPATCH (Parallèle)
├── Le Supervisor reçoit la demande de recherche
├── Dispatch vers tous les spécialistes simultanément :
│   ├── Fundamental Analyst → Financiers de l'entreprise
│   ├── Industry Analyst → Marché & concurrence
│   └── Sentiment Analyst → Actualités & catalyseurs
└── Chaque spécialiste travaille indépendamment

Phase 2 : ANALYSE SPÉCIALISÉE (Parallèle, ~2-5 min chacune)
├── Fondamental :
│   ├── Récupération des financiers (3 ans)
│   ├── Calcul des ratios
│   ├── Contrôles de qualité
│   └── Analyse de croissance
├── Sectoriel :
│   ├── Étude de marché
│   ├── Comparaison avec les pairs
│   └── Analyse des tendances
└── Sentiment :
    ├── Agrégation des actualités
    ├── Scraping social
    └── Cartographie des catalyseurs

Phase 3 : SYNTHÈSE (Séquentielle, ~1-2 min)
├── Collecte de toutes les sorties spécialisées
├── Identification des conflits/confirmations
├── Pondération des facteurs par pertinence
├── Génération de la thèse d'investissement
└── Calcul de la fourchette d'objectif de cours

Phase 4 : GÉNÉRATION DU RAPPORT (~1 min)
├── Structuration des résultats en rapport
├── Génération des graphiques/tableaux
├── Contrôle qualité
└── Production du rapport final
json
{
  "ticker": "string",
  "company_name": "string",
  "analysis_date": "date",

  "recommendation": {
    "rating": "STRONG_BUY | BUY | HOLD | SELL | STRONG_SELL",
    "conviction": "LOW | MEDIUM | HIGH",
    "price_target": {
      "low": "number",
      "base": "number",
      "high": "number"
    },
    "current_price": "number",
    "upside_potential": "string"
  },

  "thesis_summary": {
    "one_liner": "string (max 100 chars)",
    "bull_case": ["string"],
    "bear_case": ["string"],
    "key_metrics_to_watch": ["string"]
  },

  "scores": {
    "fundamental": {"score": 1-10, "trend": "improving|stable|declining"},
    "industry": {"score": 1-10, "position": "leader|challenger|follower"},
    "sentiment": {"score": -1 to 1, "trend": "improving|stable|declining"},
    "overall": {"score": 1-10, "confidence": 0-1}
  },

  "catalysts": [
    {
      "event": "string",
      "expected_date": "date",
      "potential_impact": "HIGH | MEDIUM | LOW",
      "direction": "POSITIVE | NEGATIVE | UNCERTAIN"
    }
  ],

  "risks": [
    {
      "risk": "string",
      "severity": "HIGH | MEDIUM | LOW",
      "probability": "HIGH | MEDIUM | LOW",
      "mitigation": "string"
    }
  ],

  "valuation": {
    "methodology": "DCF | Multiples | Sum-of-Parts",
    "key_assumptions": {},
    "sensitivity_table": {}
  }
}

L'implémentation

Évaluation honnête

Ce qui fonctionne :
- Structure d'analyse cohérente : Chaque entreprise évaluée de manière égale
- Gain de temps : 80% pour l'analyse initiale
- Couverture large : Fondamentaux + Secteur + Sentiment intégrés
- Sorties structurées : Comparables dans le temps et entre entreprises

Ce qui ne fonctionne pas :
- Insights qualitatifs : Qualité du management, culture d'entreprise
- Thèses non conventionnelles : Seulement les métriques établies
- Timing de marché : Pas de sens du momentum/techniques
- Facteurs "soft" : Réputation, nuances ESG

Quand NE PAS utiliser :
- Pour les décisions d'investissement finales seules
- Avec des entreprises ayant peu de données publiques
- Sans révision humaine de la thèse

---

Cas d'usage 5 : Automatisation des déclarations réglementaires

Le problème en détail

Les rapports réglementaires (dépôts SEC, notifications BaFin) sont :
- Hautement standardisés mais chronophages
- Sujets aux erreurs lors de la création manuelle
- Soumis à des délais stricts
- Réglementairement sensibles (pénalités en cas d'erreurs)

L'architecture : Plan-Execute avec validation multi-étapes

Le Skill : regulatory-filer

yaml
filing_type: form_13f
frequency: trimestrielle
deadline: 45 jours après la fin du trimestre
format: XML/XBRL

required_data:
  - position_holdings: Liste des positions > $100M AUM
  - voting_authority: Seul, partagé, aucun
  - investment_discretion: Seul, partagé, aucun

validation_rules:
  - Toutes les positions doivent avoir un CUSIP valide
  - Les holdings doivent correspondre à l'AUM (avec tolérance)
  - Comparaison avec la période précédente pour les grands changements
yaml
filing_type: wphg_meldung
trigger: Franchissement de seuil (3%, 5%, 10%, etc.)
deadline: 4 jours de trading
format: XML

required_data:
  - issuer_lei: Legal Entity Identifier
  - holder_info: Nom, adresse, LEI
  - voting_rights: Direct, indirect, instruments
  - threshold_crossed: Pourcentage

validation_rules:
  - Format LEI valide
  - Calcul de seuil correct
  - Chaîne d'attribution complète

Phase 1 : INITIALISATION
├── Analyser la demande de dépôt
├── Identifier le type de dépôt et les exigences
├── Charger le template approprié
├── Définir l'échéance et les points de contrôle
└── Sortie : Configuration du dépôt

Phase 2 : COLLECTE DE DONNÉES (Parallèle)
├── Se connecter aux sources de données
│   ├── ERP/Comptabilité : get_financial_data()
│   ├── Trading : get_positions()
│   ├── Risque : get_exposures()
│   └── Référence : get_entity_data()
├── Normaliser et transformer
├── Gérer les données manquantes
│   ├── Enregistrer les avertissements
│   └── Demander une saisie manuelle si critique
└── Sortie : Package de données consolidé

Phase 3 : VALIDATION (Séquentielle, bloquante)
├── Niveau 1 : Validation de schéma
│   ├── Tous les champs requis présents
│   ├── Types de données corrects
│   └── Conformité de format
├── Niveau 2 : Règles métier
│   ├── Calculs corrects
│   ├── Références croisées valides
│   └── Seuils respectés
├── Niveau 3 : Règles réglementaires
│   ├── Contrôles spécifiques au régulateur
│   ├── Cohérence historique
│   └── Seuils de matérialité
├── Décision :
│   ├── TOUT PASSE → Continuer
│   └── ÉCHEC → STOP + Rapport d'erreur
└── Sortie : Rapport de validation

Phase 4 : GÉNÉRATION DU DOCUMENT
├── Charger le template du dépôt
├── Remplir avec les données validées
├── Générer les calculs
├── Formater pour la soumission
├── Générer les annexes
└── Sortie : Brouillon + Documents annexes

Phase 5 : RÉVISION HUMAINE (Obligatoire)
├── Présenter le package de révision
│   ├── Dépôt généré
│   ├── Rapport de validation
│   ├── Résumé des sources de données
│   ├── Analyse des modifications (vs précédent)
│   └── Exceptions mises en évidence
├── Actions du réviseur :
│   ├── APPROUVER → Continuer vers soumission
│   ├── DEMANDER_MODIFICATIONS → Retour avec notes
│   └── REJETER → Terminer avec motif
└── Sortie : Dépôt approuvé + Signature

Phase 6 : SOUMISSION
├── Validation finale du schéma
├── Appliquer la signature numérique (si requise)
├── Soumettre via API/portail du régulateur
├── Capturer la confirmation/reçu
├── Archiver tous les artefacts
└── Sortie : Confirmation de soumission + Piste d'audit
json
{
  "validation_rules": {
    "schema": [
      {
        "rule_id": "SCH-001",
        "field": "",
        "check": "required_fields_present",
        "severity": "ERROR"
      },
      {
        "rule_id": "SCH-002",
        "field": "lei",
        "check": "format_regex",
        "pattern": "^[A-Z0-9]{20}$",
        "severity": "ERROR"
      }
    ],
    "business": [
      {
        "rule_id": "BUS-001",
        "check": "sum_equals",
        "fields": ["position_values"],
        "target": "total_aum",
        "tolerance": 0.01,
        "severity": "ERROR"
      },
      {
        "rule_id": "BUS-002",
        "check": "cross_reference",
        "source": "cusip",
        "target": "security_master",
        "severity": "WARNING"
      }
    ],
    "regulatory": [
      {
        "rule_id": "REG-001",
        "check": "threshold",
        "field": "total_aum",
        "min": 100000000,
        "message": "Form 13F requis uniquement pour AUM > $100M",
        "severity": "INFO"
      },
      {
        "rule_id": "REG-002",
        "check": "prior_period_variance",
        "threshold": 0.25,
        "message": "Changement important vs période précédente",
        "severity": "WARNING"
      }
    ]
  }
}

L'implémentation

Évaluation honnête

Ce qui fonctionne :
- Cohérence : Les processus standardisés réduisent les erreurs
- Piste d'audit : Traçabilité complète
- Gain de temps : 60-70% pour les dépôts de routine
- Validation : Détection précoce des erreurs

Ce qui ne fonctionne pas :
- Exceptions complexes : Les situations non standard nécessitent une intervention manuelle
- Interprétation : Les zones grises réglementaires restent du domaine des experts
- Nouvelles exigences : Ajustements nécessaires lors des changements réglementaires

Quand NE PAS utiliser :
- Pour les premiers dépôts sans templates établis
- Avec des structures d'entreprise complexes sans personnalisation
- En remplacement de l'expertise réglementaire

---

Partie 4 : Infrastructure Partagée

Memory System pour tous les Agents

Security Layer

system.?

---

Conclusion : Les Apprentissages Clés

Ce qui fonctionne

1. Tâches structurées avec un contrat de sortie clair : Plus c'est défini précisément, meilleur c'est
2. Context Engineering : Le framework Role-Goal-State-Trust améliore considérablement la fiabilité
3. Multi-Agent pour les tâches complexes : Parallélisation + Spécialisation
4. Human-in-the-Loop pour les décisions critiques : Non négociable

Ce qui ne fonctionne pas

1. Nuances subtiles : Ironie, contexte culturel, le "non-dit"
2. Détection de fraude : Les agents ne trouvent que ce qui est dans les données
3. Déléguer la responsabilité juridique : Les décisions de conformité restent à l'humain
4. "Bourrage" de contexte : Plus n'est pas mieux (Context Rot)

La bonne approche

Les agents IA sont des multiplicateurs de productivité, pas un remplacement de l'expertise. Ils effectuent le travail fastidieux de manière fiable, mais le jugement reste à l'humain.

---

Dernière mise à jour : Décembre 2025

Ce guide est fourni à titre informatif et ne constitue pas un conseil en investissement.
