Laravel 13 AI SDK Nedir? Kullanımı ve Özellikleri (2026)

Laravel 13 ile birlikte gelen en önemli yeniliklerden biri, yerleşik yapay zeka (AI SDK) desteğidir. Artık Laravel geliştiricileri, OpenAI, Gemini, Anthropic gibi servislerle entegrasyon yapmak için ekstra paketlere ihtiyaç duymadan doğrudan framework üzerinden AI özellikleri geliştirebilir.

Bu yazıda Laravel 13 AI SDK nedir, nasıl kullanılır, neler yapılabilir ve basit bir örnek ile nasıl çalıştığını öğreneceksiniz.

🧠 Laravel AI SDK Nedir?

Laravel AI SDK, farklı yapay zeka sağlayıcılarını tek bir API altında toplayan bir katmandır.

Yani şunu düşün:

Daha önce OpenAI için ayrı, Gemini için ayrı kod yazıyordun
👉 Artık tek bir Laravel API ile hepsini yönetiyorsun

Desteklenen sağlayıcılar:

  1. OpenAI
  2. Google Gemini
  3. Anthropic (Claude)
  4. Mistral
  5. Groq
  6. Ollama (local AI)
  7. Azure OpenAI

⚡ Laravel AI SDK ile Neler Yapabilirsin?

Laravel 13 ile birlikte aşağıdaki AI senaryolarını çok kolay şekilde geliştirebilirsin:

🎯 Metin İşleme

  1. Blog yazısı oluşturma
  2. Ürün açıklaması üretme
  3. Metin özetleme
  4. Dil çevirisi

🤖 Chatbot & Agent

  1. Müşteri destek botu
  2. CV analiz sistemi
  3. AI danışman

🧾 Structured Output

  1. JSON formatında veri üretimi
  2. Otomatik form doldurma

🔍 Embedding & Arama

  1. Semantik arama (RAG sistemi)
  2. AI destekli filtreleme

🎙️ Ses & Görsel

  1. Speech to text
  2. Text to speech
  3. Image generation

🏗️ Kurulum

Öncelikle paketi kur:


composer require laravel/ai

Ardından config ve migration:


php artisan vendor:publish --provider="Laravel\Ai\AiServiceProvider"
php artisan migrate

.env dosyana API key ekle:


OPENAI_API_KEY=your_key_here

⚙️ Sistem Gereksinimleri

Laravel 13 AI SDK için:

  1. PHP 8.3+
  2. Laravel 13
  3. Composer
  4. API Key (OpenAI vb.)

Ekstra önemli nokta:

👉 GPU gerekmez (cloud AI kullanıyorsan)

👉 Local model kullanırsan (Ollama) → RAM/CPU gerekir

🧩 Temel Mantık: Agent Yapısı

Laravel AI SDK, klasik “prompt gönder” mantığından biraz daha ileri gider.

Ana yapı:

  1. Agent → AI karakteri
  2. Instruction → ne yapacağını anlatır
  3. Prompt → kullanıcı isteği
  4. Memory → konuşma geçmişi

🧪 Basit Örnek: Ürün Açıklaması Oluşturma

1. Agent Oluştur


namespace App\Ai\Agents;

use Laravel\Ai\Contracts\Agent;
use Laravel\Ai\Promptable;

class ProductDescriptionAgent implements Agent
{
use Promptable;

public function instructions(): string
{
return 'You are a professional e-commerce copywriter. Write short product descriptions in Turkish.';
}
}

2. Kullanım


use App\Ai\Agents\ProductDescriptionAgent;

Route::get('/ai-demo', function () {
$response = ProductDescriptionAgent::make()->prompt(
'Siyah deri erkek cüzdanı için kısa açıklama yaz'
);

return (string) $response;
});

🎉 Çıktı

Şık ve dayanıklı siyah deri erkek cüzdanı, modern tasarımı ve kullanışlı bölmeleriyle günlük kullanım için idealdir.

📦 Structured Output (JSON Çıktı)

AI’dan sadece metin değil, düzenli veri de alabilirsin:

Örneğin:


{
"title": "Ürün adı",
"description": "Açıklama",
"rating": 4.5
}

Bu özellik özellikle:

  1. Admin panel
  2. Otomasyon sistemleri
  3. API çıktıları

için çok güçlüdür.

🔥 Streaming (Canlı Yazma)

Laravel AI SDK ile ChatGPT gibi yazarken gösterme özelliği yapabilirsin:


->stream()

Bu sayede:

  1. Chat uygulaması
  2. Canlı destek
  3. AI editör

gibi sistemler yapılabilir.

🧠 Embedding & AI Arama

Laravel 13 ile gelen en güçlü özelliklerden biri:

👉 Semantik arama (AI search)

Örnek:

  1. Kullanıcı: "ucuz ayakkabı"
  2. Sistem: anlam olarak en yakın ürünleri bulur

Bu yapı:

  1. Blog arama
  2. Ürün filtreleme
  3. SaaS platformlar

için çok kritik.

⚖️ Avantajlar

Laravel AI SDK’nin en büyük artıları:

✔ Tek API ile çoklu AI desteği

✔ Temiz ve sürdürülebilir kod yapısı

✔ Agent mimarisi

✔ Structured output

✔ Streaming desteği

✔ RAG / embedding altyapısı

⚠️ Dikkat Edilmesi Gerekenler

  1. AI servisleri ücretlidir (token bazlı)
  2. Rate limit yönetimi yapılmalı
  3. Cache ve queue kullanılması önerilir
  4. Hassas veriler dikkatli gönderilmeli

🎯 Gerçek Hayatta Kullanım Senaryoları

  1. Admin panelde blog yazısı oluşturucu
  2. CV builder
  3. Müşteri mesajlarını otomatik sınıflandırma
  4. Ürün açıklaması üretme (e-ticaret)
  5. AI destekli arama sistemi

📌 Sonuç

Laravel 13 ile birlikte yapay zeka entegrasyonu artık:

👉 ekstra paket gerektirmeyen

👉 native

👉 ölçeklenebilir

bir yapıya dönüştü.

Bu da Laravel’i sadece bir backend framework değil,

AI destekli uygulama geliştirme platformu haline getiriyor.

⚔️ Laravel 13 AI SDK vs Eski AI Entegrasyon Yöntemi

ÖzellikLaravel 13 AI SDKEski Yöntem (Laravel 10-12 + Paketler)
KurulumTek paket (laravel/ai)Her servis için ayrı paket
API YapısıUnified (tek API)Dağınık, provider’a bağlı
Provider DeğiştirmeÇok kolay (config ile)Kod değiştirmen gerekir
Agent YapısıNative destekliManuel yazılır
Prompt YönetimiMerkezi (Agent class)Controller içinde dağınık
Structured OutputBuilt-inManuel parsing
StreamingNative (->stream())Ek paket gerekir
Conversation MemoryHazır (DB tabanlı)Kendin yazman gerekir
Tool CallingBuilt-inKarmaşık
EmbeddingNative destekHarici servis + manuel
Vector SearchEntegreEk altyapı gerekir
Local AI (Ollama)DestekliEk entegrasyon gerekir
Kod TemizliğiÇok yüksekOrta
MaintainabilityYüksekDüşük / Orta
Öğrenme EğrisiDaha kolayDaha zor
Geliştirme HızıÇok hızlı 🚀Yavaş


Keywords: laravel 13 ai, laravel ai sdk nedir, laravel openai entegrasyonu, laravel ai agent kullanımı, php yapay zeka entegrasyonu, laravel chatbot…

Sıkça Sorulan Sorular

Laravel AI SDK nedir?

Laravel AI SDK, geliştiricilerin tek bir API üzerinden birden fazla yapay zeka sağlayıcısıyla (OpenAI, Gemini vb.) iletişim kurmasını sağlayan yerleşik bir entegrasyon katmanıdır.

Laravel AI kullanmak için GPU gerekir mi?

Hayır. OpenAI gibi bulut tabanlı yapay zeka servislerini kullanıyorsanız GPU gerekmez. Standart bir sunucu yeterlidir.

Laravel AI yerel (local) modellerle çalışabilir mi?

Evet. Laravel, Ollama gibi araçlar sayesinde yerel yapay zeka modelleri ile çalışmayı destekler.

Yorumlar

Log in or sign up to write a comment
Giriş
Sign Up