Costruire AI Agent con Laravel: nessun bisogno di Python | Laravel - Lo stack pulito per Artisans e agent

Negli ultimi due anni, se cercavi come costruire un AI agent, ogni tutorial, corso e intervento a una conferenza rimandava a Python. Gli strumenti che contavano davvero, come i framework per agent, le integrazioni con i vector store e l'orchestrazione multi-agent, erano pensati prima per Python e a volte soltanto per esso.

Gli sviluppatori PHP che volevano costruire qualcosa di reale avevano tre opzioni: imparare Python, creare un microservizio Python e richiamarlo via HTTP da Laravel, oppure accontentarsi di chiamate API grezze che scalfivano appena la superficie di ciò che gli agent possono fare.

Il Laravel AI SDK cambia le cose. Rilasciato come pacchetto first-party, offre agli sviluppatori PHP una base completa e idiomatica per costruire AI agent: tool, memoria, output strutturato, streaming, workflow multi-agent, ricerca vettoriale e integrazione nativa con le queue, il filesystem e Eloquent di Laravel. Non devi usare Python.

Questa guida illustra cosa offre il Laravel AI SDK, come costruire con esso e cosa puoi realisticamente mettere in produzione già oggi.

Perché gli sviluppatori PHP si sono sentiti esclusi

Il framework di cui gli sviluppatori PHP sentivano parlare di continuo era LangChain, una libreria Python che ha introdotto il vocabolario che oggi la maggior parte degli sviluppatori usa per gli AI agent: chain, tool, memoria e vector store. Non era disponibile in PHP, e cercare un equivalente PHP di LangChain non dava alcun risultato pronto per la produzione. Così, ogni volta che un tutorial diceva «ecco come costruire un agent», diceva implicitamente «e ti servirà Python per farlo».

Il Laravel AI SDK risolve questo problema, coprendo i casi d'uso principali: agent con tool, memoria delle conversazioni, output strutturato e workflow multi-agent in PHP, con convenzioni che gli sviluppatori Laravel già conoscono.

Che cos'è il Laravel AI SDK

Il Laravel AI SDK (laravel/ai) è un pacchetto first-party che fornisce un'API PHP unificata per interagire con 14 provider di AI: OpenAI, Anthropic, Google Gemini, Groq, Mistral, DeepSeek, xAI, Ollama, Azure OpenAI, Cohere, OpenRouter, Jina, VoyageAI ed ElevenLabs.

L'SDK è un framework completo per agent, costruito sulle convenzioni di Laravel, con un layer di testing, persistenza delle conversazioni, supporto alle queue, streaming, embedding, vector store, generazione di immagini e trascrizione audio.

Il mattone fondamentale è una classe Agent, una classe PHP che incapsula istruzioni, cronologia della conversazione, tool e uno schema di output opzionale. Gli AI agent si integrano nativamente con le queue, i filesystem, il broadcasting e Eloquent di Laravel.

Costruire il tuo primo Agent Laravel

Poiché un agent nel Laravel AI SDK è una classe PHP, implementi delle interfacce per dichiarare cosa può fare l'agent, e l'SDK si occupa del resto.

La classe dell'agent si definisce una volta sola e si richiama ovunque. Tool, istruzioni e schema di output vivono nella classe (trovi degli esempi nella nostra introduzione all'AI SDK). L'agent viene risolto tramite il service container di Laravel, così le dipendenze vengono iniettate automaticamente.

Cosa possono fare gli Agent Laravel

Tool calling: i tool sono classi PHP che implementano un metodo handle e uno schema JSON. Il modello decide quando chiamarli. L'SDK li esegue e restituisce automaticamente il risultato al modello.

Output strutturato: gli agent che implementano HasStructuredOutput restituiscono JSON tipizzato e validato. Il metodo schema() ne definisce la forma. Le risposte sono accessibili come chiavi di array con i tipi che hai dichiarato.

Streaming: gli agent possono trasmettere le risposte direttamente al browser come server-sent events. L'SDK supporta out of the box il protocollo dati di Vercel AI, il che significa che funziona con le configurazioni di streaming di Livewire e Inertia senza cablaggi personalizzati.

Memoria delle conversazioni: aggiungi il trait RemembersConversations e il Laravel AI SDK memorizza e recupera automaticamente la cronologia delle conversazioni dal tuo database.

Queueing: gli agent di lunga durata non dovrebbero bloccare le richieste HTTP. L'AI SDK si integra nativamente con le queue di Laravel.

Failover dei provider: passa un array di provider e l'SDK li prova in ordine se uno fallisce.

Retrieval-augmented generation (RAG) e ricerca vettoriale: il tool SimilaritySearch si collega direttamente ai modelli Eloquent supportati da pgvector. Il query scope whereVectorSimilarTo gestisce la matematica vettoriale.

Testing: l'AI SDK include un layer fake completo con helper di asserzione, così non ti serve una piattaforma di observability a pagamento per una copertura di test di base.

Workflow multi-agent

I singoli agent gestiscono la maggior parte dei compiti. Quando ti serve di più, l'SDK include cinque pattern multi-agent basati sulla ricerca pubblicata da Anthropic sul design degli agent. Per saperne di più, leggi come puoi costruire workflow multi-agent con l'SDK.

Prompt chaining: l'output di un agent alimenta il successivo. Ideale per sequenze fisse: bozza, revisione, rifinitura, formattazione.

Routing: un agent classificatore legge l'input e lo instrada verso lo specialista giusto. Usa #[UseCheapestModel] sull'agent di routing per mantenere bassi i costi, dato che la classificazione è un compito semplice.

Parallelizzazione: più agent vengono eseguiti contemporaneamente usando Concurrency::run(), l'equivalente PHP di Promise.all(). Ideale per analisi indipendenti dello stesso input -- per esempio, tre agent che revisionano il codice in parallelo, con un quarto che sintetizza i risultati.

Orchestrator-workers: un agent coordinatore delega ad agent worker usati come tool. Il modello determina dinamicamente il percorso di esecuzione. Nessun workflow hardcoded, nessun grafo di state machine da mantenere.

Evaluator-optimizer: un ciclo genera-valuta-migliora con un limite di iterazioni configurabile. L'evaluator restituisce un punteggio strutturato e un flag di approvazione. Il ciclo continua finché il contenuto non passa o non raggiunge il limite.

Taylor Otwell, creatore di Laravel, ha spiegato perché le convenzioni del framework contano in una demo dell'SDK: «Gli LLM se la cavano bene con cose facili da analizzare e comprendere. I framework che fanno leva su convenzioni e struttura se la cavano bene con gli LLM».

Come iniziare

Installa con composer require laravel/ai e segui la documentazione ufficiale del Laravel AI SDK. La guida ai workflow multi-agent copre tutti e cinque i pattern degli agent con codice funzionante.

Per gli sviluppatori che hanno aggiunto un microservizio Python proprio per gestire funzionalità di AI accanto alla loro applicazione Laravel, il Laravel AI SDK elimina di norma la necessità di quel servizio. Un solo linguaggio, un solo deploy, un solo codebase. Costruisci un agent, testalo con SalesCoach::fake() e mettilo in coda. In un solo pomeriggio avrai un agent funzionante in produzione.

Ti serve una demo dal vivo per mettere tutto insieme? Guarda come puoi costruire un ciclo agentico con Laravel da zero.

Domande frequenti

Che cos'è il Laravel AI SDK?

Il Laravel AI SDK è il pacchetto first-party ufficiale per costruire applicazioni basate sull'AI in Laravel. Offre agent, tool calling, output strutturato, streaming, ricerca vettoriale, generazione di immagini, trascrizione audio e memoria delle conversazioni, tutto all'interno delle convenzioni di Laravel e integrato con i suoi sottosistemi nativi.

Esiste un LangChain per PHP?

Non ufficialmente. LangChain è un framework Python senza alcun port per PHP. Il Laravel AI SDK è l'equivalente più vicino per gli sviluppatori PHP: copre gli stessi casi d'uso principali, come agent, tool calling, memoria delle conversazioni, ricerca vettoriale e workflow multi-agent, come pacchetto Laravel first-party mantenuto ufficialmente.

Il Laravel AI SDK supporta OpenAI e Anthropic?

Sì. L'SDK supporta 14 provider, tra cui OpenAI, Anthropic, Google Gemini, Groq, Mistral, DeepSeek, xAI e Ollama. Cambiare provider richiede un solo attributo o una modifica al file .env. Il failover automatico tra provider è supportato.

Posso costruire AI agent in PHP senza imparare Python?

Sì, per la stragrande maggioranza dei casi d'uso delle applicazioni web. Il Laravel AI SDK copre agent, tool, memoria, workflow multi-agent e ricerca vettoriale in PHP. Gli unici casi che richiedono ancora Python sono l'integrazione diretta con librerie ML Python (ad esempio PyTorch, scikit-learn) o tooling specifico per Python come LangSmith.

Posso usare modelli locali con il Laravel AI SDK?

Sì. L'SDK supporta Ollama per i modelli locali e accetta qualsiasi endpoint compatibile con OpenAI tramite l'override della base URL in config/ai.php. Questo significa che puoi eseguire gli agent su modelli Llama, Mistral o Phi in locale senza costi API.

Come funziona la memoria delle conversazioni?

Aggiungi il trait RemembersConversations alla tua classe agent. Il Laravel AI SDK persiste automaticamente la cronologia delle conversazioni nel tuo database e la recupera ai prompt successivi. Gestisci le conversazioni tramite ID, così più utenti possono avere sessioni indipendenti con la stessa classe agent.