Das Laravel AI SDK ist am 13. November 2026 auf Version 1.4 gewechselt. Die zentrale Änderung betrifft die Widerstandsfähigkeit von Agenten: Eine Exception innerhalb eines Tools beendet den Run nicht mehr abrupt. Stattdessen wird sie dem Modell als fehlgeschlagenes Tool-Ergebnis zurückgegeben. Der Agent kann das Problem dann erklären oder einen anderen Ansatz versuchen, statt beim Nutzer einfach kommentarlos zu verschwinden.
Das Problem, das die 1.4 löst
Vor dieser Version beendete eine innerhalb eines Tools geworfene Exception den Run sofort und löste das Ereignis AgentFailed aus. Das Modell bekam den Inhalt des Fehlers nie zu sehen und hatte daher keine Chance, ihn zu kommentieren, zu umgehen oder ein alternatives Tool vorzuschlagen. Bei einem Produktions-Agenten, der an eine instabile externe API angebunden ist, machte dieses Verhalten aus einem simplen Netzwerkfehler einen kompletten Gesprächsabbruch.
Was sich in der 1.4 ändert
Das SDK gibt die Fehlermeldung der Exception nun als fehlgeschlagenes Tool-Ergebnis an das Modell zurück, sodass der Run normal weiterläuft. Die Exception erreicht weiterhin den Exception-Handler der Anwendung, und das Ereignis ToolFailed wird weiterhin ausgelöst: Nichts wird verborgen, der Ablauf wird lediglich wiederherstellbar gemacht. Eine Ausnahme von der Regel: Eine von einem Event-Listener geworfene Exception lässt den Run weiterhin fehlschlagen, da es sich dabei im engeren Sinn nicht mehr um einen Tool-Fehler handelt.
| Verhalten | Vor der 1.4 | Seit der 1.4 |
|---|---|---|
| Exception in einem Tool | Run stoppt, AgentFailed | Run läuft weiter, Fehler geht ans Modell zurück |
Ereignis ToolFailed | Wird ausgelöst | Wird weiterhin ausgelöst |
| OpenAI-Abrechnungsfehler (HTTP 429) | RateLimitedException | InsufficientCreditsException, ohne erneuten Versuch |
| Antworten für Klassifizierung / Embedding / Transkription | Keine Rohantwort | Rohe HTTP-Antwort verfügbar |
Tool-Freigaben testen
Agent::fake() kann nun eine pausierte Tool-Freigabe fortsetzen: Ein freigegebenes Tool läuft und speichert sein Ergebnis, ein abgelehntes Tool erhält ein verweigertes Ergebnis zurück. Damit lassen sich End-to-End-Tests für Agenten schreiben, die vor dem Handeln eine menschliche Bestätigung benötigen — ein häufiger Fall bei Tools, die Abrechnung oder E-Mail-Versand betreffen.
$agent = Agent::fake()
->toolCallPaused('rechnung_senden', ['client_id' => 42]);
$response = $agent->run('Sende die Rechnung an Kunde 42');
$agent->assertToolCallApproved('rechnung_senden');
$response = $agent->approveToolCall('rechnung_senden');
$response->assertToolResult('rechnung_senden', fn ($result) => $result->ok());
Rohe Antworten der Anbieter auslesen
Antworten für Klassifizierung, Embedding, Transkription, Bild und Reranking legen nun ihre rohe HTTP-Antwort offen, wie es bei Textantworten bereits der Fall war. Dadurch lassen sich Felder auslesen, die das SDK nicht abbildet, etwa die von OpenRouter in usage.cost zurückgegebenen Kosten.
Eine Exception innerhalb eines Tools stoppt den Run nicht mehr: Sie wird zu einem Ergebnis, das das Modell lesen, kommentieren und umgehen kann.
Migration prüfen: Code, der bisher RateLimitedException für OpenAI-Abrechnungsfehler abgefangen hat, sollte nun InsufficientCreditsException abfangen. Listener, die sich auf den festen Ereignisnamen error für Streaming-Fehler verlassen, sowie solche, die Agenten-Ereignisse empfangen, sollten zudem nach parentInvocationId filtern, um Titel-Generierungsläufe von normalen Runs zu unterscheiden.
Was bleibt
Laravel AI SDK 1.4 macht Agenten toleranter gegenüber Tool-Fehlern, ohne den bestehenden Exception-Handlern etwas zu verbergen. Die neuen Freigabetests und Rohantworten schließen zwei Lücken, die seit dem Erscheinen der 1.1 im Oktober bemängelt wurden — in einem noch jungen Ökosystem agentischer Werkzeuge, in dem sich sogar die MCP-Spezifikation weiterentwickelt. Der Leitfaden zu KI für Webentwickler ordnet diese Änderung in das größere Angebot agentischer Backend-Werkzeuge ein.
Das ist die Art von Änderung, die man erst bemerkt, wenn sie fehlt. Ein Agent, der beim ersten Netzwerkfehler eines Drittanbieters zusammenbricht, zeigt, dass das Tool wie ein gewöhnlicher Funktionsaufruf entworfen wurde und nicht wie das, was es wirklich ist: eine Anfrage, die aus Gründen scheitern kann, die vollständig außerhalb ihrer Kontrolle liegen — Simon Janvier.
Zum Weiterlesen: die ausführliche Ankündigung von Laravel AI SDK 1.4 bei Laravel News.
