Comment utiliser le SDK Laravel AI en production : agents, outils, streaming et RAG

DEV - 10/02
1) Qu'est-ce que « Laravel AI » ? Laravel a divisé l'IA en trois parties propriétaires : ...

1) Qu’est-ce que « Laravel AI » ?

Laravel a divisé l'IA en trois éléments propriétaires :

SDK Laravel AI (fonctionnalités IA intégrées à l'application)

Un package propriétaire que vous installez dans votre application Laravel pour créer des fonctionnalités d'IA avec une API unifiée entre les fournisseurs : agents, outils, sortie structurée, multimodal (images/audio), intégrations, reclassement, fichiers, magasins de vecteurs et basculement.

Laravel Boost (meilleur codage assisté par IA dans votre dépôt)

Une dépendance de développement qui installe un serveur MCP + des directives/compétences afin que des outils comme Cursor / Claude Code / etc obtiennent un contexte précis sur votre application Laravel (itinéraires, schéma, configuration, journaux, connaissances documentaires).

Laravel MCP (exposez votre application en tant que serveur MCP)

Un package/modèle pour créer des serveurs MCP dans Laravel : définir des outils (actions), des ressources (données en lecture seule) et des invites (modèles), sécurisés avec les modèles middleware/OAuth/Sanctum de Laravel.

2) SDK Laravel AI : installer + configurer

Étape 1 — Installez le package

le compositeur nécessite laravel/ai
Entrer en mode plein écran Quitter le mode plein écran

Étape 2 — Publier la configuration + les migrations

php artisan supplier:publish --provider="Laravel\Ai\AiServiceProvider" php artisan migrate
Entrer en mode plein écran Quitter le mode plein écran

Cela crée les tables utilisées pour le stockage des conversations :conversation_agentetagent_conversation_messages.

Étape 3 — Ajoutez les clés du fournisseur dans.env

Laravel AI SDK prend en charge plusieurs fournisseurs ; vous pouvez les configurer viaconfig/ai.phpou variables d'environnement. Les clés d'environnement courantes incluent :

OPENAI_API_KEY= ANTHROPIC_API_KEY= GEMINI_API_KEY= MISTRAL_API_KEY= OLLAMA_API_KEY= XAI_API_KEY= COHERE_API_KEY= JINA_API_KEY= VOYAGEAI_API_KEY= ELEVENLABS_API_KEY=
Entrer en mode plein écran Quitter le mode plein écran

Étape 4 — (Facultatif) définir des URL de base personnalisées

Utile si vous passez par LiteLLM/passerelles/proxys :

'providers' => [ 'openai' => [ 'driver' => 'openai', 'key' => env('OPENAI_API_KEY'), 'url' => env('OPENAI_BASE_URL'), ], ],
Entrer en mode plein écran Quitter le mode plein écran

Les URL de base personnalisées sont prises en charge pour plusieurs fournisseurs (OpenAI/Anthropic/Gemini/Groq/Cohere/DeepSeek/xAI/OpenRouter).

3) Votre premier agent (à la manière Laravel)

Le SDK Laravel AI se concentre sur une classe Agent : les instructions, les outils, l...
[Courte citation de 8% de l'article original]