Le Laravel AI SDK est passé en version 1.4 le 13 novembre 2026. Le changement principal concerne la résilience des agents : une exception levée dans un outil ne met plus brutalement fin au run, elle est désormais transmise au modèle comme un résultat d’outil en échec. L’agent peut alors expliquer le problème ou tenter une autre approche, plutôt que de disparaître sans explication côté utilisateur.
Le problème que la 1.4 corrige
Avant cette version, une exception levée à l’intérieur d’un outil provoquait l’arrêt immédiat du run et le déclenchement de l’évènement AgentFailed. Le modèle ne voyait jamais le contenu de l’erreur : il n’avait donc aucune chance de la commenter, de la contourner ou de proposer un outil alternatif. Pour un agent de production branché sur une API externe instable, ce comportement transformait une simple erreur réseau en interruption complète de la conversation.
Ce que change la version 1.4
Le SDK transmet maintenant le message de l’exception au modèle sous la forme d’un résultat d’outil échoué, ce qui laisse le run se poursuivre normalement. L’exception continue malgré tout d’atteindre le gestionnaire d’exceptions de l’application, et l’évènement ToolFailed se déclenche toujours : rien n’est caché, le flux est simplement rendu récupérable. Seule exception à la règle : une exception levée par un listener d’évènement continue de faire échouer le run, puisqu’il ne s’agit plus d’une erreur d’outil au sens strict.
| Comportement | Avant la 1.4 | Depuis la 1.4 |
|---|---|---|
| Exception dans un outil | Arrêt du run, AgentFailed | Run poursuivi, erreur renvoyée au modèle |
Évènement ToolFailed | Déclenché | Toujours déclenché |
| Erreur de facturation OpenAI (HTTP 429) | RateLimitedException | InsufficientCreditsException, sans nouvelle tentative |
| Réponses classification / embedding / transcription | Pas de réponse brute | Réponse HTTP brute exposée |
Tester les approbations d’outils
Agent::fake() sait désormais reprendre une approbation d’outil mise en pause : un outil approuvé s’exécute et stocke son résultat, un outil rejeté reçoit un résultat refusé. De quoi écrire des tests de bout en bout sur des agents qui demandent une confirmation humaine avant d’agir, un cas fréquent pour les outils qui touchent à la facturation ou à l’envoi d’e-mails — le même souci de robustesse que celui qui a motivé la mise en place d’agents éditoriaux en production.
$agent = Agent::fake()
->toolCallPaused('envoyer_facture', ['client_id' => 42]);
$response = $agent->run('Envoie la facture au client 42');
$agent->assertToolCallApproved('envoyer_facture');
$response = $agent->approveToolCall('envoyer_facture');
$response->assertToolResult('envoyer_facture', fn ($result) => $result->ok());
Lire les réponses brutes des fournisseurs
Les réponses de classification, d’embedding, de transcription, d’image et de reclassement exposent désormais leur réponse HTTP brute, comme c’était déjà le cas pour les réponses texte. Cela permet de lire des champs non mappés par le SDK, par exemple le coût renvoyé par OpenRouter dans usage.cost.
Une exception dans un outil n’arrête plus le run : elle devient un résultat que le modèle peut lire, commenter et contourner.
Migration à vérifier : le code qui interceptait RateLimitedException pour les erreurs de facturation OpenAI doit désormais intercepter InsufficientCreditsException. Les listeners qui dépendent du nom d’évènement fixe error pour les erreurs de streaming, et ceux qui reçoivent les évènements d’agent, doivent aussi filtrer sur parentInvocationId pour distinguer les runs de génération de titre des runs normaux.
Ce qu’il faut retenir
Le Laravel AI SDK 1.4 rend les agents plus tolérants aux pannes d’outils sans rien masquer aux gestionnaires d’exceptions existants. L’ajout des tests d’approbation et des réponses brutes comble deux manques signalés depuis la sortie de la 1.1 en octobre, dans un écosystème d’outillage agentique encore jeune où même la spécification MCP continue d’évoluer. Le guide pilier sur l’IA pour les développeurs replace ce changement dans l’ensemble des outils agentiques disponibles côté backend.
C’est le genre de changement qu’on ne remarque qu’au moment où il manque. Un agent qui s’écroule à la première erreur réseau d’un fournisseur tiers, c’est le signal qu’on a conçu un outil comme un appel de fonction classique et pas comme ce qu’il est vraiment : une requête qui peut échouer pour des raisons hors de son contrôle — Simon Janvier.
Pour aller plus loin : l’annonce détaillée du Laravel AI SDK 1.4 sur Laravel News.
