Aller au contenu

Le média des artisans du web mercredi 18 novembre 2026

IA pour le web

Laravel AI SDK 1.4 permet aux agents de survivre à l’échec d’un outil

La version 1.4 du Laravel AI SDK, publiée le 13 novembre, transmet au modèle l'erreur d'un outil qui échoue au lieu d'arrêter le run. Les tests d'approbation d'outils et les réponses HTTP brutes des fournisseurs IA en profitent aussi.

Laravel AI SDK 1.4 permet aux agents de survivre à l'échec d'un outil

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.

ComportementAvant la 1.4Depuis la 1.4
Exception dans un outilArrêt du run, AgentFailedRun poursuivi, erreur renvoyée au modèle
Évènement ToolFailedDéclenchéToujours déclenché
Erreur de facturation OpenAI (HTTP 429)RateLimitedExceptionInsufficientCreditsException, sans nouvelle tentative
Réponses classification / embedding / transcriptionPas de réponse bruteRé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.

Partager LinkedIn Bluesky Hacker News E-mail

À lire aussi