Laravel, geliştiricilerin işini kolaylaştırmayı amaçlayan bir framework olarak her zaman etkileyici bir sözdizimi sunmuştur. Laravel 12 ile birlikte, platform ciddi bir sıçrama yaparak Laravel AI SDK‘yı tanıttı—akıllı uygulamalar geliştirmek için birleştirilmiş, birinci taraf bir paket.
<p>Ayrı kütüphanelerle OpenAI, Anthropic ve Gemini ile çalıştıysanız veya sohbet geçmişini elle yönetmekte zorluk çektiyseniz, bu SDK sizin beklediğiniz çözümdür.</p>
<h2><a name="what-is-the-laravel-ai-sdk" href="#what-is-the-laravel-ai-sdk">Laravel AI SDK Nedir?</a></h2>
<p>Laravel AI SDK, <strong>OpenAI, Anthropic, Gemini, Mistral</strong> gibi büyük AI sağlayıcılarıyla etkileşim için tutarlı ve etkileyici bir API sunar.</p>
<p>Her sağlayıcı için ayrı SDK yöntemlerini öğrenmek veya özel cURL istekleri yazmak yerine, aşağıdaki işlemler için standart bir arayüze sahip olursunuz:</p>
<ul>
<li>Akıllı <strong>Ajanslar</strong> (chatbotlar, asistanlar) oluşturma.</li>
<li><strong>Yapılandırılmış Çıktı</strong> yönetme (JSON).</li>
<li><strong>Görüntü</strong> oluşturma ve analiz etme.</li>
<li><strong>Ses</strong> sentezleme ve transkribe etme (TTS/STT).</li>
<li><strong>Embeddingler</strong> oluşturma ve <strong>Reranking</strong> gerçekleştirme.</li>
</ul>
<h2><a name="getting-started" href="#getting-started">Başlarken</a></h2>
<p>Kurulum, diğer birinci taraf Laravel paketleri kadar basittir. Bunu Composer üzerinden çekebilirsiniz:<br/></p>
<div class="highlight js-code-highlight">
<pre class="highlight shell"><code>composer require laravel/ai</code></pre>
</div>
<p>Yükleme işlemi tamamlandıktan sonra yapılandırmayı yayınlayın ve migration işlemlerini çalıştırın. Migration'lar, sohbet geçmişini otomatik olarak saklamak için <code>agent_conversations</code> ve <code>agent_conversation_messages</code> tablolarını oluşturur—bu büyük bir zaman kazancı sağlar.<br/></p>
<div class="highlight js-code-highlight">
<pre class="highlight shell"><code>php artisan vendor:publish --provider="Laravel\Ai\AiServiceProvider"php artisan migrate
<p>Yapılandırma, <code>config/ai.php</code> veya <code>.env</code> dosyanızda yönetilmektedir; burada OpenAI, Anthropic, Gemini ve diğer hizmetler için API anahtarlarınızı ayarlayabilirsiniz.</p>
<h2><a name="the-core-concept-agents" href="#the-core-concept-agents">Temel Kavram: Ajanslar</a></h2>
<p>Laravel AI SDK'sında temel yapı taşını <strong>Ajans</strong> oluşturur. Bir ajans, talimatları, araçları ve bağlamı kapsayan özel bir PHP sınıfıdır.</p>
<p>Bunu Artisan komutunu kullanarak oluşturabilirsiniz:<br/></p>
<div class="highlight js-code-highlight">
<pre class="highlight shell"><code>php artisan make:agent SalesCoach</code></pre>
</div>
<p>Bu komut, ajansın kişiliğini ve yeteneklerini tanımladığınız bir sınıf oluşturur. İşte basit bir ajans örneği:<br/></p>
<div class="highlight js-code-highlight">
<pre class="highlight php"><code>namespace App\Ai\Agents;use App\Models\User;
use Laravel\Ai\Contracts\Agent;
use Laravel\Ai\Promptable;
class SalesCoach implements Agent
{
use Promptable;
public function __construct(public User $user) {}
/
* Ajansın takip etmesi gereken talimatları al.
*/
public function instructions(): string
{
return 'You are a friendly sales coach. Analyze the user\'s input and provide constructive feedback.';
}}
