Laravel'ın birinci parti AI SDK'sı sağlayıcıları, agent'ları ve araçları PHP geliştiricileri için birleştiriyor

Laravel birinci parti bir AI SDK'sı yayınladı

Laravel geliştiricilerinin artık, her model sağlayıcısına elle HTTP çağrıları yazmadan PHP uygulamalarına AI özellikleri eklemek için tasarlanmış resmi bir paketi var: laravel/ai. dev.to'da yayımlanan bir başlangıç rehberine göre paket; sağlayıcıları yapılandırmak, agent tanımlamak, modelleri çağırmak, araçları kullanmak, yapılandırılmış çıktı istemek ve kullanımı takip etmek için tek ve tutarlı bir yer sunuyor.

Rehberin ana noktası konumlandırmayla ilgili: SDK bir entegrasyon katmanıdır, başlı başına bir özellik değil. Çevresindeki Laravel uygulaması kullanım senaryosunun sahibi olmaya devam eder — yetkilendirme, doğrulama, kalıcılık, kuyruklar, loglama ve kullanıcı deneyimi — SDK ise AI sağlayıcılarına Laravel'e özgü bir köprü sunar.

Paketin kapsadığı alanlar

Bu paket var olmadan önce Laravel uygulamaları AI'ı genellikle ham HTTP istemcileri, sağlayıcı SDK'ları veya küçük wrapper servisleriyle bağlardı; bu bir prototip için işe yarar ama bir ürünün birden çok sağlayıcıya, sohbet bağlamına, yapılandırılmış çıktıya, araçlara, streaming'e, maliyet takibine, test ve failover'a ihtiyacı olduğunda yönetilmesi zorlaşır.

dev.to rehberi SDK'nın yapı taşlarını şöyle sıralıyor:

• OpenAI, Anthropic, Gemini, Groq, Mistral, DeepSeek, xAI, Ollama, Azure OpenAI, OpenRouter ve OpenAI uyumlu endpoint'leri tek ve tutarlı bir API ile kapsayan sağlayıcı soyutlaması.
• Agent'lar: talimatları, bağlamı, araçları, model yapılandırmasını ve isteğe bağlı bir çıktı şemasını paketleyen PHP sınıfları.
• Uygulamanın düz metin değil verilere ihtiyaç duyduğu durumlar için şema tabanlı, yapılandırılmış çıktı.
• Araç erişimi; agent'lar kontrollü yetenekler isterken yetkilendirmeyi ve doğrulamayı hâlâ Laravel yapar.
• Kullanım verileri, ham yanıtlar, event'ler, test yardımcıları, failover, streaming ve kuyruk desteği gibi operasyonel kancalar.

Kurulum ve yapılandırma

Kurulum normal Laravel geleneklerini izler: composer require laravel/ai, servis sağlayıcısının config dosyasını yayınlamak ve migration'ları çalıştırmak. Migration adımı önemlidir çünkü hatırlanan sohbetler gibi özelliklerin veritabanı tablolarına ihtiyacı vardır; ancak durum bilgisiz (stateless) bir sınıflandırma ya da özetleme endpoint'i başlangıçta sohbet depolamasına dokunmayabilir.

Sağlayıcı kimlik bilgileri — OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY, GROQ_API_KEY ve benzerleri — prompt'larda, controller'larda, job'larda veya agent sınıflarında değil ortam değişkenlerinde tutulur. Rehber, her ortam için varsayılan bir sağlayıcı ve model tanımlamayı önerir: geliştirme için ucuz veya yerel bir şey, üretimde öngörülebilir davranış ve fiyat için sabitlenmiş bir model. Model seçimi, kaliteyi, gecikmeyi, maliyeti, bağlam penceresini ve desteklenen araçları etkilediği için altyapı yapılandırması olarak ele alınmalıdır, yazarın savunduğu gibi.

Birinci sınıf PHP sınıfları olarak agent'lar

Agent, SDK'nın uygulamaya bakan ana kavramıdır. php artisan make:agent komutu, Agent contract'ını uygulayan bir sınıf üretir; MaxTokens ve Temperature gibi ayarlar için PHP attribute'ları kullanılır ve hem işi hem de sınırlarını tanımlayan bir instructions() metodu bulunur. Rehberdeki örnek olan SupportSummaryAgent, destek mesajlarını özetlerken modele hesap durumu, ödeme bilgisi veya teknik kök nedenler uydurmamasını açıkça söyler — yazarın uygulamanın davranışsal sözleşmesinin bir parçası olarak gördüğü bir ifade.

Makale ayrıca dar kapsamla başlamayı öneriyor: bilet özetleme, ürün açıklaması iyileştirme, yorum sınıflandırma veya iç doküman soru-cevabı gibi tek bir görev, prompt tasarımını, fallback'leri, maliyeti ve başarı kriterlerini genel amaçlı bir asistana göre çok daha kolay kontrol edilebilir kılar.

HTTP katmanını ince tutun

Rehber, prompt'ları, sağlayıcı kararlarını, doğrulamayı ve kalıcılığı controller'ların içine karıştırmak yerine controller'ları ince tutar ve kullanım senaryosunun sahibi olan bir servis veya action sınıfına devreder. Tipik istek yaşam döngüsü şöyle işler: controller erişimi yetkilendirir, servis güvenilir veriden minimal prompt bağlamı kurar, agent kendi talimat ve yapılandırmasını uygular, sağlayıcı modeli çalıştırır ve Laravel sonucu saklar, doğrular, loglar veya döndürür.

Prompt'lar yalnızca görevin gerektirdiğini içermelidir — bir özet fatura geçmişine ihtiyaç duymuyorsa göndermeyin ve bir kullanıcı bir kayda erişemiyorsa model de onu almamalıdır.

Anonim agent'lar ve kullanım takibi

Bir agent() helper'ı, denemeler ve tek seferlik scriptler için anonim, satır içi agent'ları destekler. Öneri hızla prototip yapmak ama dikkatli yükseltmek: bir iş akışı kullanıcılara, paraya, kayıtlara, destek kararlarına veya özel verilere dokunduğunda, adlandırılmış bir agent'a ve alan servisine taşınmalıdır; bunları gözden geçirmek, test etmek, sürümlendirmek ve gözlemlemek daha kolaydır.

Yanıtlar ayrıca sağlayıcının bildirdiği kullanım verisini — girdi token'ları, çıktı token'ları ve toplamlar — açığa çıkarır; rehber bunun ilk günden itibaren, sağlayıcı, model, prompt sürümü, özellik adı, yanıt süresi ve hata nedenlerinin yanında loglanması gerektiğini söyler. Gerekçe açıktır: bir özellik doğru çalışsa bile işletmesi aşırı pahalı olabilir.

Neden önemli

AI SDK ilgisinin çoğu JavaScript, Python ve Go ekosistemlerine gitti; PHP geliştiricileri modelleri geçici wrapper'larla eklemek zorunda kaldı. Birinci parti bir Laravel paketi, sağlayıcı değiştirmeyi, yapılandırılmış çıktıyı, araç erişimini ve maliyet takibini çerçeveye özgü kaygılar hâline getirir: kimlik bilgileri config'de durur, agent'lar gözden geçirilebilir sınıflardır ve yetkilendirme model katmanında değil Laravel'de kalır. Büyük Laravel uygulamaları çalıştıran ekipler için bu, AI entegrasyonunu prototip dönemine özgü yapıştırıcı koddan standart altyapı gibi davranan bir şeye dönüştürür.

Buradaki ayrıntıların Laravel'ın kendi dokümantasyonundan değil, topluluk tarafından yayımlanan bir rehberden geldiğini belirtmekte fayda var; bu yüzden sınıf adları ve attribute sözdizimi gibi özellikler o rehberin SDK anlatımını yansıtır.