Neuron AI Laravel SDK – Geliştirici Topluluğu

Otonom ajanlar oluşturmak için “agentic AI” ile ilgili konuşmalar genellikle PHP ekosisteminden uzaklaşmayı öneriyordu. Ancak, kariyerini, şirketini ve ürünlerini Laravel üzerinde inşa edenler için bu yalnızca teknik bir engel değil, aynı zamanda yıllardır koruduğumuz iş güvenceleri üzerinde bir bölünme anlamına geliyor.

Laravel topluluğunun AI’ye yönelmesi, bizim ekosistemimizi terk etmek istemediğimizin ve AI’nin gücünü bu ekosisteme dahil etmek istediğimizin bir göstergesi. Bu nedenle Neuron AI Laravel SDK’sını geliştirdik.

Neuron AI’ye Kısa Bir Giriş

Neuron, AI Ajanları oluşturmak ve yönetmek için lider PHP çerçevesidir. PHP uygulamalarınızda AI varlıklarını entegre etmek için güçlü ve esnek bir mimari sunar. LLM arayüzleri, veri yükleme, çok ajanlı orkestrasyon, izleme ve hata ayıklama gibi tüm ajan uygulama geliştirme döngüsü için araçlar sunmaktayız. Ayrıca, projelerinizde AI Ajanlarını kullanmaya başlamanız için eğitim içerikleri sunuyoruz.

Bu paket, Neuron ile çalışmanızı yeniden yazmayı amaçlamıyor. Bunun yerine, en yaygın çerçeve bileşenlerini doğrudan Laravel konteynerine entegre eden bir köprü işlevi görüyor.

Aşağıdakileri sağlamaktadır:

• AI sağlayıcılarını yönetmek için yapılandırma odaklı bir servis sınıfı.
• Ajanları oluşturmak ve boilerplate kodu azaltmak için Artisan komutları.
• Kalıcı bellek için Eloquent destekli Sohbet Geçmişi bileşenleri.
• Standart Laravel kurallarına uyan kullanıma hazır bir yapılandırma dosyası.
• %100 tipli kod, IDE’nizin en iyi dostu olmasını sağlar.

PHP Agentik Döneme Hazır Mı?

PHP’nin “agentic” uygulamaları için “hazır” olup olmadığını konuştuğumuzda, yalnızca sözdizimini ifade etmiyoruz. Web’in altyapısını da kastediyoruz. Milyonlarca işletme PHP üzerinde çalışıyor. PHP tabanlı SaaS ürünleri ailesini destekliyor. Onlarca yıllık iş mantığı PHP nesneleri ve Servis sınıfları içinde gömülü. AI ajanları trendine ayak uydurmak için farklı bir dile göç etmek, çoğu üretim ortamı için yüksek riskli, düşük ödüllü bir hamledir.

Neuron AI Laravel SDK, en verimli agentik sistemlerin, verilerin zaten bulunduğu yerde inşa edileceğine inanarak oluşturulmuştur. Neuron, oldukça minimal bir yaklaşım benimsemektedir; zihin altında ne olup bittiğini gizleyen rahatsız edici soyutlamalar yoktur. Bu pakette, birkaç Laravel entegrasyon noktasına odaklandık, Neuron’un yerel bileşenlerine erişimi kısıtlamadan.

Kendi özel entegrasyon modelinizi tasarlamak için kodumuzu ilham kaynağı olarak kullanabilirsiniz.

Laravel Uygulamanızda İlk Ajanınızı Oluşturma

Entegrasyon yerel bir his vermek için tasarlanmıştır. Paketi kurduktan sonra, ajanlarınızı tanımlayabilir ve onlarla servis konteynerini kullanarak etkileşimde bulunabilirsiniz. API anahtarlarını manuel olarak yönetmek veya her seferinde karmaşık sağlayıcı örnekleri oluşturma konusunda endişelenmenize gerek yok.

Öncelikle paketi kurun:

composer require neuron-core/neuron-laravel

Artık ilk ajan sınıfınızı oluşturmak için komutu çalıştırabilirsiniz, tıpkı yerel Neuron AI deneyiminde olduğu gibi:

php artisan neuron:agent MyAgent

Bu komut yeni bir ajan sınıfı oluşturacaktır: App\Neuron\MyAgent

AI Sağlayıcısı

Neuron, Anthropic, Gemini, OpenAI, Ollama, Mistral gibi birçok farklı sağlayıcıyı kullanarak AI ajanlarını uygulamanıza olanak tanır. Desteklenen sağlayıcılar hakkında daha fazla bilgiyi Neuron AI belgelerinde bulabilirsiniz: https://docs.neuron-ai.dev/the-basics/ai-provider

Ajanınıza bağlamak istediğiniz AI sağlayıcısının bir örneğini almak için NeuronAI\Laravel\Facades\AIProvider fasadını kullanabilirsiniz.

namespace App\Neuron;

use NeuronAI\Agent;
use NeuronAI\SystemPrompt;
use NeuronAI\Laravel\Facades\AIProvider;
use NeuronAI\Providers\AIProviderInterface;

class YouTubeAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        // Anthropic, OpenAI, Gemini, Ollama, vb... bir örnek döndür
        return AIProvider::driver('anthropic');
    }

    public function instructions(): string
    {
        return (string) new SystemPrompt(...config('neuron.system_prompt'));
    }
}

Mevcut sağlayıcıların hepsini belgelerde görebilirsiniz: https://docs.neuron-ai.dev/the-basics/ai-provider

Bu paket ayrıca, AI sağlayıcıları için tüm yapılandırma seçeneklerini saklayabileceğiniz bir yapılandırma dosyası sağlar. Ajanı tercih ettiğiniz hizmetle bağlamak için aşağıdaki ortam değişkenini kullanabilirsiniz:

# Desteklenen: anthropic, gemini, openai, openai-responses, mistral, ollama, huggingface, deepseek
NEURON_AI_PROVIDER=anthropic

ANTHROPIC_KEY=
ANTHROPIC_MODEL=

GEMINI_KEY=
GEMINI_MODEL=

OPENAI_KEY=
OPENAI_MODEL=

MISTRAL_KEY=
MISTRAL_MODEL=

OLLAMA_URL=
OLLAMA_MODEL=

# Ve daha birçokları

Standart bir Laravel kontrolcüsü içinde basit bir ajan uygulaması nasıl gerçekleştirebileceğine hızlı bir bakış:

use App\Neuron\MyAgent;
use NeuronAI\Chat\Messages\UserMessage;

class AgentController extends Controller
{
    public function __invoke(Request $request)
    {
        // Yapılandırılmış bir ajan örneğini al
        $agent = MyAgent::make();

        // Ajanı çalıştır
        $response = $agent->chat(new UserMessage($request->input('prompt')));

        return response()->json([
            'answer' => $response->getContent(),
        ]);
    }
}

Bu yaklaşım Laravel yaşam döngüsüne saygı duyar. Neuron %100 tipli ve net arayüzlere dayanır, böylece veri yapılarını tahmin etmeden özel eklentiler veya uzantılar geliştirebilirsiniz. “Agentic” kısmı, akıl yürütme, araç çağrısı ve bellek gibi süreçleri yönetirken, siz iş mantığına odaklanabilirsiniz.

Eloquent Sohbet Geçmişi

Sunmuş olduğumuz bir başka Laravel’e özgü bileşen, mevcut veritabanınızda sohbet geçmişlerini saklamak için öngörülebilir bir yol sunmaktadır. Örneğin, dahil edilen Eloquent Sohbet Geçmişi bileşeni, AI etkileşimlerini diğer veritabanı kayıtları gibi ele almanızı sağlar. Bu da hata ayıklama ve denetimi kolaylaştırır.

Uygun veritabanı migrasyonunu çalıştırdıktan sonra, ajanınızda basit bir satır kod ile kullanabilirsiniz:

namespace App\Neuron;

use App\Models\ChatMessage;
use NeuronAI\Agent;
use NeuronAI\Chat\History\ChatHistoryInterface;
use NeuronAI\Chat\History\EloquentChatHistory;

class MyAgent extends Agent
{
    // ...

    protected function chatHistory(): ChatHistoryInterface
    {
        return new EloquentChatHistory(
            threadId: 'THREAD_ID',
            modelClass: ChatMessage::class,
            contextWindow: 50000
        );
    }
}

Yeni AI iş akışları oluşturmak için yeni bir yığın öğrenmenize gerek yok. Sadece doğru entegrasyon noktalarına ihtiyacınız var. Neuron AI belgelerini keşfetmenizi ve denemelere başlamanızı öneriyorum. İster basit bir destek botu, ister karmaşık çoklu ajan sistemi inşa ediyor olun, PHP konforunda “agentic” inşa etmenin nasıl bir his olduğunu görün.

https://docs.neuron-ai.dev