Laravel AI SDK: Türk Geliştiricilere Rehber

Laravel, 5 Şubat 2026 tarihinde büyük bir yenilik sağladı. Taylor Otwell, Laravel AI SDK’sını tanıttı. Bu, Laravel uygulamalarınıza AI destekli özellikler eklemek için kullanılacak birinci taraf bir pakettir. Kendi AI uygulamalarımı geliştirirken karşılaştığım sorunları ve yaşadığım deneyimleri paylaşmak istiyorum.

Laravel AI SDK Nedir?

Laravel AI SDK, OpenAI, Anthropic, Gemini, xAI gibi AI sağlayıcıları ile çalışmak için birleştirilmiş bir API sunar. Tek bir paket, tek bir arayüz, çok sayıda sağlayıcı. Bu, Laravel’in dosya sisteminin soyutlaması gibi, farklı AI sağlayıcıları ile geçiş yapmanızı sağlar.

Özellikler

Evrim: Buraya Nasıl Geldik?

Aşama 1: openai-php/client Günleri

İlk olarak StudyLab için quiz oluşturmak amacıyla openai-php/client paketini kullandım. Temel API çağrılarını daha temiz bir sözdizimi ile yazmaya izin verdiyordu, ama oldukça kısıtlayıcıydı. Sağlayıcı değiştirmek gerektiğinde her şeyi baştan yazmak zorundaydınız.

Aşama 2: openai-php/laravel Topluluk Paketi

Bu paket, Laravel’e özgü bazı iyileştirmelerle birlikte geldi, fakat yine de sadece OpenAI ile sınırlıydı. Birden fazla AI paketi ile çalışmak zorunda kalıyordum.

Aşama 3: Prism PHP

Sonunda Prism PHP ile tanıştım. Prism, sağlayıcılar arasında birleşik bir arayüz sunuyordu. Artık tek bir API ile sağlayıcıları değiştirmek çok kolay hale gelmişti.

SDK’nın Değiştirdiği Şeyler

Ajanların Birinci Sınıf Vatandaşlar Olması

Artık AI mantığını kontrolcüler ya da servislerde yazmak yerine özel Ajan sınıfları oluşturuyorsunuz:

php artisan make:agent QuizGenerator --structured

Bu, AI mantığını kapsüllemekte ve debug sürecini kolaylaştırmaktadır.

İletişim Hafızası

Chatbot ya da konuşma AI özellikleri oluşturuyorsanız, bu özellik büyük bir avantaj sağlıyor. SDK, konuşma sürekliliğini otomatik olarak yönetiyor:

use Laravel\Ai\Concerns\RemembersConversations;

class SupportBot implements Agent, Conversational
{
    use Promptable, RemembersConversations;

    public function instructions(): string
    {
        return 'Yardımcı bir destek asistanısınız...';
    }
}

Akış ve Kuyruklama

Akış özelliği ile AI yanıtlarını direkt olarak bir yoldan dönebilirsiniz. Kuyruklama, AI işlerini arka planda itmek için kritik öneme sahiptir:

Route::post('/generate', function (Request $request) {
    return (new QuizGenerator)
        ->queue($request->input('content'))
        ->then(function (AgentResponse $response) {
            // İşlem tamamlandığında burada işleyin
        })
        ->catch(function (Throwable $e) {
            // Hataları yönetin
        });
});

Akıllı Failover

AI sağlayıcıları çalışmadığında, SDK bunu oldukça kibar bir şekilde yönetiyor:

$response = (new QuizGenerator)->prompt(
    'Soruları oluştur...',
    provider: ['openai', 'anthropic'],
);

Dikkat Edilmesi Gerekenler

• Tek bir sınıf içinde çok sayıda işlev birleştirmeyin. Her ajan belirli bir göreve odaklanmalıdır.
• Yapılandırılmış çıktıyı atlamayın. JSON bekliyorsanız, HasStructuredOutput ile uygun bir şema kullanın.
• Timeout süresini unutmayın. AI çağrıları yavaş olabilir:

$response = (new QuizGenerator)->prompt(
    $longContent,
    timeout: 120,
);

Sıkça Sorulan Sorular

Laravel AI SDK’sını Laravel 11 ile kullanabilir miyim?

Hayır. SDK, PHP 8.4 ve Laravel 12 gerektirir.

Laravel AI SDK, Prism PHP’nin yerini alır mı?

Tam olarak değil. SDK, Prism’i arka planda bağımlılık olarak kullanır ve buna Laravel’e özgü özellikler ekler.

Kişisel Görüşüm: Kullanmalı mısınız?

Yeni bir Laravel 12 projesi başlatıyorsanız, SDK’yı şimdi kullanmalısınız. Mevcut bir uygulamanız varsa, geçişi aşamalı olarak yapın. Mevcut yapılandırmanızı bozmadan yeni özellikleri SDK ile entegre edebilirsiniz. AI geliştirme yapıyorsanız, SDK’nın sunduğu araçlar büyük bir zaman kazancı sağlayacaktır.

Sonuç

Laravel AI SDK, AI destekli uygulamalar geliştirirken süreci oldukça kolaylaştırmaktadır. Web Geliştirme odaklı projelerinizde bu aracı dikkate almanız önerilir.

Kaynak: Orijinal Makale