Laravel AI SDK: embeddings y generación de texto

Qué es el Laravel AI SDK

Laravel 13 introduce el Laravel AI SDK, la primera integración oficial del framework con modelos de IA. Soporta:

• Generación de texto (chat, completions)
• Herramientas para agentes
• Embeddings (vectores para búsqueda semántica)
• Audio e imágenes (según proveedor)

Los proveedores compatibles incluyen OpenAI, Anthropic, Google y otros. Configura las claves de API en .env (OPENAI_API_KEY, etc.).

Generar embeddings

Los embeddings son vectores numéricos que representan el significado de un texto. Sirven para búsqueda por similitud semántica.

El modelo de embeddings del proveedor transforma el texto en un vector de números reales. Ese vector es el que luego compararás con otros (por similitud) o almacenarás en una base con soporte vectorial.

flowchart LR
  T[Texto de entrada]
  P[Modelo de embeddings]
  V[Vector de floats]
  T --> P --> V

El AI SDK proporciona helpers como Str::toEmbeddings() para cadenas:

use Illuminate\Support\Str;

$embedding = Str::of('Napa Valley tiene los mejores vinos.')->toEmbeddings();
// Devuelve un array de floats (vector)

Para múltiples textos en batch, se usa la API de embeddings del SDK, que devuelve una colección de vectores. El número de dimensiones depende del modelo configurado (por ejemplo, 1536 para text-embedding-ada-002 de OpenAI).

Generación de texto

El SDK permite generar texto (chat, completions) conectando con proveedores como OpenAI o Anthropic. La configuración se define en config/ai.php y las claves de API en .env. Una vez configurado, se invoca el servicio correspondiente para obtener respuestas de lenguaje natural. El SDK abstrae el proveedor; puedes cambiar de OpenAI a Anthropic sin modificar la lógica de la aplicación.

Consulta la documentación oficial de Laravel AI para la sintaxis exacta de cada método según la versión que uses.