n8n ile AI Agent (Yapay Zeka Ajanı) Nasıl Kurulur?

n8n AI Agent n8n AI Agent node'u; bir LLM, araçlar ve bellek bileşenlerini ReAct döngüsüyle birleştirerek kod yazmadan kurumsal düzeyde yapay zeka ajanları oluşturmanızı sağlar. Bu rehber, sıfırdan çalışan bir ajan kurmanın tam yol haritasını sunar.

n8n AI Agent Nedir?

n8n AI Agent node'u, bir büyük dil modeli ile araç listesini ve isteğe bağlı bir bellek bileşenini birleştiren özel bir iş akışı düğümüdür. Ajan, hedefe ulaşana ya da adım sınırına gelene kadar LLM sorgu–araç çağrısı döngüsünü otomatik olarak yürütür.

Geleneksel otomasyon araçlarından farklı olarak n8n AI Agent node'u, önceden sabitlenmiş bir kural dizisi yerine dinamik karar verme mekanizması kullanır. Node, aldığı kullanıcı girdisini LLM'e iletir; LLM hangi aracın çağrılacağına karar verir, aracın çıktısını alır ve gerekirse bu döngüyü tekrarlar. Bu yaklaşım literatürde ReAct (Reasoning and Acting) veya function-calling olarak adlandırılır.

n8n'in kurumsal iş akışı otomasyonu yetenekleri hakkında daha geniş bir perspektif edinmek istiyorsanız, önce temel mimariyi anlamanız önerilir. AI Agent node'u, n8n'in standart düğüm ekosistemiyle tam entegre çalışır: tetikleyici bir Chat Trigger, Webhook veya herhangi bir veri kaynağı olabilir.

Ajanın davranışını belirleyen dört temel bileşen bulunur: chat modeli (LLM), araç listesi (tools), bellek (memory) ve sistem istemi (system prompt). Bu bileşenlerin doğru yapılandırılması, ajanın hem işlevselliğini hem de güvenilirliğini doğrudan etkiler.

Gerekli Bileşenler: LLM, Tools, Memory ve Vector Store

Çalışan bir n8n AI Agent için minimum dört bileşen gerekir: bir LLM sağlayıcı kimlik bilgisi, en az bir tool tanımı, isteğe bağlı bir memory node ve hedefe yönelik bir sistem istemi. Vector store, RAG senaryoları için ek bir bileşen olarak eklenir.

LLM sağlayıcı seçimi, ajanın hem performansını hem de işletme maliyetini belirleyen en kritik karardır. Mayıs 2026 itibarıyla n8n'in desteklediği sağlayıcılar ve temel özellikleri aşağıdaki tabloda özetlenmiştir.

Tools (araçlar), ajanın LLM çıktısının ötesine geçerek gerçek dünya aksiyonları almasını sağlar. Bir tool, n8n içinde bir sub-workflow, HTTP Request node veya veritabanı sorgusu olabilir. Memory node ise çok turlu konuşmalarda önceki mesajları bağlam olarak LLM'e ileterek ajanın 'hatırlamasını' mümkün kılar. Vector store entegrasyonu yapıldığında ajan, kendi bilgi tabanından (RAG) semantik arama ile bilgi çekerek yanıt üretebilir.

Adım Adım: İlk AI Agent'ınızı Kurun

Bir n8n AI Agent iş akışı; tetikleyici node, AI Agent node, bir chat modeli bağlantısı ve en az bir tool tanımından oluşur. Tüm bu bileşenler n8n arayüzünde sürükle-bırak ile birkaç dakika içinde yapılandırılabilir.

Adım 1: Tetikleyici seçin. Bir sohbet arayüzü üzerinden test etmek için 'Chat Trigger' node'unu kullanın. Üretim ortamında Webhook Trigger veya zamanlanmış bir Cron Trigger da tercih edilebilir. Chat Trigger, n8n'in yerleşik sohbet arayüzünü etkinleştirir ve hızlı prototipleme için idealdir.

Adım 2: AI Agent node'unu ekleyin. Node panelinden 'AI Agent'ı arayın ve iş akışınıza sürükleyin. Bu node'un üç alt bağlantı noktası bulunur: Chat Model (zorunlu), Memory (isteğe bağlı) ve Tools (isteğe bağlı ancak önerilir).

Adım 3: Chat Model bağlayın. AI Agent node'unun 'Chat Model' girişine OpenAI Chat Model veya tercih ettiğiniz sağlayıcı node'unu bağlayın. Kimlik bilgilerinizi (API anahtarı) n8n Credentials panelinde önceden tanımlamış olmanız gerekir.

Adım 4: Sistem istemi yazın. AI Agent node yapılandırmasında 'System Message' alanını doldurun. Bu alan ajanın rolünü, hangi araçları ne zaman kullanacağını ve yanıt formatını tanımlar. Örnek: 'Sen Sora Yazılım müşteri destek asistanısın. Veritabanı aracını yalnızca sipariş sorgularında kullan.'

Adım 5: En az bir tool ekleyin. Tools bağlantı noktasına bir 'Calculator' (yerleşik) veya özel bir Sub-workflow node'u bağlayın. Her tool'un açık bir ismi ve açıklaması olmalıdır; LLM bu açıklamayı hangi aracı seçeceğine karar vermek için kullanır.

Adım 6: Test edin. 'Chat' butonuna tıklayarak n8n'in yerleşik sohbet arayüzünü açın ve bir soru yazın. Execution log, LLM'in hangi tool'u kaç kez çağırdığını ve her adımda hangi veriyi kullandığını gösterir.

Tool Kullanımı: Sub-Workflow, HTTP Request ve Veritabanı

n8n AI Agent'a tool eklemek için Tools bağlantı noktasına herhangi bir n8n node'u veya sub-workflow bağlanabilir. LLM, sistem istemine ve tool açıklamalarına bakarak hangi aracı ne zaman çağıracağına kendi başına karar verir.

Sub-workflow tool'ları en güçlü yapılandırma seçeneğidir. Ayrı bir n8n iş akışını 'Execute Workflow' node'u aracılığıyla tool olarak tanımladığınızda, o iş akışının tüm mantığını (koşullar, döngüler, çoklu API çağrıları) tek bir tool olarak sunmuş olursunuz. Bu yaklaşım, karmaşık iş süreçlerini ajanın erişimine açmanın en temiz yoludur.

HTTP Request node'u ile webhook ve API entegrasyonu yaparak dış sistemlere bağlanabilirsiniz. Örneğin bir CRM API'sinden müşteri verisi çeken, bir muhasebe sistemine fatura oluşturan veya bir destek ticketi kapatan HTTP Request node'larını tool olarak tanımlayabilirsiniz. Her tool'un 'description' alanı LLM tarafından okunur; bu alanı açık ve kesin tutun.

Veritabanı tool'ları için Postgres, MySQL veya MongoDB node'larını doğrudan tool olarak bağlayabilirsiniz. Güvenlik açısından en iyi pratik, tool node'larına salt okunur bir veritabanı kullanıcısı atamak ve gerektiğinde yazma iznini ayrı bir onay adımının ardından vermektir. Kurumsal n8n kullanım senaryoları arasında bu tür hibrit ajan-veritabanı iş akışları yaygın olarak yer almaktadır.

Tool isimlendirmesi performansı doğrudan etkiler: 'get_customer_orders' gibi açık, eylem odaklı isimler; 'tool1' gibi belirsiz isimlerden çok daha iyi LLM kararları üretir. Her tool açıklamasında hangi girdinin beklendiğini ve hangi çıktının döneceğini belirtin.

Bellek ve Bağlam Yönetimi

n8n AI Agent'ta bellek yönetimi, Memory node aracılığıyla sağlanır. Bu node, konuşma geçmişini depolar ve her yeni turda LLM'e iletir; böylece ajan önceki mesajları hatırlayarak tutarlı yanıtlar üretir.

n8n'de desteklenen bellek türleri arasında Window Buffer Memory (son N mesajı tutar), Token Buffer Memory (token limiti içinde kalır) ve harici depo tabanlı bellek seçenekleri (Redis, Postgres) bulunur. Kurumsal ortamlar için harici depolar önerilir; böylece ajan yeniden başlatıldığında konuşma geçmişi korunur.

Bellek node'unu yapılandırırken 'Session ID' alanına dikkat edin. Bu alan, farklı kullanıcıların veya farklı konuşmaların birbirinden ayrılmasını sağlar. Webhook üzerinden gelen bir konuşmada kullanıcı kimliğini (örneğin e-posta adresi veya oturum token'ı) Session ID olarak kullanmak en yaygın pratiktir.

Uzun konuşmalarda bağlam penceresinin dolmaması için token sınırı belirlemeniz kritik öneme sahiptir. OpenAI GPT-4o gibi modeller 128k token bağlam desteklese de her token işleme maliyetine yansır. Window Buffer Memory ile son 10-20 mesajı tutmak, çoğu kurumsal kullanım senaryosu için yeterlidir ve maliyeti öngörülebilir tutar.

RAG ile Güçlendirilmiş AI Agent

n8n AI Agent'a Vector Store tool'u ekleyerek Retrieval-Augmented Generation (RAG) mimarisi kurabilirsiniz. Bu yapıda ajan, kullanıcı sorusunu önce vector veritabanında arar, ilgili belgeleri bulur ve bu bağlamı LLM'e ileterek kaynağa dayalı yanıtlar üretir.

n8n ile RAG tabanlı AI chatbot kurulumu konusunda kapsamlı bir rehber ayrıca hazırlanmıştır. Burada temel entegrasyon noktasına odaklanacağız: AI Agent node'unun 'Vector Store Retriever' girişine bir Pinecone, Qdrant veya PGVector node'u bağladığınızda, ajan artık bu bilgi tabanından anlam bazlı arama yapabilen bir araca sahip olur.

RAG aracını tool listesine eklerken açıklamasını dikkatli yazın. 'Şirket içi belge tabanında arama yapar; ürün kılavuzları, prosedür dökümanları ve SSS içeriklerine erişim sağlar.' gibi bir açıklama, LLM'in bu aracı doğru bağlamda çağırmasını güvence altına alır.

Kurumsal RAG kurulumlarında belge güncelleme sürecini de otomatize etmek önerilir. n8n'de ayrı bir 'Document Ingest' iş akışı oluşturarak yeni dökümanları otomatik olarak embedding'e dönüştürüp vector veritabanına yazabilirsiniz. Bu iş akışı, SharePoint, Confluence veya dahili bir dosya sunucusundan tetiklenecek şekilde yapılandırılabilir.

Kurumsal Senaryolar ve AI Evaluations

n8n AI Agent'lar; müşteri destek otomasyonu, iç süreç yönetimi, veri analiz asistanları ve çok adımlı onay iş akışları gibi kurumsal senaryolarda kullanılır. AI Evaluations özelliği, ajan ve RAG performansını bir test veri setiyle sistematik biçimde ölçmenize olanak tanır.

Müşteri destek ajanları, en yaygın kurumsal kullanım senaryosudur. Ajan, gelen destek talebini sınıflandırır, CRM'den müşteri geçmişini sorgular, belge tabanında çözüm arar ve gerekirse bir insan temsilcisine yönlendirir. Tüm bu adımlar n8n'de tek bir iş akışı olarak modellenebilir.

İç süreç ajanları ise satın alma onayları, izin talepleri ve proje durum güncellemeleri gibi tekrarlayan iş süreçlerini otomatize eder. Bu senaryolarda ajan, ilgili sistem verilerini (ERP, İK yazılımı) okur, onay matrisini kontrol eder ve gerekli bildirimleri iletir.

n8n'in AI Evaluations özelliği, ajan yanıtlarını önceden tanımlanmış doğru cevaplarla karşılaştırarak hassasiyet, geri çağırma ve F1 skorları hesaplar. Bu özellik, üretim ortamına geçmeden önce ajan davranışını test etmek ve model değişikliklerinin performansı nasıl etkilediğini ölçmek için kritik öneme sahiptir.

Kurumsal ortamlarda ajan performansını canlıya almadan önce AI Evaluations ile en az 50-100 örnek içeren bir test seti üzerinde doğrulama yapmanız şiddetle önerilir. Sora Yazılım'ın saha deneyimine göre, bu adımı atlayan projelerde üretim ortamında beklenmedik ajan davranışları gözlemlenme olasılığı önemli ölçüde artmaktadır.

Sık Sorulan Sorular

n8n AI Agent node'u tam olarak nedir?

n8n AI Agent node'u, bir büyük dil modelini (LLM), tool listesini ve isteğe bağlı bellek ile vector store bileşenlerini bir araya getiren özel bir iş akışı düğümüdür. ReAct veya function-calling döngüsüyle hedefe ulaşana kadar otonom kararlar alır.

n8n AI Agent hangi LLM sağlayıcılarını destekler?

Mayıs 2026 itibarıyla OpenAI, Anthropic, Mistral AI, Google Vertex AI, Ollama (yerel) ve herhangi bir OpenAI uyumlu endpoint desteklenmektedir. Kendi sunucunuzda LM Studio veya vLLM çalıştırıyorsanız da bağlantı kurabilirsiniz.

n8n AI Agent kurmak için kod bilgisi gerekiyor mu?

Temel bir ajan kurmak için kod bilgisine gerek yoktur; tüm bileşenler sürükle-bırak arayüzüyle yapılandırılır. Ancak özel tool mantığı, gelişmiş sistem istemleri veya JavaScript/Python code node'u kullanmak istenirse teknik bilgi faydalı olur.

n8n AI Agent'ta 'tool' ne anlama gelir?

Tool, ajanın LLM'in ürettiği yanıtın ötesinde gerçek dünya aksiyonları almasını sağlayan bir n8n bileşenidir. Bir HTTP Request node'u, veritabanı sorgusu, sub-workflow veya Calculator gibi yerleşik araçlar tool olarak tanımlanabilir.

Ajan birden fazla mesaj turunda nasıl bağlam hatırlıyor?

Memory node (Window Buffer Memory, Token Buffer Memory veya Redis/Postgres tabanlı harici bellek) konuşma geçmişini depolar ve her yeni turda LLM'e iletir. Session ID ile farklı kullanıcıların geçmişleri birbirinden ayrılır.

Ollama ile yerel model kullanabilir miyim?

Evet. Ollama'yı kurup Ollama Chat Model node'unu n8n'e ekleyerek Llama 3.3, Mistral veya Phi-4 gibi modelleri tamamen yerel ortamda çalıştırabilirsiniz. Bu yaklaşım, veri gizliliğinin öncelikli olduğu kurumsal ortamlar için idealdir; ancak GPU donanımı gerektirir.

n8n AI Agent'ın işletme maliyeti nasıl hesaplanır?

Maliyet, seçilen LLM sağlayıcısının token fiyatlandırmasına ve ajan başına harcanan token miktarına bağlıdır. Ollama gibi yerel modeller API maliyeti üretmez; bulut sağlayıcılarında ise araç çağrısı başına ek token tüketimi göz önünde bulundurulmalıdır. AI Evaluations ile token verimliliği ölçülebilir.

Sonuç

n8n AI Agent node'u, kurumsal otomasyon projelerinde yapay zeka yeteneklerini kod yazmadan sisteme entegre etmenin en pratik yollarından birini sunmaktadır. LLM seçiminden tool tanımına, bellek yönetiminden RAG entegrasyonuna ve AI Evaluations ile performans ölçümüne kadar tüm bileşenler tek bir platform üzerinde yönetilebilir.

Kendi n8n AI Agent altyapınızı kurmaya hazır mısınız? Sora AI ajan ekibimiz, ihtiyacınıza özel ajan mimarisi tasarımı, LLM seçimi ve kurumsal entegrasyon konularında ücretsiz keşif görüşmesi sunmaktadır.