Prefacio
Toda función de IA queda bien en una demo.
Conectas un modelo a un controlador, escribes una frase y vuelve algo notable. La sala se queda en silencio. Alguien dice que hay que publicarlo ya.
Y funciona de inmediato. Ese es justamente el problema.
Luego llega a producción y descubres que la parte notable nunca fue la parte difícil. La parte difícil es la petición que tardó noventa segundos. La que devolvió prosa cuando pediste JSON. Aquella en la que un usuario pulsó el botón once veces y cada pulsación te costó dinero. Aquella en la que el modelo, cuando se lo pidieron con educación, creó dos veces el mismo recurso de pago.
Nada de eso es un problema de IA. Son los problemas de ingeniería de siempre, los que ya sabes resolver —tiempos de espera, idempotencia, límites de uso, fronteras de confianza, reintentos—, disfrazados.
Ese es todo el argumento de este libro.
El modelo es la parte menos interesante de tu función de IA.
De qué trata este libro
Este libro trata de construir funciones de IA en Laravel que sobrevivan a usuarios reales: funciones que cuestan lo que esperabas, que fallan como tenías previsto y que se pueden entregar a otra persona sin una sesión de espiritismo.
Usa como ejemplo un sistema en producción: una plataforma donde un agente conversacional recoge lo que alguien quiere, lo comprueba, verifica su correo y aprovisiona un sitio web real, publicado y facturable mientras el usuario mira. Ese agente llama a herramientas. Esas herramientas tienen efectos que no se pueden deshacer. Se ha equivocado, ha ido lento y lo han convencido de hacer cosas. Todo lo que hay aquí se aprendió arreglando eso.
No encontrarás folclore sobre prompts, ni una comparativa de seis modelos. Encontrarás el código que rodea al modelo: el gestor que aísla al proveedor, el trabajo en cola que sobrevive a un turno demasiado largo, la herramienta que se niega a crear dos veces lo mismo, y el registro que te dice qué pasó cuando no puedes reproducirlo.
Para quién es este libro
Para desarrolladores de Laravel que se manejan con HTTP, colas y pruebas, y que están a punto de poner un modelo delante de sus usuarios —o que ya lo hicieron y ahora conviven con las consecuencias.
No necesitas saber nada de aprendizaje automático. Nada de este libro lo requiere. Si sabes escribir un FormRequest, despachar un job y simular un cliente HTTP en una prueba, tienes todas las habilidades que este libro pide.
Deberías desconfiar de las funciones de IA. Eso es un requisito, no un defecto.
Si has publicado un chat y luego has mirado la factura del proveedor, este libro es para ti. Si te están pidiendo añadir «IA» a un producto y te gustaría que el resultado siguiera siendo mantenible el trimestre que viene, este libro es para ti. Si tu función de IA funciona y no sabes explicar por qué, este libro es muy especialmente para ti.