Laravel ha rilasciato un SDK AI ufficiale. Ecco cosa significa davvero per il tuo team.

La settimana scorsa, il team di Laravel ha rilasciato qualcosa che era in preparazione fin dal Laracon India: un SDK AI first-party. È ora ufficialmente disponibile come v0.1.2, installabile tramite composer require laravel/ai, e fa esattamente quello che ci si aspetta da un pacchetto Laravel: incapsula più provider AI in un'API pulita e strutturata, così non dovete destreggiarvi tra sei SDK diversi e le rispettive documentazioni.

L'SDK supporta OpenAI, Anthropic, Google Gemini, Groq e xAI out of the box. Avrete a disposizione un nuovo pattern Agent (generabile tramite php artisan make:agent), persistenza delle conversazioni integrata, risposte in streaming, generazione di immagini e audio, e persino ricerca vettoriale per workflow RAG se utilizzate PostgreSQL con pgvector. Sotto il cofano si basa sul pacchetto community Prism, aggiungendo strumenti specifici per Laravel.

La nostra opinione

Nell'ultimo anno abbiamo integrato funzionalità basate sull'AI in progetti per i clienti, principalmente usando chiamate API dirette, classi di servizio personalizzate e una buona dose di soluzioni improvvisate. La verità? Ogni progetto finiva con la propria astrazione leggermente diversa per comunicare con OpenAI o Anthropic. Gestione degli errori diversa, logica di retry diversa, modi diversi di salvare lo storico delle conversazioni. Funzionava, ma non era elegante, e di certo non era riutilizzabile tra progetti diversi.

Quindi un SDK ufficiale che standardizza tutto questo? È genuinamente utile. Il pattern della classe Agent in particolare è l'idea giusta. Quando costruiamo app cloud-native per clienti enterprise, spingiamo già i team verso classi di servizio dedicate per operazioni complesse. Avere un comando ufficiale make:agent con una struttura definita per istruzioni, strumenti e schemi di output significa meno discussioni su dove collocare la logica AI nel codebase.

Vale la pena segnalare anche la funzionalità di failover tra provider. Si può passare un array di provider come ['anthropic', 'openai'] e l'SDK gestisce il fallback automaticamente. Dal nostro lavoro con PHP e Docker su sistemi ad alta disponibilità, sappiamo che i disservizi dei provider non sono ipotetici. I rate limit vengono raggiunti. Le API vanno giù alle 2 di notte. Avere un failover automatico senza dover scrivere logica di retry personalizzata è un vero risparmio di tempo.

Dove andremmo cauti

È la v0.1.2. Quel numero dovrebbe farvi riflettere prima di integrarlo in qualcosa di mission-critical.

Le funzionalità di ricerca vettoriale richiedono PostgreSQL con pgvector, che non è quello che usa la maggior parte dei team Laravel. Se usate MySQL (e statisticamente è probabile), le funzionalità RAG non saranno disponibili senza una migrazione del database. Non è una richiesta da poco per applicazioni già in produzione.

C'è anche una questione a cui l'SDK stesso non può rispondere: come gestire i costi dell'AI. L'SDK rende banalmente facile chiamare i provider AI, il che significa che è anche banalmente facile bruciare crediti API per errore. Abbiamo già visto questo schema nei progetti dei clienti: uno sviluppatore aggiunge una chiamata AI dentro un loop o un job in coda, e improvvisamente la fattura mensile sale di qualche migliaio di euro. L'SDK ha un pratico attributo UseCheapestModel, ma la governance dei costi resta un problema vostro.

E questa è una beta. L'interfaccia API cambierà. Se state costruendo un prodotto destinato a clienti paganti, dovete essere a vostro agio con questa realtà.

E il resto dell'ecosistema Laravel?

L'SDK AI non arriva in isolamento. Si unisce a Laravel MCP (Model Context Protocol, rilasciato a settembre) e Laravel Boost (il pacchetto di sviluppo assistito dall'AI). Insieme, indicano la direzione dell'ecosistema Laravel: l'AI non è più un componente aggiuntivo, sta diventando parte integrante del framework.

Anche Laravel Wayfinder, entrato in beta a gennaio, merita attenzione. Sincronizza automaticamente i tipi PHP e TypeScript, generando rotte e validazione dalla vostra app Laravel. Se avete un backend Laravel con un frontend React o Vue (e molti dei nostri progetti di sviluppo fanno esattamente questo), potrebbe far risparmiare ore reali nel mantenere allineati i contratti API.

Una nota su iOS in Giappone

Sul fronte mobile, a dicembre è successo qualcosa di significativo che sta ancora producendo effetti: il Mobile Software Competition Act (MSCA) giapponese è entrato in vigore, e Apple ha aperto iOS a marketplace alternativi e all'elaborazione dei pagamenti tramite terze parti in Giappone. Questo rende il Giappone il secondo mercato dopo l'UE in cui gli sviluppatori possono distribuire app iOS al di fuori dell'App Store.

Nei nostri progetti iOS e Android nativi, specialmente per clienti che puntano a mercati internazionali, questo tipo di cambiamento normativo conta. Le strutture tariffarie variano dal 5% al 26% a seconda del metodo di distribuzione e della scelta di pagamento in Giappone. Per app con importanti vendite di beni digitali (gaming, abbonamenti, contenuti), i calcoli sulla distribuzione alternativa iniziano ad avere senso in mercati specifici.

Ma ecco il punto critico che emerge costantemente durante i nostri penetration test e le revisioni di sicurezza: le app distribuite tramite marketplace alternativi passano solo attraverso il processo di «Notarization» di Apple, che è una revisione più leggera rispetto alla App Review completa. Se operate in ambito sanitario, finanziario o in qualsiasi settore regolamentato, dovete valutare attentamente se il risparmio sulle commissioni vale il segnale di fiducia ridotto rispetto alla distribuzione tramite App Store. La nostra esperienza con clienti enterprise svizzeri ci dice che la maggior parte delle aziende regolamentate resterà sull'App Store per ora.

Cosa fare questa settimana

Se siete un team Laravel:

1. Installate l'SDK AI in un progetto usa e getta e costruite qualcosa di piccolo. Il pattern agent vale la pena di essere compreso anche se non lo mettete ancora in produzione.
2. Se state già chiamando API AI direttamente, abbozzate come potrebbe essere un percorso di migrazione verso l'SDK. Non migrate ancora, ma conoscetene la forma.
3. Fate un audit della vostra spesa AI attuale. Prima di rendere più facile chiamare i provider AI, sappiate quanto state pagando oggi.

Se distribuite app iOS a livello internazionale:

1. Leggete la pagina di conformità MSCA di Apple. Anche se oggi non avete utenti giapponesi, il trend della pressione normativa è chiaro, e altri mercati seguiranno.
2. Tutti i membri dell'Apple Developer Program devono accettare i termini di licenza aggiornati entro il 17 marzo 2026. Non lasciatevi sorprendere da questa scadenza.

Nelle prossime settimane integreremo l'SDK AI di Laravel in un paio di progetti interni e condivideremo ciò che impariamo. Se state lottando con l'integrazione dell'AI in un codebase Laravel, o cercando di capire cosa significano i cambiamenti dell'App Store giapponese per la vostra strategia di distribuzione mobile, parliamone.

Potete approfondire il nostro approccio a questi problemi consultando i nostri servizi o esplorare i lavori passati per avere un'idea dei tipi di progetti di cui stiamo parlando.