Tutoriels & How-to

Comment valider un cas d'usage AI d'inventaire avant d'acheter un logiciel

Un protocole axé sur la décision pour transformer un intérêt général pour l'AI en un workflow d'inventaire mesurable.

Construire une prévision de la demande assistée par IA dans IBM Planning Analytics

# Construire un outil RCCP assisté par AI pour l'équilibrage de capacité à moyen terme ## Vue d'ensemble Le Rough Cut Capacity Planning (RCCP) est un processus critique du S&OP qui valide si les plans de production agrégés peuvent être exécutés avec les ressources disponibles. Un outil RCCP assisté par AI améliore ce processus en automatisant les calculs de charge, en identifiant les goulots d'étranglement et en recommandant des actions d'équilibrage pour un horizon de 3 à 18 mois. ## Composants principaux du système ### 1. Moteur de calcul de charge **Données d'entrée :** - Plan de production agrégé par famille de produits - Profils de routage et temps standard par famille - Calendriers de ressources et disponibilité - Définitions de groupes de capacité (postes de charge, lignes, départements) **Logique de calcul :** ```python import pandas as pd import numpy as np class LoadCalculationEngine: def __init__(self, resource_calendar, routing_profiles): self.resource_calendar = resource_calendar self.routing_profiles = routing_profiles def calculate_capacity_load(self, production_plan, time_horizon): """ Calcule les besoins en capacité par ressource et période """ load_by_resource = {} for period in time_horizon: for product_family, quantity in production_plan[period].items(): routing = self.routing_profiles[product_family] for operation in routing: resource = operation['resource_group'] std_hours = operation['standard_hours'] setup_hours = operation['setup_hours'] # Calcul de la charge total_hours = (quantity * std_hours) + setup_hours if resource not in load_by_resource: load_by_resource[resource] = {} if period not in load_by_resource[resource]: load_by_resource[resource][period] = 0 load_by_resource[resource][period] += total_hours return self.create_load_profile(load_by_resource) def create_load_profile(self, load_data): """ Crée un profil de charge structuré avec disponibilité et utilisation """ profile = [] for resource, periods in load_data.items(): for period, load_hours in periods.items(): available_hours = self.resource_calendar.get_capacity( resource, period ) utilization = (load_hours / available_hours * 100) if available_hours > 0 else 0 profile.append({ 'resource': resource, 'period': period, 'required_hours': load_hours, 'available_hours': available_hours, 'utilization_pct': utilization, 'gap_hours': load_hours - available_hours }) return pd.DataFrame(profile) ``` ### 2. Module de détection des goulots d'étranglement **Identification des contraintes de capacité :** ```python class BottleneckDetector: def __init__(self, utilization_threshold=85, criticality_window=3): self.utilization_threshold = utilization_threshold self.criticality_window = criticality_window def identify_bottlenecks(self, load_profile): """ Identifie les goulots d'étranglement basés sur l'utilisation et la persistance """ bottlenecks = [] # Grouper par ressource for resource in load_profile['resource'].unique(): resource_data = load_profile[ load_profile['resource'] == resource ].sort_values('period') # Identifier les périodes de surcharge overload_periods = resource_data[ resource_data['utilization_pct'] > self.utilization_threshold ] if len(overload_periods) > 0: # Analyser la sévérité severity = self._calculate_severity(overload_periods) # Analyser la criticité (périodes consécutives) criticality = self._analyze_criticality( resource_data, overload_periods ) bottlenecks.append({ 'resource': resource, 'affected_periods': len(overload_periods), 'avg_utilization': overload_periods['utilization_pct'].mean(), 'max_utilization': overload_periods['utilization_pct'].max(), 'total_gap_hours': overload_periods['gap_hours'].sum(), 'severity_score': severity, 'criticality_score': criticality, 'periods': overload_periods['period'].tolist() }) # Classer par criticité bottlenecks_df = pd.DataFrame(bottlenecks) if not bottlenecks_df.empty: bottlenecks_df = bottlenecks_df.sort_values( ['criticality_score', 'severity_score'], ascending=False ) return bottlenecks_df def _calculate_severity(self, overload_periods): """ Calcule le score de sévérité basé sur l'ampleur et la durée """ avg_excess = (overload_periods['utilization_pct'] - 100).mean() duration = len(overload_periods) severity = (avg_excess * 0.6) + (duration * 10 * 0.4) return severity def _analyze_criticality(self, resource_data, overload_periods): """ Analyse les périodes consécutives de surcharge """ overload_indices = overload_periods.index.tolist() all_indices = resource_data.index.tolist() max_consecutive = 0 current_consecutive = 0 for idx in all_indices: if idx in overload_indices: current_consecutive += 1 max_consecutive = max(max_consecutive, current_consecutive) else: current_consecutive = 0 return max_consecutive * 20 # Score de criticité ``` ### 3. Moteur de recommandations AI **Génération de stratégies d'équilibrage :** ```python from sklearn.ensemble import RandomForestClassifier import itertools class AIBalancingRecommender: def __init__(self, historical_actions): self.historical_actions = historical_actions self.model = self._train_action_model() def _train_action_model(self): """ Entraîne un modèle pour prédire l'efficacité des actions """ if self.historical_actions.empty: return None # Features : caractéristiques du goulot d'étranglement X = self.historical_actions[[ 'utilization_pct', 'gap_hours', 'affected_periods', 'resource_type', 'lead_time_weeks' ]] # Target : efficacité de l'action (résolu, partiel, échec) y = self.historical_actions['action_effectiveness'] model = RandomForestClassifier(n_estimators=100, random_state=42) # Encoder les variables catégorielles X_encoded = pd.get_dummies(X, columns=['resource_type']) model.fit(X_encoded, y) return model def generate_recommendations(self, bottlenecks, load_profile, production_plan, constraints): """ Génère des recommandations priorisées pour résoudre les goulots """ recommendations = [] for _, bottleneck in bottlenecks.iterrows(): resource = bottleneck['resource'] periods = bottleneck['periods'] gap_hours = bottleneck['total_gap_hours'] # Générer plusieurs options options = self._generate_balancing_options( resource, periods, gap_hours, load_profile, production_plan, constraints ) # Scorer chaque option for option in options: score = self._score_option(option, bottleneck) recommendations.append({ 'resource': resource, 'action_type': option['type'], 'description': option['description'], 'estimated_capacity_gain': option['capacity_gain'], 'cost_estimate': option['cost'], 'implementation_time': option['lead_time'], 'feasibility_score': score, 'periods_affected': periods, 'details': option['details'] }) recommendations_df = pd.DataFrame(recommendations) if not recommendations_df.empty: recommendations_df = recommendations_df.sort_values( 'feasibility_score', ascending=False ) return recommendations_df def _generate_balancing_options(self, resource, periods, gap_hours, load_profile, production_plan, constraints): """ Génère différentes options d'équilibrage """ options = [] # Option 1 : Overtime if constraints.get('allow_overtime', True): overtime_capacity = gap_hours overtime_cost = overtime_capacity * constraints.get('overtime_rate', 1.5) options.append({ 'type': 'overtime', 'description': f'Ajouter {overtime_capacity:.0f} heures supplémentaires', 'capacity_gain': overtime_capacity, 'cost': overtime_cost, 'lead_time': 0, 'details': {'hours': overtime_capacity, 'periods': periods} }) # Option 2 : Shift additionnel if constraints.get('allow_additional_shifts', True): shift_capacity = constraints.get('hours_per_shift', 160) * len(periods) shift_cost = shift_capacity * constraints.get('shift_cost_multiplier', 1.3) if shift_capacity >= gap_hours * 0.8: options.append({ 'type': 'additional_shift', 'description': 'Ajouter un shift (équipe supplémentaire)', 'capacity_gain': shift_capacity, 'cost': shift_cost, 'lead_time': 4, # semaines 'details': {'shifts': 1, 'periods': periods} }) # Option 3 : Sous-traitance if constraints.get('allow_subcontracting', True): subcontract_capacity = gap_hours subcontract_cost = subcontract_capacity * constraints.get('subcontract_rate', 2.0) options.append({ 'type': 'subcontracting', 'description': f'Sous-traiter {subcontract_capacity:.0f} heures', 'capacity_gain': subcontract_capacity, 'cost': subcontract_cost, 'lead_time': 2, 'details': {'hours': subcontract_capacity, 'periods': periods} }) # Option 4 : Nivellement de charge (load leveling) leveling_options = self._analyze_load_leveling( resource, periods, load_profile, production_plan ) if leveling_options: options.extend(leveling_options) # Option 5 : Investissement capacitaire if gap_hours > constraints.get('investment_threshold', 500): equipment_cost = constraints.get('equipment_investment', 100000) capacity_increase = constraints.get('equipment_capacity', 2000) options.append({ 'type': 'capital_investment', 'description': 'Acquérir équipement/ligne supplémentaire', 'capacity_gain': capacity_increase, 'cost': equipment_cost, 'lead_time': 12, 'details': {'type': 'equipment', 'capacity': capacity_increase} }) return options def _analyze_load_leveling(self, resource, overload_periods, load_profile, production_plan): """ Analyse les opportunités de nivellement de charge """ options = [] # Identifier les périodes sous-utilisées resource_profile = load_profile[load_profile['resource'] == resource] underload_periods = resource_profile[ resource_profile['utilization_pct'] < 70 ] if len(underload_periods) > 0: # Calculer la capacité disponible available_capacity = ( underload_periods['available_hours'] - underload_periods['required_hours'] ).sum() if available_capacity > 0: options.append({ 'type': 'load_leveling', 'description': 'Déplacer production vers périodes creuses', 'capacity_gain': available_capacity, 'cost': available_capacity * 0.1, # Coût de nivellement minimal 'lead_time': 0, 'details': { 'from_periods': overload_periods, 'to_periods': underload_periods['period'].tolist(), 'capacity_available': available_capacity } }) return options def _score_option(self, option, bottleneck): """ Score une option basée sur efficacité, coût et faisabilité """ # Efficacité : l'option résout-elle le problème ? coverage = min(option['capacity_gain'] / bottleneck['total_gap_hours'], 1.0) # Coût normalisé (inversé pour que moins cher = meilleur score) cost_normalized = 1 / (1 + option['cost'] / 10000) # Lead time (plus court = meilleur) time_score = 1 / (1 + option['lead_time'] / 12) # Score composite score = (coverage * 0.4) + (cost_normalized * 0.3) + (time_score * 0.3) return score * 100 ``` ### 4. Module de simulation de scénarios **Test des stratégies d'équilibrage :** ```python class CapacityScenarioSimulator: def __init__(self, load_calculator, bottleneck_detector): self.load_calculator = load_calculator self.bottleneck_detector = bottleneck_detector def simulate_scenario(self, production_plan, actions, time_horizon): """ Simule l'impact des actions d'équilibrage """ # Calcul de charge de base baseline_load = self.load_calculator.calculate_capacity_load( production_plan, time_horizon ) # Appliquer les actions adjusted_load = self._apply_actions(baseline_load, actions) # Détection des goulots après actions remaining_bottlenecks = self.bottleneck_detector.identify_bottlenecks( adjusted_load ) # Métriques de comparaison comparison = self._compare_scenarios( baseline_load, adjusted_load, remaining_bottlenecks ) return { 'baseline': baseline_load, 'adjusted': adjusted_load, 'remaining_bottlenecks': remaining_bottlenecks, 'comparison': comparison, 'actions_applied': actions } def _apply_actions(self, load_profile, actions): """ Applique les actions au profil de charge """ adjusted = load_profile.copy() for action in actions: resource = action['resource'] action_type = action['action_type'] details = action['details'] if action_type == 'overtime': # Ajouter capacité overtime mask = (adjusted['resource'] == resource) & \ (adjusted['period'].isin(details['periods'])) adjusted.loc[mask, 'available_hours'] += \ details['hours'] / len(details['periods']) elif action_type == 'additional_shift': # Ajouter un shift complet mask = (adjusted['resource'] == resource) & \ (adjusted['period'].isin(details['periods'])) adjusted.loc[mask, 'available_hours'] *= 1.5 # Approximation elif action_type == 'subcontracting': # Réduire la charge requise mask = (adjusted['resource'] == resource) & \ (adjusted['period'].isin(details['periods'])) adjusted.loc[mask, 'required_hours'] -= \ details['hours'] / len(details['periods']) elif action_type == 'load_leveling': # Déplacer charge entre périodes adjusted = self._apply_load_leveling( adjusted, resource, details ) elif action_type == 'capital_investment': # Augmentation permanente de capacité mask = adjusted['resource'] == resource adjusted.loc[mask, 'available_hours'] += details['capacity'] / 12 # Recalculer utilisation et gap adjusted['utilization_pct'] = ( adjusted['required_hours'] / adjusted['available_hours'] * 100 ) adjusted['gap_hours'] = ( adjusted['required_hours'] - adjusted['available_hours'] ) return adjusted def _apply_load_leveling(self, load_profile, resource, details): """ Applique le nivellement de charge entre périodes """ adjusted = load_profile.copy() from_periods = details['from_periods'] to_periods = details['to_periods'] # Logique de déplacement simplifée # Dans un vrai système, cela nécessiterait une optimisation plus sophistiquée return adjusted def _compare_scenarios(self, baseline, adjusted, remaining_bottlenecks): """ Compare les scénarios baseline et ajusté """ baseline_overload = len(baseline[baseline['utilization_pct'] > 100]) adjusted_overload = len(adjusted[adjusted['utilization_pct'] > 100]) baseline_avg_util = baseline['utilization_pct'].mean() adjusted_avg_util = adjusted['utilization_pct'].mean() return { 'overloaded_periods_before': baseline_overload, 'overloaded_periods_after': adjusted_overload, 'improvement_pct': ( (baseline_overload - adjusted_overload) / baseline_overload * 100 if baseline_overload > 0 else 0 ), 'avg_utilization_before': baseline_avg_util, 'avg_utilization_after': adjusted_avg_util, 'bottlenecks_resolved': len(baseline) - len(remaining_bottlenecks), 'bottlenecks_remaining': len(remaining_bottlenecks) } ``` ## Interface utilisateur et visualisations ### Tableau de bord RCCP ```python import plotly.graph_objects as go from plotly.subplots import make_subplots class RCCPDashboard: def create_capacity_heatmap(self, load_profile): """ Crée une heatmap d'utilisation de capacité """ # Pivoter les données pour heatmap pivot_data = load_profile.pivot( index='resource', columns='period', values='utilization_pct' ) fig = go.Figure(data=go.Heatmap( z=pivot_data.values, x=pivot_data.columns, y=pivot_data.index, colorscale=[ [0, 'green'], [0.7, 'yellow'], [0.85, 'orange'], [1, 'red'] ], colorbar=dict(title='Utilisation %'), text=pivot_data.values, texttemplate='%{text:.1f}%', textfont={"size": 10} )) fig.update_layout( title='Profil d\'utilisation de capacité par ressource', xaxis_title='Période', yaxis_title='Ressource', height=600 ) return fig def create_bottleneck_chart(self, bottlenecks): """ Visualise les goulots d'étranglement """ fig = go.Figure() fig.add_trace(go.Bar( x=bottlenecks['resource'], y=bottlenecks['total_gap_hours'], name='Heures de déficit', marker_color='red' )) fig.update_layout( title='Déficits de capacité par ressource', xaxis_title='Ressource', yaxis_title='Heures de déficit', showlegend=True, height=400 ) return fig def create_load_profile_chart(self, load_profile, resource): """ Graphique de profil de charge pour une ressource """ resource_data = load_profile[ load_profile['resource'] == resource ].sort_values('period') fig = go.Figure() # Capacité disponible fig.add_trace(go.Scatter( x=resource_data['period'], y=resource_data['available_hours'], name='Capacité disponible', line=dict(color='green', dash='dash') )) # Charge requise fig.add_trace(go.Scatter( x=resource_data['period'], y=resource_data['required_hours'], name='Charge requise', line=dict(color='blue'), fill='tonexty' )) fig.update_layout( title=f'Profil de charge - {resource}', xaxis_title='Période', yaxis_title='Heures', height=400 ) return fig def create_scenario_comparison(self, comparison_data): """ Compare les scénarios baseline vs ajusté """ metrics = ['overloaded_periods', 'avg_utilization', 'bottlenecks'] baseline_values = [ comparison_data['overloaded_periods_before'], comparison_data['avg_utilization_before'], comparison_data['overloaded_periods_before'] ] adjusted_values = [ comparison_data['overloaded_periods_after'], comparison_data['avg_utilization_after'], comparison_data['bottlenecks_remaining'] ] fig = go.Figure(data=[ go.Bar(name='Baseline', x=metrics, y=baseline_values), go.Bar(name='Ajusté', x=metrics, y=adjusted_values) ]) fig.update_layout( title='Comparaison de scénarios', barmode='group', height=400 ) return fig ``` ## Architecture système complète ```python class RCCPSystem: """ Système RCCP intégré assisté par AI """ def __init__(self, config): self.config = config # Initialiser les composants self.load_calculator = LoadCalculationEngine( config['resource_calendar'], config['routing_profiles'] ) self.bottleneck_detector = BottleneckDetector( utilization_threshold=config.get('utilization_threshold', 85) ) self.recommender = AIBalancingRecommender( config.get('historical_actions', pd.DataFrame()) ) self.simulator = CapacityScenarioSimulator( self.load_calculator, self.bottleneck_detector ) self.dashboard = RCCPDashboard() def run_rccp_analysis(self, production_plan, time_horizon, constraints): """ Exécute l'analyse RCCP complète """ print("Étape 1/5 : Calcul des besoins en capacité...") load_profile = self.load_calculator.calculate_capacity_load( production_plan, time_horizon ) print("Étape 2/5 : Détection des goulots d'étranglement...") bottlenecks = self.bottleneck_detector.identify_bottlenecks(load_profile) print(f"Goulots identifiés : {len(bottlenecks)}") if len(bottlenecks) == 0: return { 'status': 'FAISABLE', 'load_profile': load_profile, 'bottlenecks': bottlenecks, 'recommendations': pd.DataFrame(), 'message': 'Le plan de production est faisable avec la capacité actuelle' } print("Étape 3/5 : Génération de recommandations...") recommendations = self.recommender.generate_recommendations( bottlenecks, load_profile, production_plan, constraints ) print(f"Recommandations générées : {len(recommendations)}") print("Étape 4/5 : Simulation de scénarios...") # Sélectionner les meilleures recommandations top_actions = recommendations.head(5).to_dict('records') scenario_result = self.simulator.simulate_scenario( production_plan, top_actions, time_horizon ) print("Étape 5/5 : Génération des visualisations...") visualizations = { 'heatmap': self.dashboard.create_capacity_heatmap(load_profile), 'bottlenecks': self.dashboard.create_bottleneck_chart(bottlenecks), 'scenario_comparison': self.dashboard.create_scenario_comparison( scenario_result['comparison'] ) } return { 'status': 'CONTRAINTES' if len(bottlenecks) > 0 else 'FAISABLE', 'load_profile': load_profile, 'bottlenecks': bottlenecks, 'recommendations': recommendations, 'scenario_simulation': scenario_result, 'visualizations': visualizations, 'summary': self._generate_summary(bottlenecks, recommendations, scenario_result) } def _generate_summary(self, bottlenecks, recommendations, scenario): """ Génère un résumé exécutif """ summary = { 'total_bottlenecks': len(bottlenecks), 'critical_resources': bottlenecks['resource'].tolist() if not bottlenecks.empty else [], 'total_capacity_gap_hours': bottlenecks['total_gap_hours'].sum() if not bottlenecks.empty else 0, 'top_recommendation': recommendations.iloc[0].to_dict() if not recommendations.empty else None, 'estimated_improvement': scenario['comparison']['improvement_pct'], 'action_required': len(bottlenecks) > 0 } return summary ``` ## Exemple d'utilisation ```python # Configuration config = { 'resource_calendar': resource_calendar_obj, 'routing_profiles': routing_data, 'utilization_threshold': 85, 'historical_actions': historical_df } # Initialiser le système rccp_system = RCCPSystem(config) # Plan de production (exemple) production_plan = { '2024-01': {'ProductFamily_A': 1000, 'ProductFamily_B': 500}, '2024-02': {'ProductFamily_A': 1200, 'ProductFamily_B': 600}, '2024-03': {'ProductFamily_A': 1100, 'ProductFamily_B': 550}, # ... autres périodes } time_horizon = ['2024-01', '2024-02', '2024-03', '2024-04', '2024-05', '2024-06'] constraints = { 'allow_overtime': True, 'allow_additional_shifts': True, 'allow_subcontracting': True, 'overtime_rate': 1.5, 'shift_cost_multiplier': 1.3, 'subcontract_rate': 2.0, 'investment_threshold': 1000, 'equipment_investment': 150000, 'equipment_capacity': 2000, 'hours_per_shift': 160 } # Exécuter l'analyse results = rccp_system.run_rccp_analysis( production_plan, time_horizon, constraints ) # Afficher les résultats print(f"\nStatut : {results['status']}") print(f"Goulots identifiés : {results['summary']['total_bottlenecks']}") print(f"Déficit total : {results['summary']['total_capacity_gap_hours']:.0f} heures") if results['summary']['top_recommendation']: top_rec = results['summary']['top_recommendation'] print(f"\nRecommandation principale :") print(f" - Action : {top_rec['description']}") print(f" - Gain de capacité : {top_rec['estimated_capacity_gain']:.0f} heures") print(f" - Coût estimé : {top_rec['cost_estimate']:.0f} €") print(f" - Délai : {top_rec['implementation_time']} semaines") # Visualisations results['visualizations']['heatmap'].show() results['visualizations']['bottlenecks'].show() ``` ## Intégration avec l'ERP et systèmes existants ```python class ERPIntegration: """ Module d'intégration avec systèmes ERP """ def __init__(self, erp_connector): self.erp = erp_connector def fetch_production_plan(self, planning_version, time_horizon): """ Récupère le plan de production depuis l'ERP """ query = f""" SELECT period, product_family, planned_quantity FROM production_plan WHERE version = '{planning_version}' AND period BETWEEN '{time_horizon[0]}' AND '{time_horizon[-1]}' """ df = self.erp.execute_query(query) # Transformer en structure attendue plan = {} for _, row in df.iterrows(): period = row['period'] if period not in plan: plan[period] = {} plan[period][row['product_family']] = row['planned_quantity'] return plan def fetch_resource_calendar(self, time_horizon): """ Récupère les calendriers de ressources """ query = f""" SELECT resource_id, resource_group, period, available_hours, efficiency_factor FROM resource_calendar WHERE period BETWEEN '{time_horizon[0]}' AND '{time_horizon[-1]}' """ return self.erp.execute_query(query) def fetch_routing_data(self): """ Récupère les données de routage """ query = """ SELECT product_family, operation_seq, resource_group, standard_hours_per_unit, setup_hours FROM routing_master WHERE active = 1 """ return self.erp.execute_query(query) def publish_rccp_results(self, results, version): """ Publie les résultats RCCP dans l'ERP """ # Publier le profil de charge self._publish_load_profile(results['load_profile'], version) # Publier les goulots self._publish_bottlenecks(results['bottlenecks'], version) # Publier les recommandations self._publish_recommendations(results['recommendations'], version) def _publish_load_profile(self, load_profile, version): load_profile['version'] = version load_profile['analysis_date'] = pd.Timestamp.now() self.erp.bulk_insert('rccp_load_profile', load_profile) def _publish_bottlenecks(self, bottlenecks, version): if not bottlenecks.empty: bottlenecks['version'] = version bottlenecks['analysis_date'] = pd.Timestamp.now() self.erp.bulk_insert('rccp_bottlenecks', bottlenecks) def _publish_recommendations(self, recommendations, version): if not recommendations.empty: recommendations['version'] = version recommendations['analysis_date'] = pd.Timestamp.now() self.erp.bulk_insert('rccp_recommendations', recommendations) ``` ## Fonctionnalités avancées ### 1. Apprentissage continu ```python class ContinuousLearning: """ Module d'apprentissage continu à partir des actions passées """ def __init__(self, feedback_database): self.feedback_db = feedback_database def record_action_outcome(self, action_id, outcome_metrics): """ Enregistre l'issue d'une action recommandée """ self.feedback_db.insert({ 'action_id': action_id, 'outcome': outcome_metrics['status'], # 'success', 'partial', 'failed' 'actual_capacity_gain': outcome_metrics['capacity_gain'], 'actual_cost': outcome_metrics['cost'], 'actual_implementation_time': outcome_metrics['implementation_days'], 'timestamp': pd.Timestamp.now() }) def retrain_model(self, recommender): """ Réentraîne le modèle avec les nouvelles données """ updated_data = self.feedback_db.fetch_all() recommender.historical_actions = updated_data recommender.model = recommender._train_action_model() ``` ### 2. Alertes proactives ```python class ProactiveAlerts: """ Système d'alertes pour problèmes de capacité émergents """ def monitor_capacity_trends(self, load_profile, historical_data): """ Surveille les tendances et déclenche des alertes """ alerts = [] for resource in load_profile['resource'].unique(): resource_trend = self._analyze_trend(resource, historical_data) if resource_trend['direction'] == 'increasing' and \ resource_trend['projected_utilization'] > 90: alerts.append({ 'severity': 'HIGH', 'resource': resource, 'message': f'Tendance croissante détectée. Utilisation projetée : {resource_trend["projected_utilization"]:.1f}%', 'recommended_action': 'Planifier augmentation de capacité' }) return alerts def _analyze_trend(self, resource, historical_data): # Analyse de tendance simplifiée resource_history = historical_data[historical_data['resource'] == resource] # Régression linéaire simple from scipy import stats x = range(len(resource_history)) y = resource_history['utilization_pct'].values slope, intercept, r_value, p_value, std_err = stats.linregress(x, y) projected = slope * (len(x) + 3) + intercept # Projection 3 périodes return { 'direction': 'increasing' if slope > 0 else 'decreasing', 'slope': slope, 'projected_utilization': projected, 'confidence': r_value ** 2 } ``` ## Points clés d'implémentation 1. **Granularité appropriée** : Équilibrer entre détail (SKU-ressource) et agrégation (famille-workcentre) 2. **Fenêtre temporelle** : 3-18 mois typique pour RCCP, avec buckets hebdomadaires ou mensuels 3. **Données de qualité** : Temps standards maintenus, calendriers à jour, routages précis 4. **Flexibilité des contraintes** : Permettre ajustement des règles métier par utilisateur 5. **Performance** : Optimiser les calculs pour grands volumes (parallélisation, caching) 6. **Boucle de feedback** : Capturer résultats réels pour amélioration continue du modèle 7. **Intégration S&OP** : Synchroniser avec cycle S&OP mensuel et mise à jour IBP Cet outil RCCP assisté par AI transforme un processus manuel et chronophage en analyse automatisée avec recommandations actionnables, permettant aux planificateurs de se concentrer sur les décisions stratégiques plutôt que sur les calculs.

Un tutoriel pratique pour construire une application de décision centrée sur le planificateur avec Python, Streamlit et une couche d'explication AI.

Détection des valeurs aberrantes dans la Supply Chain 101 : Créer une équipe d'analyse du demand-sensing simple avec des agents AI

Expérience : créer une entreprise de Supply Chain as a Service avec OpenOPC

Connecter SAP Digital Manufacturing à Joule via MCP et Joule Studio

# Construire un agent de réapprovisionnement autonome gouverné pour SAP S/4HANA avec Claude et MCP ## Introduction La gestion du réapprovisionnement dans les environnements ERP d'entreprise nécessite à la fois une automatisation intelligente et une gouvernance stricte. Ce guide démontre comment construire un agent autonome pour SAP S/4HANA qui utilise Claude via le Model Context Protocol (MCP) pour prendre des décisions de réapprovisionnement tout en maintenant des garde-fous d'entreprise. ## Architecture de l'agent ### Composants principaux L'agent se compose de quatre couches : 1. **Couche MCP** : Expose les fonctions SAP et les données de réapprovisionnement à Claude 2. **Moteur de décision** : Claude analyse les niveaux de stock, la demande et les contraintes 3. **Cadre de gouvernance** : Valide les décisions selon les règles métier 4. **Couche d'exécution** : Exécute les commandes d'achat approuvées dans S/4HANA ### Flux de données ``` SAP S/4HANA → Serveur MCP → Claude → Validateur de gouvernance → SAP S/4HANA ``` ## Mise en œuvre du serveur MCP ### Définir les outils de réapprovisionnement Créez des outils MCP qui exposent les fonctions de réapprovisionnement critiques : ```python from mcp.server import Server from mcp.types import Tool, TextContent import sapnwrfc app = Server("sap-replenishment-mcp") @app.list_tools() async def list_tools() -> list[Tool]: return [ Tool( name="get_inventory_status", description="Récupère les niveaux de stock actuels, le stock de sécurité et le délai pour un SKU", inputSchema={ "type": "object", "properties": { "material_number": {"type": "string"}, "plant": {"type": "string"} }, "required": ["material_number", "plant"] } ), Tool( name="get_demand_forecast", description="Récupère les prévisions de demande pour un SKU sur un horizon temporel", inputSchema={ "type": "object", "properties": { "material_number": {"type": "string"}, "plant": {"type": "string"}, "horizon_days": {"type": "integer"} }, "required": ["material_number", "plant"] } ), Tool( name="get_supplier_info", description="Récupère les informations fournisseur incluant MOQ, prix et performance de livraison", inputSchema={ "type": "object", "properties": { "material_number": {"type": "string"}, "vendor": {"type": "string"} }, "required": ["material_number"] } ), Tool( name="create_purchase_requisition", description="Crée une demande d'achat pour approbation (n'exécute pas)", inputSchema={ "type": "object", "properties": { "material_number": {"type": "string"}, "quantity": {"type": "number"}, "plant": {"type": "string"}, "vendor": {"type": "string"}, "delivery_date": {"type": "string"}, "justification": {"type": "string"} }, "required": ["material_number", "quantity", "plant", "justification"] } ) ] ``` ### Implémenter les appels SAP Connectez les outils MCP aux fonctions SAP via RFC : ```python @app.call_tool() async def call_tool(name: str, arguments: dict) -> list[TextContent]: conn = sapnwrfc.Connection( user=SAP_USER, passwd=SAP_PASS, ashost=SAP_HOST, sysnr=SAP_SYSNR, client=SAP_CLIENT ) if name == "get_inventory_status": result = conn.call('BAPI_MATERIAL_STOCK_REQ_LIST', { 'MATERIAL': arguments['material_number'], 'PLANT': arguments['plant'] }) inventory_data = { 'current_stock': result['STOCK_QUANTITY'], 'safety_stock': result['SAFETY_STOCK'], 'reorder_point': result['REORDER_POINT'], 'lead_time_days': result['LEAD_TIME'], 'in_transit': result['IN_TRANSIT_QTY'] } return [TextContent( type="text", text=json.dumps(inventory_data, indent=2) )] elif name == "get_demand_forecast": result = conn.call('BAPI_DEMAND_FORECAST_GET', { 'MATERIAL': arguments['material_number'], 'PLANT': arguments['plant'], 'HORIZON': arguments.get('horizon_days', 90) }) return [TextContent( type="text", text=json.dumps(result['FORECAST_DATA'], indent=2) )] # Implémenter d'autres outils de manière similaire... ``` ## Invites d'agent pour Claude ### Invite système Définissez la personnalité et les contraintes de l'agent : ```python SYSTEM_PROMPT = """Vous êtes un agent de réapprovisionnement autonome pour SAP S/4HANA. Votre objectif est de maintenir des niveaux de stock optimaux tout en minimisant les coûts et en prévenant les ruptures de stock. Responsabilités : - Surveiller les niveaux de stock à travers les usines - Analyser les prévisions de demande et les tendances - Recommander des quantités de réapprovisionnement en tenant compte de MOQ, délais et contraintes budgétaires - Fournir une justification claire pour chaque décision Contraintes obligatoires : 1. Ne jamais dépasser les limites d'approbation d'achat (50 000€ par réquisition) 2. Respecter les contrats fournisseurs et MOQ 3. Maintenir le stock de sécurité au-dessus des niveaux minimum 4. Tenir compte de la saisonnalité et des tendances de demande 5. Vérifier le stock en transit avant de commander 6. Expliquer toutes les décisions avec des données Vous avez accès aux outils SAP via MCP pour interroger l'inventaire, les prévisions et les informations fournisseurs. Utilisez toujours des données pour soutenir vos recommandations. """ ``` ### Invite de tâche Créez des invites structurées pour les tâches de réapprovisionnement : ```python def create_replenishment_task(material_number: str, plant: str) -> str: return f"""Analyser les besoins de réapprovisionnement pour : - Numéro de matériel : {material_number} - Usine : {plant} Processus : 1. Récupérer le statut actuel de l'inventaire 2. Obtenir les prévisions de demande pour les 90 prochains jours 3. Vérifier le stock en transit 4. Examiner les informations et performance des fournisseurs 5. Calculer la quantité de commande optimale 6. Vérifier si le réapprovisionnement est nécessaire Si le réapprovisionnement est nécessaire : - Déterminer la quantité optimale (considérer MOQ, remises par paliers) - Sélectionner le meilleur fournisseur - Calculer la date de livraison requise - Créer une demande d'achat avec justification détaillée Fournir le raisonnement complet pour votre décision. """ ``` ## Cadre de gouvernance ### Validateur de règles Implémentez des vérifications de validation avant l'exécution : ```python class GovernanceValidator: def __init__(self, config: dict): self.max_purchase_value = config['max_purchase_value'] self.approved_vendors = config['approved_vendors'] self.required_approvers = config['required_approvers'] def validate_requisition(self, requisition: dict) -> tuple[bool, list[str]]: """Valide la demande d'achat selon les règles de gouvernance""" errors = [] # Vérifier les limites de valeur total_value = requisition['quantity'] * requisition['unit_price'] if total_value > self.max_purchase_value: errors.append( f"Valeur de réquisition {total_value}€ dépasse la limite {self.max_purchase_value}€. " "Approbation de niveau supérieur requise." ) # Vérifier les fournisseurs approuvés if requisition['vendor'] not in self.approved_vendors: errors.append( f"Fournisseur {requisition['vendor']} non dans la liste approuvée. " "Approbation d'achat requise." ) # Vérifier le stock de sécurité if requisition['resulting_stock'] < requisition['safety_stock']: errors.append( "La quantité commandée ne maintiendra pas le stock de sécurité. " "Augmenter la quantité de commande." ) # Vérifier le MOQ if requisition['quantity'] < requisition['moq']: errors.append( f"Quantité {requisition['quantity']} inférieure au MOQ {requisition['moq']}. " "Ajuster à la quantité minimum." ) # Vérifier les contraintes budgétaires budget_available = self.get_budget_available( requisition['plant'], requisition['cost_center'] ) if total_value > budget_available: errors.append( f"Fonds insuffisants. Requis : {total_value}€, Disponible : {budget_available}€" ) return len(errors) == 0, errors def get_budget_available(self, plant: str, cost_center: str) -> float: """Interroge SAP pour le budget disponible""" # Implémenter l'appel SAP pour vérifier le budget pass ``` ### Flux d'approbation Implémentez des approbations multi-niveaux basées sur la valeur : ```python class ApprovalWorkflow: def __init__(self): self.approval_levels = { 'L1': {'max_value': 10000, 'approvers': ['procurement_specialist']}, 'L2': {'max_value': 50000, 'approvers': ['procurement_manager']}, 'L3': {'max_value': float('inf'), 'approvers': ['cfo', 'procurement_director']} } def get_required_approvers(self, requisition_value: float) -> list[str]: """Détermine les approbateurs requis en fonction de la valeur""" for level, config in self.approval_levels.items(): if requisition_value <= config['max_value']: return config['approvers'] return self.approval_levels['L3']['approvers'] def submit_for_approval(self, requisition: dict, approvers: list[str]): """Soumet la réquisition pour approbation humaine""" approval_request = { 'requisition_id': requisition['id'], 'material': requisition['material_number'], 'quantity': requisition['quantity'], 'value': requisition['total_value'], 'vendor': requisition['vendor'], 'justification': requisition['justification'], 'agent_reasoning': requisition['agent_reasoning'], 'approvers': approvers, 'created_at': datetime.now().isoformat() } # Envoyer aux approbateurs via système de workflow self.send_approval_notification(approval_request) return approval_request['requisition_id'] ``` ## Orchestrateur de l'agent ### Boucle d'exécution principale Orchestrez le cycle complet de décision de l'agent : ```python from anthropic import Anthropic class ReplenishmentAgent: def __init__(self, mcp_server_url: str, governance_config: dict): self.client = Anthropic() self.mcp_url = mcp_server_url self.validator = GovernanceValidator(governance_config) self.workflow = ApprovalWorkflow() async def analyze_and_replenish(self, material_number: str, plant: str): """Exécute l'analyse de réapprovisionnement et la génération de décision""" # Créer la tâche pour Claude task_prompt = create_replenishment_task(material_number, plant) # Exécuter la conversation Claude avec accès MCP response = self.client.messages.create( model="claude-3-7-sonnet-20250219", max_tokens=4000, system=SYSTEM_PROMPT, messages=[{ "role": "user", "content": task_prompt }], tools=await self.get_mcp_tools() ) # Traiter la décision de l'agent decision = self.extract_decision(response) if decision['action'] == 'replenish': # Valider selon les règles de gouvernance is_valid, errors = self.validator.validate_requisition( decision['requisition'] ) if not is_valid: self.log_governance_violation(decision, errors) return { 'status': 'rejected', 'reason': errors, 'decision': decision } # Déterminer le flux d'approbation approvers = self.workflow.get_required_approvers( decision['requisition']['total_value'] ) # Soumettre pour approbation approval_id = self.workflow.submit_for_approval( decision['requisition'], approvers ) return { 'status': 'pending_approval', 'approval_id': approval_id, 'approvers': approvers, 'decision': decision } else: return { 'status': 'no_action_needed', 'reasoning': decision['reasoning'] } def extract_decision(self, response) -> dict: """Extrait la décision structurée de la réponse de Claude""" # Parcourir les appels d'outils et analyser la réponse finale # Extraire les détails de la réquisition si créée pass async def get_mcp_tools(self) -> list: """Récupère les définitions d'outils du serveur MCP""" # Se connecter au serveur MCP et lister les outils disponibles pass ``` ## Capacités de surveillance et d'audit ### Journal des décisions Enregistrez toutes les décisions de l'agent pour audit : ```python class DecisionLogger: def __init__(self, db_connection): self.db = db_connection def log_decision(self, decision: dict, context: dict): """Enregistre les décisions de l'agent avec le contexte complet""" log_entry = { 'timestamp': datetime.now().isoformat(), 'material_number': context['material_number'], 'plant': context['plant'], 'decision_type': decision['action'], 'reasoning': decision['reasoning'], 'data_used': decision['data_sources'], 'requisition_details': decision.get('requisition'), 'governance_checks': decision['governance_validation'], 'agent_model': 'claude-3-7-sonnet-20250219', 'approval_status': decision.get('approval_status') } self.db.insert('agent_decisions', log_entry) def get_decision_history(self, material_number: str, days: int = 90): """Récupère l'historique des décisions pour analyse""" return self.db.query( """ SELECT * FROM agent_decisions WHERE material_number = ? AND timestamp > datetime('now', '-' || ? || ' days') ORDER BY timestamp DESC """, (material_number, days) ) ``` ### Tableaux de bord de performance Suivez les KPI de l'agent : ```python class AgentMetrics: def __init__(self): self.metrics = { 'decisions_made': 0, 'requisitions_created': 0, 'governance_violations': 0, 'approval_rate': 0.0, 'avg_decision_time': 0.0, 'stockout_prevention': 0, 'cost_savings': 0.0 } def calculate_performance(self, time_period: str) -> dict: """Calcule les métriques de performance de l'agent""" decisions = self.get_decisions(time_period) return { 'total_decisions': len(decisions), 'auto_approved': len([d for d in decisions if d['auto_approved']]), 'human_reviewed': len([d for d in decisions if not d['auto_approved']]), 'rejection_rate': self.calculate_rejection_rate(decisions), 'avg_order_accuracy': self.calculate_order_accuracy(decisions), 'inventory_turns_improvement': self.calculate_turns_improvement(decisions), 'cost_per_decision': self.calculate_cost_efficiency(decisions) } ``` ## Déploiement en production ### Configuration de l'environnement ```yaml # config.yaml sap_connection: host: "sap-prod.company.com" client: "100" system_number: "00" mcp_server: host: "localhost" port: 8080 agent: model: "claude-3-7-sonnet-20250219" max_tokens: 4000 temperature: 0.0 # Déterministe pour les décisions de production governance: max_purchase_value: 50000 approved_vendors_file: "vendors.json" budget_check_enabled: true require_human_approval_over: 10000 monitoring: log_level: "INFO" metrics_export: true audit_retention_days: 2555 ``` ### Considérations de sécurité ```python class SecurityLayer: def __init__(self): self.encryption = AES256Encryption() self.audit_log = AuditLogger() def secure_sap_credentials(self, credentials: dict) -> dict: """Chiffre les identifiants SAP au repos""" return { 'user': self.encryption.encrypt(credentials['user']), 'password': self.encryption.encrypt(credentials['password']), 'encrypted': True } def validate_tool_access(self, tool_name: str, user_context: dict) -> bool: """Valide que l'agent peut accéder à l'outil SAP""" self.audit_log.log_access_attempt(tool_name, user_context) # Vérifier les permissions basées sur les rôles if tool_name == "create_purchase_requisition": return user_context['role'] in ['procurement_agent', 'admin'] return True ``` ## Gestion des cas limites ### Gestion des données manquantes ```python def handle_missing_data(material_number: str, plant: str) -> dict: """Gestion gracieuse lorsque les données SAP sont incomplètes""" try: inventory = get_inventory_status(material_number, plant) except DataNotFoundError: # Revenir aux paramètres par défaut ou escalader return { 'action': 'escalate', 'reason': 'Données d'inventaire manquantes pour décision', 'requires_human': True } if inventory['forecast_confidence'] < 0.6: # Faible confiance - utiliser une approche conservatrice return { 'action': 'conservative_replenish', 'quantity': inventory['safety_stock'] * 1.5, 'reason': 'Faible confiance de prévision - stock de sécurité augmenté' } return {'action': 'proceed'} ``` ### Scénarios de récupération ```python class RecoveryHandler: def handle_sap_connection_failure(self, error: Exception): """Gérer les pannes de connexion SAP""" self.logger.error(f"Échec de connexion SAP : {error}") # Essayer le système de secours if self.failover_available(): return self.connect_to_failover() # Passer en mode lecture seule self.switch_to_readonly_mode() self.notify_operations_team() def handle_governance_system_failure(self): """Lorsque le système de gouvernance est en panne""" # Arrêter toutes les créations de réquisitions automatiques self.pause_autonomous_actions() # Passer à l'approbation manuelle uniquement self.require_human_approval_all() # Alerter l'équipe de gouvernance self.send_alert("Système de gouvernance en panne - approbation manuelle requise") ``` ## Conclusion Cet agent de réapprovisionnement autonome démontre comment combiner les capacités de raisonnement de Claude avec les garde-fous de gouvernance d'entreprise via MCP. Les éléments clés incluent : 1. **Exposition structurée des données** via les outils MCP pour SAP 2. **Prise de décision guidée** par des invites système claires 3. **Validation multi-couches** via les cadres de gouvernance 4. **Supervision humaine** pour les décisions à enjeux élevés 5. **Traçabilité complète** via les journaux de décision et d'audit Cette architecture peut s'étendre à d'autres processus ERP autonomes tout en maintenant le contrôle et la conformité d'entreprise.

Un tutoriel orienté production pour concevoir, valider et contrôler un agent qui lit les données de planification SAP, calcule les besoins de réapprovisionnement et crée des demandes d'achat via des outils à portée étroite.

Vérifier si un agent IA Supply Chain est réel ou simplement agent-washé

Un cadre pratique pour évaluer les promesses fournisseurs, l’usage des outils et la gouvernance des décisions

Construire un registre gouverné des scénarios S&OP plutôt que de les gérer par email

Créer un registre unique pour les hypothèses, décisions et versions de plan approuvées

Réaliser un audit des master data de planification en une semaine

Identifier les paramètres qui créent le plus grand risque avant un projet système ou IA

Créer une matrice de décisions et de permissions pour les agents de planification Supply Chain

Définir ce que les agents peuvent lire, recommander, modifier et exécuter

Construire un workflow gouverné de revue des prévisions IA avant toute connexion au système de planification

Un workflow contrôlé pour les ajustements de prévision assistés par IA avec approbation du planificateur

Une Tour de Contrôle Multi-Agent Open-Source à l'Application de Décision Supply Chain Gouvernée

Analyse Dataleo de l'architecture d'identification des causes profondes de la supply chain de Vishal Vishwakarma et des risques de gouvernance à traiter avant utilisation en production

# Construire un Agent AI Simulation-First pour Surveiller les Échecs de Livraison de la Supply Chain Les échecs de livraison de la supply chain peuvent coûter des millions en revenus perdus, pénalités et érosion de la confiance client. Les tableaux de bord traditionnels vous indiquent *ce qui* a échoué, mais pas *pourquoi* ni *quoi faire ensuite*. Un agent AI simulation-first surveille en continu les performances de livraison, exécute des simulations de scénarios contrefactuels et recommande des actions correctives avant que les problèmes ne s'aggravent. ## Pourquoi Simulation-First pour la Surveillance des Échecs de Livraison Les approches de surveillance standard détectent les écarts après coup. Une approche simulation-first modélise le système de livraison en tant qu'entités dynamiques interagissantes — transporteurs, entrepôts, commandes, capacité — et teste comment les changements d'une variable affectent les résultats. Cela permet une détection précoce des problèmes, une attribution des causes racines et une planification proactive de la récupération. **Capacités clés :** - **Détection d'anomalies en temps réel** : identifier les écarts par rapport aux taux de livraison attendus par transporteur, voie ou région - **Attribution de cause racine** : simuler des scénarios contrefactuels pour isoler si les retards proviennent de la capacité transporteur, du débit entrepôt ou de pics de demande - **Optimisation de récupération** : tester des routages alternatifs, des changements de transporteur ou des réallocations d'inventaire pour minimiser l'impact - **Analyse prédictive** : prévoir les échecs de livraison probables avant qu'ils ne se produisent en fonction des contraintes de capacité et des tendances de demande ## Architecture de l'Agent AI ### 1. Couche d'Ingestion de Données Connectez-vous aux sources de données de livraison : - **Systèmes de gestion de transport (TMS)** : statuts d'expédition, données de tracking transporteur, heures de livraison promises vs réelles - **Systèmes de gestion d'entrepôt (WMS)** : temps de traitement des commandes, niveaux d'inventaire, débit - **Données de commande** : volumes de commande, priorités, SLA clients - **Facteurs externes** : météo, congestion trafic, jours fériés, perturbations transporteur Normalisez les données dans un schéma commun incluant : ID commande, transporteur, origine, destination, heure promise, heure réelle, statut, raison d'échec. ### 2. Moteur de Simulation Construisez un modèle de simulation à événements discrets de votre réseau de livraison : **Entités :** - Commandes (avec priorité, destination, fenêtres de temps) - Transporteurs (avec capacité, zones de service, taux de fiabilité) - Entrepôts (avec capacité de traitement, inventaire) - Véhicules/routes (avec contraintes de capacité) **Processus :** - Arrivée de commande → File d'attente → Traitement entrepôt → Attribution transporteur → Transit → Livraison - Modélisez la variabilité : temps de traitement, durées de transit, taux d'échec transporteur **Outils :** - **SimPy** (Python) pour simulation à événements discrets - **AnyLogic** pour modélisation multi-méthode (events discrets + dynamique) - **Simulation personnalisée** utilisant des méthodes Monte Carlo pour la variabilité ### 3. Module de Détection d'Anomalies Surveillez les métriques de livraison en temps réel vs. résultats de simulation : **Métriques à tracker :** - Taux de livraison à temps (OTDR) par transporteur, voie, région - Temps de cycle moyen : commande → expédition → livraison - Taux d'échec et catégories de raison (retardé, manqué, retourné) - Utilisation de capacité transporteur **Méthodes de détection :** - **Contrôle de processus statistique** : détecter quand les métriques dépassent les limites de contrôle - **ML basé sur anomalie** : isolation forest, autoencodeurs pour identifier les schémas inhabituels - **Détection de dérive** : comparer la distribution actuelle vs. baseline de simulation ```python import numpy as np from sklearn.ensemble import IsolationForest # Exemple : détecter les taux d'échec anormaux de transporteur def detect_carrier_anomalies(delivery_data): features = delivery_data[['avg_delay', 'failure_rate', 'capacity_utilization']] model = IsolationForest(contamination=0.05, random_state=42) anomalies = model.fit_predict(features) delivery_data['anomaly'] = anomalies flagged_carriers = delivery_data[delivery_data['anomaly'] == -1] return flagged_carriers ``` ### 4. Moteur d'Attribution de Cause Racine Lorsqu'un échec est détecté, exécutez des simulations contrefactuelles pour identifier la cause : **Approche :** 1. **Baseline** : simuler le scénario réel avec les paramètres actuels 2. **Contrefactuels** : modifier une variable à la fois et re-simuler - Augmenter la capacité transporteur de 20% - Réduire le temps de traitement entrepôt de 15% - Rerouter les commandes vers un transporteur alternatif - Augmenter les niveaux d'inventaire de 10% 3. **Comparer les résultats** : quelle modification élimine ou réduit le plus l'échec ? ```python # Simulation contrefactuelle simplifiée def run_counterfactual(scenario, parameter, adjustment): baseline_otdr = simulate_deliveries(scenario) # Modifier le paramètre scenario[parameter] *= adjustment counterfactual_otdr = simulate_deliveries(scenario) impact = counterfactual_otdr - baseline_otdr return impact # Tester plusieurs hypothèses causes = { 'carrier_capacity': run_counterfactual(scenario, 'carrier_capacity', 1.2), 'warehouse_throughput': run_counterfactual(scenario, 'processing_time', 0.85), 'demand_spike': run_counterfactual(scenario, 'order_volume', 0.9) } root_cause = max(causes, key=causes.get) ``` ### 5. Optimiseur de Récupération Une fois la cause racine identifiée, simulez des actions de récupération : **Options de récupération :** - **Changement de transporteur** : déplacer le volume vers des transporteurs avec capacité disponible - **Rérouting** : utiliser des chemins alternatifs ou des hubs - **Expédition accélérée** : surclasser les commandes critiques vers un service plus rapide - **Réallocation d'inventaire** : expédier depuis des sites alternatifs plus proches de la destination **Méthode d'optimisation :** - Formuler comme un problème OR : minimiser le coût total (pénalités retard + coûts transport + coûts opérationnels) - Contraintes : capacité transporteur, disponibilité inventaire, SLA clients - Résoudre en utilisant des solveurs OR (OR-Tools, Gurobi) ou des méthodes heuristiques ```python from ortools.linear_solver import pywraplp def optimize_recovery(orders, carriers, warehouses): solver = pywraplp.Solver.CreateSolver('SCIP') # Variables : x[i,j,k] = 1 si commande i est assignée au transporteur j depuis l'entrepôt k x = {} for i in orders: for j in carriers: for k in warehouses: x[i,j,k] = solver.BoolVar(f'x_{i}_{j}_{k}') # Fonction objectif : minimiser le coût total (transport + pénalités) objective = solver.Objective() for i in orders: for j in carriers: for k in warehouses: cost = carriers[j]['cost'] + warehouses[k]['distance'] * 0.1 if carriers[j]['estimated_delay'] > 0: cost += orders[i]['delay_penalty'] objective.SetCoefficient(x[i,j,k], cost) objective.SetMinimization() # Contraintes : chaque commande doit être assignée une fois for i in orders: solver.Add(solver.Sum([x[i,j,k] for j in carriers for k in warehouses]) == 1) # Contraintes de capacité for j in carriers: solver.Add(solver.Sum([x[i,j,k] for i in orders for k in warehouses]) <= carriers[j]['capacity']) status = solver.Solve() if status == pywraplp.Solver.OPTIMAL: return extract_solution(x, orders, carriers, warehouses) else: return None ``` ### 6. Module de Prédiction Entraînez des modèles ML pour prédire les échecs de livraison probables : **Features :** - Historique de performance transporteur (taux de livraison à temps, temps de transit moyen) - Conditions de commande (priorité, destination, taille) - Facteurs contextuels (jour de la semaine, saison, météo) - Métriques de capacité (utilisation transporteur, charge d'entrepôt) **Modèles :** - **Classification binaire** : livraison à temps vs. échec - **Régression** : temps de livraison prédit - **Analyse de survie** : probabilité d'échec au fil du temps ```python from sklearn.ensemble import GradientBoostingClassifier from sklearn.model_selection import train_test_split # Entraîner le prédicteur d'échec de livraison def train_failure_predictor(historical_data): features = ['carrier_id', 'origin', 'destination', 'order_priority', 'carrier_utilization', 'day_of_week', 'weather_severity'] target = 'delivery_failed' X = historical_data[features] y = historical_data[target] X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2) model = GradientBoostingClassifier(n_estimators=100, max_depth=5) model.fit(X_train, y_train) accuracy = model.score(X_test, y_test) print(f"Précision modèle : {accuracy:.2f}") return model # Prédire les échecs pour les commandes entrantes def predict_failures(model, incoming_orders): predictions = model.predict_proba(incoming_orders)[:, 1] incoming_orders['failure_probability'] = predictions high_risk = incoming_orders[incoming_orders['failure_probability'] > 0.3] return high_risk ``` ### 7. Interface Agent et Actions L'agent surveille en continu et agit : **Workflow d'agent :** 1. **Surveiller** : ingérer des données de livraison en temps réel 2. **Détecter** : exécuter la détection d'anomalies sur les métriques clés 3. **Analyser** : déclencher des simulations contrefactuelles pour l'attribution de cause racine 4. **Optimiser** : générer des plans de récupération en utilisant l'optimisation OR 5. **Prédire** : signaler les commandes à haut risque pour intervention proactive 6. **Agir** : recommander ou exécuter automatiquement des actions (avec approbation humaine pour les décisions coûteuses) **Exemples d'actions :** - Alerte : notifier la supply chain manager de l'augmentation des échecs transporteur - Recommander : suggérer le changement de transporteur pour les commandes à haut risque - Automatiser : réassigner automatiquement les commandes si l'impact projeté < seuil - Escalader : alerter les gestionnaires si le plan de récupération dépasse le budget ```python class DeliveryMonitorAgent: def __init__(self, simulation_engine, anomaly_detector, optimizer): self.simulation = simulation_engine self.detector = anomaly_detector self.optimizer = optimizer self.alert_threshold = 0.15 # Alerte si OTDR baisse > 15% def monitor(self, delivery_data): # Détecter les anomalies anomalies = self.detector.detect(delivery_data) if not anomalies.empty: for _, anomaly in anomalies.iterrows(): # Exécuter l'analyse de cause racine root_cause = self.diagnose(anomaly) # Générer le plan de récupération recovery_plan = self.optimizer.optimize( orders=anomaly['affected_orders'], root_cause=root_cause ) # Décider de l'action if recovery_plan['impact'] > self.alert_threshold: self.alert_manager(anomaly, root_cause, recovery_plan) else: self.execute_recovery(recovery_plan) def diagnose(self, anomaly): # Exécuter des simulations contrefactuelles scenarios = { 'carrier_capacity': self.simulation.run({'carrier_capacity': 1.2}), 'warehouse_delay': self.simulation.run({'processing_time': 0.85}), 'demand_spike': self.simulation.run({'order_volume': 0.9}) } root_cause = max(scenarios, key=lambda k: scenarios[k]['improvement']) return root_cause def alert_manager(self, anomaly, root_cause, recovery_plan): message = f""" Échec de livraison détecté : - Transporteur : {anomaly['carrier']} - OTDR impact : -{anomaly['otdr_drop']*100:.1f}% - Cause racine : {root_cause} - Plan de récupération : {recovery_plan['description']} - Impact coût estimé : ${recovery_plan['cost']:,.0f} """ send_alert(message, priority='high') def execute_recovery(self, recovery_plan): # Exécuter automatiquement pour les problèmes à faible impact execute_plan(recovery_plan) log_action(recovery_plan) ``` ## Métriques d'Implémentation et de Validation **Démarrer petit :** 1. **Pilote** : sélectionner une région ou un transporteur avec des données historiques d'échec élevées 2. **Construire baseline** : exécuter la simulation sur 3-6 mois de données historiques 3. **Calibrer** : ajuster les paramètres de simulation pour correspondre aux résultats réels 4. **Valider** : comparer les prédictions d'agent avec les échecs réels sur des données non vues **Métriques de succès :** - **Taux de détection** : % d'échecs réels détectés par l'agent - **Faux positifs** : % d'alertes qui n'ont pas conduit à de véritables échecs - **Temps de réponse** : temps moyen de détection jusqu'à la récupération - **Amélioration OTDR** : augmentation du taux de livraison à temps après intervention de l'agent - **Économies de coûts** : réduction des pénalités, expéditions accélérées, escalades clients **Benchmarks cibles :** - Détection 80%+ des échecs avant livraison manquée - Réduction de 30-50% des pénalités de livraison tardive - Réduction de 20%+ des coûts d'expédition accélérée réactive - ROI 3-6 mois via la réduction des pénalités et l'amélioration de la satisfaction client ## Pièges Courants **Qualité des données :** les données de livraison sont souvent fragmentées entre TMS, WMS, portails transporteur. Investir dans l'intégration de données et la normalisation d'abord. **Complexité de simulation :** commencer simple. Un modèle basique de file d'attente avec variabilité bat les tableaux de bord statiques. Ajouter de la complexité de manière itérative. **Sur-automatisation :** ne pas automatiser les décisions coûteuses sans approbation humaine. Utiliser l'agent pour recommander ; les humains décident des actions majeures. **Ignorer les facteurs externes :** la météo, les jours fériés, les grèves transporteur ont un impact majeur sur les livraisons. Incorporer des sources de données externes. **Fatigue des alertes :** trop d'alertes conduisent à l'ignorance. Calibrer les seuils pour signaler seulement les anomalies exploitables. ## Résultat Pratique Un agent AI simulation-first transforme la surveillance de livraison de réactive à proactive. Vous détectez les problèmes plus tôt, comprenez leurs causes racines et exécutez des récupérations optimisées — souvent avant que les clients ne remarquent. Cela nécessite un investissement dans l'intégration de données et la construction de simulation, mais les gains sont mesurables : moins de pénalités, des clients plus satisfaits, et une équipe supply chain qui résout les problèmes au lieu de les combattre. Commencez par une région pilote, prouvez la valeur, puis étendez à votre réseau. Les gains de fiabilité de livraison paient eux-mêmes l'investissement.

22 projets pratiques de Data Science pour les équipes Supply Chain