Intégrer l'IA dans Laravel

La plupart des tutoriels sur l'IA partent du principe que vous utilisez Python.

Après 12 ans à développer des applications PHP, j'ai récemment ajouté des fonctionnalités d'IA à un tableau de bord Laravel en production. Je m'en suis servi pour transformer des données brutes en rapports compréhensibles par l'humain.

Le plus difficile n'était pas le code. Le plus difficile était de trouver du bon contenu PHP sur ce sujet.

Voici comment construire une intégration d'IA propre et prête pour la production dans Laravel.

L'Architecture

Ne dispersez pas les appels API dans vos contrôleurs. Utilisez plutôt un pattern "driver". Cela vous permet de basculer entre Claude et OpenAI en modifiant simplement votre fichier .env.

  1. Définissez un contrat Créez une AiClientInterface. Cela garantit que Claude et OpenAI suivent les mêmes règles.

  2. Construisez vos drivers Créez un ClaudeClient et un OpenAiClient. Utilisez le client HTTP de Laravel pour gérer les requêtes. Cela facilite la gestion des timeouts et des tentatives de reconnexion (retries).

  3. Utilisez le Service Container Liez votre interface à un client spécifique dans votre AppServiceProvider. Utilisez une instruction match pour choisir le fournisseur en fonction de votre configuration.

Les Différences

Vous devez connaître ces cinq détails pour éviter les erreurs :

• Claude utilise x-api-key dans l'en-tête. OpenAI utilise Authorization: Bearer. • Claude nécessite un en-tête anthropic-version. • Claude nécessite max_tokens. OpenAI le rend optionnel. • Claude utilise un champ system au niveau supérieur. OpenAI utilise un message avec le rôle system. • Les chemins de réponse JSON diffèrent. Claude utilise content[0].text. OpenAI utilise choices[0].message.content.

Conseils de Production

• Utilisez la mise en cache : les appels d'IA sont lents et coûtent de l'argent. Si les données sont identiques, servez le résultat depuis votre cache. Cela peut réduire les coûts de 70 %. • Utilisez les files d'attente (Queues) : ne faites jamais attendre un utilisateur 10 secondes pour une réponse d'API. Lancez un job en arrière-plan et informez l'utilisateur lorsqu'il est prêt. • Gérez les échecs : les API peuvent échouer. Enveloppez vos appels dans des blocs try-catch. Si l'IA échoue, affichez les données brutes plutôt qu'une page d'erreur. • Fixez des limites : définissez toujours max_tokens pour contrôler vos dépenses. Utilisez des modèles plus petits et moins coûteux pour des tâches simples comme les résumés.

Vous n'avez pas besoin d'apprendre Python pour créer des fonctionnalités d'IA. Vos compétences en PHP sont parfaitement adaptées ici.

Source : https://dev.to/sunakshi_thakur_84a5f59fd/integrating-claudeopenai-api-into-a-laravel-app-a-practical-guide-1hig