Laravel AI SDK 1.1.0 se publicó el 7 de octubre de 2026. Es la primera versión menor desde 1.0. Incorpora nuevas funciones para agentes y otro proveedor de texto. También cambia el comportamiento del failover entre proveedores.

terminal
composer require laravel/ai:^1.1

El SDK ya admite Agent Skills, un estándar basado en carpetas que permite a los agentes de programación cargar instrucciones cuando una tarea las necesita. Cada skill se ubica en resources/skills y contiene un archivo SKILL.md. El front matter debe incluir description. name es opcional y, si falta, toma el nombre de la carpeta. El ejemplo refund-policy incluye también references/EDGE-CASES.md. Sus instrucciones piden comprobar la fecha del pedido antes de gestionar un reembolso o un crédito parcial para pedidos de más de 30 días. Pushpak Chhajed señaló que el equipo había rechazado esta función dos veces. El formato se ha convertido en un estándar usado por muchas herramientas. Los cambios corresponden a las PR #1054 y #1102.

Un agente expone sus skills mediante Laravel\Ai\Contracts\HasSkills junto con Laravel\Ai\Contracts\Agent y Laravel\Ai\Promptable. El SDK ofrece una única herramienta LoadSkill. Primero muestra los nombres y las descripciones. Después permite que el modelo solicite las instrucciones completas o un archivo incluido en la carpeta del skill. La fuente puede ser un directorio, un objeto Skill creado en PHP o una closure. La closure se ejecuta cuando la herramienta lee los skills por primera vez, lo que permite cargarlos desde la base de datos para cada usuario. La ruta .agents/skills permite que los agentes de la aplicación compartan skills con un agente de programación.

También se puede añadir LoadSkill([...]) directamente en tools(). Si se usan ambos métodos, el SDK fusiona los skills en una sola herramienta y registra una advertencia, porque los proveedores rechazan nombres de herramientas duplicados. El acceso a archivos queda limitado a la carpeta del skill. Los archivos de más de 256 KB y los binarios se rechazan.

Cohere incorpora generación de texto mediante su API v2 Chat. El proveedor ya estaba disponible para embeddings y reranking. Mojtaba Sayari añadió streaming, llamadas a herramientas, salida estructurada y razonamiento. El modelo predeterminado es command-a-03-2025. Un agente puede elegir Cohere con prompt('Hello', provider: 'cohere'). Cohere no puede imponer una herramienta concreta. ToolChoice::tool('X') envía únicamente X y marca la llamada como obligatoria. Todavía no se admiten adjuntos de documentos ni citas. Las opciones del proveedor sí pueden recibir valores como documents y safety_mode. La PR #1078 contiene esta integración.

Las herramientas MCP, de agente, de búsqueda por similitud y de sistema de archivos implementan ahora Approvable. La aplicación puede llamar a requireApproval() para exigir aprobación en esas herramientas integradas. En una configuración de GitHub MCP, puede revisar annotations()['readOnlyHint'] y solicitar aprobación para cada herramienta que no esté marcada como de solo lectura. La aprobación está desactivada por defecto, por lo que los agentes existentes conservan su comportamiento. La función llega con la PR #1097.

El failover continúa cuando el siguiente proveedor no admite alguna herramienta del proveedor activo. Antes, un agente con WebFetch y WebSearch podía fallar después de que una petición limitada por Anthropic pasara a OpenAI. OpenAI devolvía entonces RuntimeException: Provider [openai] does not support the [WebFetch] tool. El bucle de generación elimina ahora, antes de cada intento, las herramientas que el proveedor actual no admite. La ejecución puede seguir con WebSearch. En proveedores sin búsqueda de herramientas alojada, el SDK desenvuelve ToolSearch y envía sus herramientas como herramientas normales. El uso de más de un wrapper ToolSearch todavía produce un error con cualquier proveedor. La PR #1080 implementa este cambio.

La clasificación puede ejecutarse ahora contra un servidor Laya autoalojado de NandhaKishorM/laya mediante el controlador typesafe existente. La conexión laya usa driver con el valor typesafe, obtiene la clave de LAYA_API_KEY y la URL de LAYA_URL. La URL predeterminada es http://localhost:8000/v1. El modelo predeterminado para classification es auto. La llamada es Classification::of($ticket)->questions($questions)->classify(provider: 'laya'). Los metadatos de la respuesta indican qué checkpoint de Laya procesó la solicitud. La PR #1081 añade esta capacidad.

ToolSearch funciona ahora con Azure OpenAI. En Groq, WebSearch se traduce a browser_search y CodeExecution a code_interpreter. Groq ofrece ambas funciones únicamente en sus modelos GPT-OSS e ignora max(), allow() y location() en WebSearch. WebSearch también envía ahora location a OpenRouter. Estas adaptaciones aparecen en las PR #1098 y #1099.

Los agentes reciben MoveFile, que permite renombrar o mover un archivo en una sola llamada. La PR #1092 elimina la secuencia de copiar y borrar. Los modelos de respaldo se actualizaron para la mayoría de los proveedores. Anthropic usa ahora claude-sonnet-5-5 por defecto y Gemini usa gemini-3.8-flash. Las aplicaciones que no fijan sus modelos en config/ai.php recibirán los nuevos valores después de actualizar. La PR #1095 contiene estos cambios.

La versión corrige además la reproducción de búsquedas de archivos sin estado de OpenAI en la PR #1089, la sustitución de un mensaje de usuario useChat editado por la respuesta del asistente en la PR #1076 y la ubicación incorrecta de los parámetros de consulta de ElevenLabs en la PR #1103. La guía de actualización desde 1.0 exige ahora laravel/boost 2.10.0 o posterior para el comando de actualización de Boost. También documenta el conflicto del SDK con versiones de laravel/mcp anteriores a 1.0. Ese cambio pertenece a la PR #1087.

Una aplicación existente puede actualizarse con Composer mediante laravel/ai:^1.1.