Les erreurs ne sont pas le problème. Le silence, si.

Tous les développeurs back-end connaissent les erreurs HTTP 500. Elles surviennent. Elles sont inévitables. Et lorsqu'elles se produisent, le système réagit généralement comme il le fait depuis des décennies :

Crash. Journal. Passer à autre chose.

Et si une erreur pouvait faire plus que simplement échouer ? Et si elle pouvait s'expliquer d'elle-même ?

C’est ainsi qu’est né Darkwood IaExceptionBundle : un bundle Symfony qui enrichit les erreurs HTTP 500 avec des explications générées par l’IA, les causes probables et des suggestions de correction, le tout basé sur Symfony AI.

Les frameworks modernes excellent dans les domaines suivants :

• Levée d'exceptions précises

• Production de traces de pile

• Exportation des journaux vers des plateformes d'observabilité

Pourtant, la responsabilité de comprendre une erreur incombe toujours aux humains.

Le système sait :

• quelle exception a été levée

• où cela s'est produit

• dans quelles conditions

Mais le silence persiste. Le développeur doit reconstituer le sens à partir de fragments.

Au lieu de demander :

Comment corrigeons-nous les erreurs automatiquement ?

Nous avons demandé quelque chose de plus modeste :

Et si le système pouvait expliquer ce qui vient de se passer — en termes humains ?

Non pas pour remplacer les outils de débogage. Non pas pour réparer quoi que ce soit. Juste pour formuler des hypothèses plus rapidement.

Symfony est particulièrement bien placé pour ce type d'expérimentation :

• un environnement d'exécution unique et bien défini

• un point d'extension kernel.exception explicite

• une culture de modules optionnels

• et maintenant, un point d'intégration de premier ordre via Symfony AI

Il ne s'agit pas d'une fonctionnalité essentielle du framework, et cela ne devrait pas l'être. Son utilisation doit rester optionnelle, limitée et réversible.

En cas d'erreur HTTP 500, le bundle peut générer :

• Une explication claire en anglais de l'exception

• Les causes probables

• Les solutions proposées / les prochaines étapes

• Un score de confiance

• Un identifiant d'erreur pour la corrélation

• Ce programme ne corrige pas les bogues.

• Il ne remplace pas Sentry/les journaux.

• Il ne garantit pas l'exactitude des résultats.

• Il ne s'exécute pas s'il n'est pas activé.

C'est un assistant, pas une autorité.

Les erreurs peuvent contenir des informations sensibles. C'est pourquoi le package est conçu pour être sécurisé par défaut :

• Il n'envoie jamais d'en-têtes, de cookies, de variables d'environnement ni de données de requête au modèle.

• Les traces de pile sont exclues par défaut (option réservée aux développeurs).

• En cas d'échec ou de délai d'attente de l'IA : la gestion des erreurs 500 par défaut de Symfony s'exécute normalement (compatibilité avec les défaillances).

• Le statut de la réponse reste 500 ; seul le corps de la réponse est modifié.

• PHP 8.2+

• Symfony 6.4+ également compatible avec 7.x / 8.x

• Plateforme et agent symfony/ai-bundle configurés

composer require darkwood/ia-exception-bundle

Si Symfony Flex ne l'enregistre pas automatiquement, ajoutez-le à config/bundles.php :

return [ // ... Darkwood\IaExceptionBundle\DarkwoodIaExceptionBundle::class => ['all' => true], ];

Exemple de configuration OpenAI :

# config/packages/ai.yaml
ai:
platform:
openai:
api_key: '%env(OPENAI_API_KEY)%'
agent:
default:
model: 'gpt-4o-mini'

# config/packages/darkwood_ia_exception.yaml darkwood_ia_exception:
enabled: true
only_status_codes: [500]
agent: 'ai.agent.default'
timeout_ms: 800
cache_ttl: 600
cache: 'cache.app'
include_trace: false

Pour garantir le délai d'expiration au niveau HTTP, configurez un client HTTP à portée limitée pour votre plateforme d'IA :

# config/packages/ai.yaml
framework:
http_client:
scoped_clients:
ai.timeout_client:
base_uri: 'https://api.openai.com'
timeout: 0.8
ai:
platform:
openai:
api_key: '%env(OPENAI_API_KEY)%'
http_client: 'ai.timeout_client'

Si la requête inclut Accept: application/json, le bundle renvoie un JSON structuré comme suit :

{
"error_id": "a1b2c3d4e5f6g7h8",
"english_exception": "La connexion à la base de données a échoué ou une table requise est manquante.",
"probable_causes": ["..."],
"suggested_fixes": ["..."],
"confidence": 0.85
}

Sinon, il génère une page HTML affichant :

• ID de l'erreur

• Explication de l'IA

• Causes et suggestions

• Score de confiance

• Classe/message d'exception d'origine

• Avertissement : les résultats sont des hypothèses

Nous avons passé des années à rendre nos systèmes plus résilients. Nous avons amélioré les journaux, les tableaux de bord et les alertes.

L'étape suivante est peut-être plus simple :

Améliorer la capacité des systèmes à s'expliquer.

Non pas pour remplacer les développeurs, mais pour les aider à penser plus vite, avec un meilleur contexte.

Ce bundle est aussi une expérimentation de l'intégration des erreurs générés par l'IA dans Symfony

Vous pouvez contribuer en vous rendant sur le dépot github Darkwood IaExceptionBundle