PHP/Laravel uygulamasına AI ajansı entegre etmenin 5 yeri (yeniden yapılandırmadan)

Bir Laravel ya da PrestaShop uygulamanız varsa, “AI ekleyin” fikri son bir yılda yol haritanıza girmiş olmalıdır. Muhtemelen bu, bir Claude demosu izleyen bir CEO veya destek taleplerinin artışını gören bir müşteri başarı yöneticisinden gelmiştir.

Yanlış cevap, kodu yeniden yazmaktır. Doğru cevap, mevcut yığınınızdaki 5 yeri bulmak ve burada LLM çağrısının 20 satırlık kırılgan kodu 2 satırlık Claude SDK’sına dönüştürdüğünü fark etmektir — ve buradan başlamaktır.

Bu 5 yeri, müşterilerle yaptığım çalışmalarda sıklıkla tekrar ediyorum. Hızlarına göre kabaca sıralanmıştır.

1. Destek kutusu triage (Sınıflandırma)

Kullanım durumu. Her gelen destek e-postası, bir insan görmeden önce Claude’dan geçer. Model bir kategori, ciddiyet ve dil atar; önerilen bir yanıt taslağı hazırlar ve doğru kutuya yönlendirir. Ekibiniz 50 e-posta açar ve 50 önceden sınıflandırılmış satırla taslak cevap görür, 50 ayrıştırılmamış string değil.

Kötü yapıldığında başarısızlık durumu. Claude’ya otomatik yanıt göndermesine izin veriyorsunuz. Üç ay içinde model, mevcut olmayan bir iade politikası hayal ediyor ve size beş haneli bir iadeye mal oluyor. Çözüm, katı bir kuraldır: taslak evet, otomatik gönderim hayır. İnsanlar taslağı onaylar. Tasarruflar, ilk taslağa geçiş hızından gelir, insanı ortadan kaldırmaktan değil.

Entegrasyon noktası. Her gelen e-posta için bir kuyruklanmış iş.

// app/Jobs/TriageSupportEmail.php

public function handle(Anthropic $claude): void
{
    $analysis = $claude->messages()->create([
        'model'    => 'claude-haiku-4-5',
        'system'   => $this->triagePrompt(),
        'tools'    => $this->triageTools(),
        'messages' => [
            ['role' => 'user', 'content' => $this->email->raw_body],
        ],
    ]);

    $this->email->update([
        'category'        => $analysis->tool('assign_category')->args['name'],
        'severity'        => $analysis->tool()->args[],
        'draft_reply'     => $analysis->content_text(),
        => now(),
    ]);
}

Maliyet: yaklaşık $0.0003/e-posta. Haiku 4.5 ile önbellek kullanarak bir ayda 5.000 destek e-postası işleyen bir ekip, her biri için 1.50 dolara önceden sınıflandırılmış bir taslak alır.

2. Ürün açıklaması oluşturma (e-ticaret)

Kullanım durumu. Admin panelde ürün düzenleyicisinin yanında “Açıklama oluştur” butonu bulunur. Bu buton, ürün spesifikasyonları, mağazanın ton kılavuzu ve mevcut açıklamayı Claude ile çağırır. Claude, 3 varyant döndürür. Editör birini seçer, gerekiyorsa düzenler ve kaydeder.

Bu, PrestaShop ve Shopify mağazaları için gördüğüm en kolay çözümdür. Katalog yöneticileri haftada saatlerce açıklama yazmakla meşguldür. Bu, dakikalara düşer.

Kötü yapıldığında başarısızlık durumu. Claude’nın spesifikasyonlar icat etmesine izin verirsiniz (“%100 organik pamuk”iga, siz sentetik satıyorsunuz). Çözüm: yapılandırılmış bir gerçek listesi olarak spesifikasyonları sistem istemcisinde geçmek ve Claude’ya bu listedeki bilgileri asla icat etmemesi için talimat vermektir. Üretim-test edilmiş bir kısıtlama, gerçekten işe yarar.

Entegrasyon noktası. Bir ürün kimliğine + tona göre idempotent bir controller eylemi.

// app/Http/Controllers/Admin/DescriptionGeneratorController.php

public function generate(Product $product, Request $request): JsonResponse
{
    $variants = $this->claude->messages()->create([
        'model'    => ,
        => $this->copywriterPrompt($request->tone),
        => [[
            => ,
            => $product->fact_sheet(), 
        ]],
        => 600,
    ]);

    return response()->json([
        => $this->parseVariants($variants->content_text()),
    ]);
}

Ton, önemli olan parametredir. Premium · dostane · teknik · minimalist · oyunbaz. Aynı ürün, beş farklı açıdan, seçici UI.

3. Anlam arama geri dönüşü

Kullanım durumu. Mevcut anahtar kelime aramanız %70 oranında iyi çalışıyor. Diğer %30 için — yazım hataları, eş anlamlılar, niyet temelli aramalar — hiçbir sonuç döndürmüyor ve hemen çıkma oranınız artıyor. Geri dönüş eklenmekte: anahtar kelime araması N’den az sonuç döndürdüğünde, sorgu gömme biçimine alınır, önceden hesaplanmış ürün gömme ile eşleşir ve en iyi sonuçlar eklenir.

Anahtar kelime aramasını değiştirmiyorsunuz. Kaldırıyorsunuz.

Kötü yapıldığında başarısızlık durumu. Anahtar kelime aramasını tamamen değiştirmiş oluyorsunuz. Tam SKU aramaları, gömme benzerliği sayesinde “BLACK-M-FRONT-9382″yi “black t-shirt”tan daha düşük sıraya koyduğu için artık çalışmıyor. Çözüm: geliştir, asla değiştirme. Anahtar kelime hızlı, tam ve belirleyicidir. Gömme işlemleri yavaş, fuzzy ve olasılıksaldır. Bunlar tamamlayıcılardır.

Entegrasyon noktası. Bir Laravel scout-driver dekoratörü.

// app/Search/HybridSearch.php

public function search(string $query, int $threshold = 5): Collection
{
    $keyword = Product::search($query)->take(20)->get();

    if ($keyword->count() >= $threshold) {
        return $keyword;  // anahtar kelime yeterince, hızlı yol
    }

    $embedding = $this->embed($query);  // önbelleğe alınmış, topluca
    $semantic  = $this->vectorIndex->similar($embedding, take: 20 - $keyword->count());

    return $keyword->merge($semantic)->unique();
}

Çalıştırma maliyeti düşüktür: gömme işlemleri yaklaşık $0.00002/sorgu tutar. Aylık bir milyon sorgu 20 dolara mal olur.

4. Günlük yönetici özeti

Kullanım durumu. Her sabah saat 7’de, admin panelinin ana ekranında bir önceki günün aktivitelerinin 3 paragraflık özeti görünür: siparişler, iadeler, destek talepleri, olağandışı sinyaller. Claude tarafından yazılır, marka sesinizle, gerçek rakamları referans alır.

Listede herhangi bir desenin en yüksek algılanan değer/katkı oranıdır. Sahip, yönetici panelini açtığında, “Dün: 47 sipariş (+%8, Salı ortalamasına göre), 2 iade talebi, her iki iade de SKU-9382 boyut sorunlarıyla ilgili, destek hacmi normal, bir anomali: son 3 saatte 4 terkedilen sepet – ödeme sağlayıcınızı kontrol etmenizde fayda var” diyen tutarlı bir paragraf görüyor ve AI faturası kahvesini bitirmeden kendini geri ödüyor.

Kötü yapıldığında başarısızlık durumu. Claude’ya ham veritabanı dökümleri verirseniz ve “ilginç bir şey bul” demiş olursanız, gürültüden trendler icat eder. Çözüm: toplamayı siz yapın, Claude anlatımı yapsın. İstatistikleri önceden hesaplayın. Onları yapılandırılmış bir özet olarak geçin. Claude’dan bunları İngilizceye çevirmesini isteyin, keşfetmesini değil.

Entegrasyon noktası. 7’den önce çalışacak bir zamanlayıcı görevi.

// app/Console/Commands/DailyAdminDigest.php

public function handle(): void
{
    $stats = [
        => ->dailyOrders(),
        => ->dailyRefunds(),
        => ->dailySupportVolume(),
        => ->detectAnomalies(),
    ];

    $narrative = ->claude->messages()->create([
        => ,
        => ->editorPrompt(),
        => [[=> , => json_encode()]],
    ]);

    AdminDashboard::cacheTodayDigest(->content_text());
}

5. Çıkış e-postası kişiselleştirme

Kullanım durumu. Terk edilen sepet ve yeniden etkileşim e-postalarınız şu anda şablonlu metin kullanmaktadır: “Merhaba {{first_name}}, sepetinizde öğeler bıraktınız”. Açılma oranları düşük.

Bir Claude adımı ekliyorsunuz: model, müşterinin son 5 siparişini, terkedilen öğeleri, ortalama sipariş değerini ve mevsimi alıyor. E-posta gövdesini, bu müşteriyi dönüştürmek için en muhtemel açıyı öne çıkaracak şekilde yeniden yazıyor.

Aynı şablon yapısı, aynı çağrı-to-action düğmesi. Sadece gövde paragrafı her alıcı için dinamik.

Kötü yapıldığında başarısızlık durumu. Claude’ya konu satırını da oluşturması için izin verirseniz — spam şikayet oranınız üç katına çıkar çünkü model, gönderici itibarınızı sürdüremeyeceğiniz tıklama tuzağı ifadeleri kullanır. Çözüm: konu satırını ve CTA’yı sabit tutun. Claude’yi sadece gövde üzerinde çalıştırın.

Entegrasyon noktası. E-postayı göndermeden önce çalışan bir kuyruk kişiselleştirici.

// app/Mail/Personalizers/AbandonedCartPersonalizer.php

public function personalize(Cart $cart, User $user): string
{
    = [
        => ->items->toFactSheet(),
        => ->recentOrders(5)->toFactSheet(),
        => ->avgOrderValue(),
    ];

    return ->claude->messages()->create([
        => ,
        => ->copywriterPrompt(template:),
        => [[=> , => json_encode()]],
        => 240,
    ])->content_text();
}

Temel taslak ile karşılaştırma yaparak test edin. Terk edilen sepet dizilerinde, açılma ile tıklanma dönüşümü arasında %18 ile %40 arasında artış gördüm, ancak sonuçlar tamamen müşteri verilerinizin kalitesine bağlıdır.

Beş Desen Arasındaki Bağlantı

Koda bakın. Hiçbiri yeni bir framework, bir vektör veritabanı, bir “AI platformu” veya bir yeniden yazım gerektirmedi. Her biri mevcut Laravel uygulamasına, başka bir Servis gibi bırakılan tek bir sınıf ve tek bir Claude çağrısıdır.

AI’yi üretim uygulamanıza eklemek için gerçek oyun planı budur:

1. Mevcut kodun kırılgan, yavaş veya pahalı olduğu yeri bulun.
2. Kırılgan kısmı bir kuyruklanmış iş veya kontrolör eylemi ile sarın.
3. Gövdesini bir Claude SDK çağrısı ile değiştirin.
4. Sistem istemcisine yapılandırılmış kısıtlamalar ekleyin böylece model, sadece geçirdiğiniz gerçeklerin dışına icat edemez.
5. Hiçbir hayal gücünün taslağınıza zarar vereceği yerlerde, insanı döngünün içinde tutun.

Eğer bir Laravel ya da PrestaShop uygulamanız varsa ve çalıştığınız bir projeye bu desenlerden birini eklemek istiyorsanız, bana bir e-posta gönderin.
Ben bu işte deneyimliyim: kapsam, inşa, gönderim, kod tabanınız içinde.
2–4 hafta süreli sabit kapsam. Şekil, hire-me sayfasında belgelenmiştir.

Ya da eğer aynı desenlerin tam ajans-sistem yığınında nasıl göründüğünü görmek isterseniz, Career-OS için kaynak, kendi iş aramamı yürüttüğüm AI-ajans kontrol panelimdir — GitHub üzerinde MIT lisanslıdır.

Orijinal olarak bak-dev.com‘da yayınlandı. Daha fazla açık yapım yazısı için bak-dev.com/blog‘u ziyaret edin.