Laravel AI SDK pasó a la versión 1.4 el 13 de noviembre de 2026. El cambio principal afecta a la resiliencia de los agentes: una excepción lanzada dentro de una herramienta ya no termina de forma abrupta la ejecución. Ahora se transmite al modelo como un resultado de herramienta fallido. El agente puede entonces explicar el problema o intentar otro enfoque, en lugar de desaparecer sin más ante el usuario.
El problema que corrige la 1.4
Antes de esta versión, una excepción lanzada dentro de una herramienta terminaba de inmediato la ejecución y disparaba el evento AgentFailed. El modelo nunca veía el contenido del error, por lo que no tenía ninguna posibilidad de comentarlo, sortearlo o proponer una herramienta alternativa. Para un agente en producción conectado a una API externa inestable, este comportamiento convertía un simple fallo de red en una interrupción completa de la conversación.
Qué cambia en la 1.4
El SDK ahora transmite el mensaje de la excepción al modelo como un resultado de herramienta fallido, lo que permite que la ejecución continúe con normalidad. La excepción sigue llegando al gestor de excepciones de la aplicación, y el evento ToolFailed sigue disparándose: nada queda oculto, el flujo simplemente se vuelve recuperable. Una excepción a la regla: una excepción lanzada por un listener de eventos sigue haciendo fallar la ejecución, ya que deja de ser un error de herramienta en sentido estricto.
| Comportamiento | Antes de la 1.4 | Desde la 1.4 |
|---|---|---|
| Excepción en una herramienta | Se detiene la ejecución, AgentFailed | La ejecución continúa, el error se devuelve al modelo |
Evento ToolFailed | Se dispara | Sigue disparándose |
| Error de facturación de OpenAI (HTTP 429) | RateLimitedException | InsufficientCreditsException, sin reintento |
| Respuestas de clasificación / embedding / transcripción | Sin respuesta sin procesar | Respuesta HTTP sin procesar expuesta |
Probar las aprobaciones de herramientas
Agent::fake() ahora puede reanudar una aprobación de herramienta en pausa: una herramienta aprobada se ejecuta y guarda su resultado, una herramienta rechazada recibe un resultado denegado. Esto permite escribir pruebas de extremo a extremo para agentes que requieren confirmación humana antes de actuar, un caso habitual en herramientas que tocan la facturación o el envío de correos.
$agent = Agent::fake()
->toolCallPaused('enviar_factura', ['client_id' => 42]);
$response = $agent->run('Envía la factura al cliente 42');
$agent->assertToolCallApproved('enviar_factura');
$response = $agent->approveToolCall('enviar_factura');
$response->assertToolResult('enviar_factura', fn ($result) => $result->ok());
Leer las respuestas sin procesar de los proveedores
Las respuestas de clasificación, embedding, transcripción, imagen y reordenamiento exponen ahora su respuesta HTTP sin procesar, como ya ocurría con las respuestas de texto. Esto permite leer campos que el SDK no mapea, como el coste que devuelve OpenRouter en usage.cost.
Una excepción dentro de una herramienta ya no detiene la ejecución: se convierte en un resultado que el modelo puede leer, comentar y sortear.
Migración a revisar: el código que capturaba RateLimitedException para los errores de facturación de OpenAI debe capturar ahora InsufficientCreditsException. Los listeners que dependen del nombre de evento fijo error para los fallos de streaming, así como los que reciben eventos de agente, también deben filtrar por parentInvocationId para distinguir las ejecuciones de generación de título de las ejecuciones normales.
Lo que hay que recordar
Laravel AI SDK 1.4 hace que los agentes toleren mejor los fallos de herramientas sin ocultar nada a los gestores de excepciones existentes. La incorporación de las pruebas de aprobación y las respuestas sin procesar cubre dos carencias señaladas desde la salida de la 1.1 en octubre, en un ecosistema de herramientas agénticas aún joven donde incluso la especificación MCP sigue evolucionando. La guía de referencia sobre IA para desarrolladores web sitúa este cambio dentro del conjunto más amplio de herramientas agénticas disponibles en el backend.
Es el tipo de cambio que solo se nota cuando falta. Un agente que se desmorona ante el primer fallo de red de un proveedor externo es la señal de que se diseñó la herramienta como una simple llamada a función, y no como lo que realmente es: una petición que puede fallar por motivos completamente fuera de su control — Simon Janvier.
Para saber más: el anuncio detallado de Laravel AI SDK 1.4 en Laravel News.
