Görevler karar vermeyi, değişen girdileri veya birden fazla araçta işlem yapmayı gerektirdiğinde otomatik iş akışları oluşturmak zorlaşabilir. Geleneksel otomasyon genellikle sabit adımları izler; bu da esneklik ve muhakeme gerektiren görevlerin ele alınmasını zorlaştırır. n8n AI Ajanları, hedefleri anlayabilen, doğru araçları seçebilen ve gerektiğinde işlem yapabilen zekâ ekleyerek bu sorunu çözer. En uygun n8n AI Ajanı eğitimini bulmak ve daha akıllı, daha esnek iş akışları oluşturmak için bu makaleyi inceleyin.
n8n AI Ajanı nedir?
n8n AI Ajanı, bir görevi anlayabilen, kararlar alabilen ve tamamlamak için eyleme geçebilen AI destekli bir iş akışı bileşenidir. Yalnızca önceden tanımlanmış adımları izleyen iş akışlarının aksine, bir AI Ajanı göreve göre hangi bağlı araçları veya hizmetleri kullanacağına dinamik olarak karar verebilir. Bir AI modelini araçlara ve veri kaynaklarına bağlayarak bilgi getiren, eylemler gerçekleştiren ve yanıtlarını göreve ve mevcut bağlama göre uyarlayan ajanlar oluşturabilirsiniz.
AI Ajanının temel bileşenleri
Bir AI Ajanının nasıl çalıştığını anlamak için bilgi işlemesine, karar vermesine ve eyleme geçmesine yardımcı olan temel unsurlara bakmak önemlidir. Aşağıdaki bileşenler, basit bir iş akışını daha yetenekli, AI destekli bir sisteme dönüştürmek için birlikte çalışır:
| Bileşen | Rol | Kullanılabilir düğüm türleri |
|---|---|---|
| Sohbet modeli (Beyin) | Muhakemeyi, planlamayı ve yanıt oluşturmayı yürütür | OpenAI Chat, Anthropic Claude, Google Gemini, Moonshot Kimi, Ollama, Azure OpenAI |
| Araçlar (Eller) | Modelin çağırabileceği harici yetenekler | HTTP Request, Database, Gmail, Slack, Airtable, Code, MCP Client Tool |
| Bellek (Deneyim) | Konuşma turları boyunca bağlamı korur | Simple Memory, Postgres Chat Memory, Redis Chat Memory |
| Çıktı ayrıştırıcı (Biçimlendirici) | Yapılandırılmış çıktı biçimlerini (JSON, şemalar) zorunlu kılar | Structured Output Parser, Auto-Fixing Output Parser |
Bir n8n AI Ajanı neler yapabilir?
Geleneksel n8n iş akışları, bir tetikleyicinin süreci başlattığı, önceden tanımlanmış eylemlerin sırayla yürütüldüğü ve nihai çıktının oluşturulduğu deterministik bir yapıyı izler. Her adım önceden yapılandırılır; bu da dinamik karar verme için çok az alan bırakır.
n8n AI Ajanı düğümü, iş akışlarına muhakeme yetenekleri ekleyerek daha esnek bir yaklaşım sunar. Bir AI Ajanı, sabit bir sırayı yürütmek yerine bağlamı analiz ederek, en ilgili araçları seçerek, sonuçları işleyerek ve mevcut bilgilere göre sonraki adımı belirleyerek tanımlı bir hedefe doğru çalışır.
Bu, AI Ajanı düğümünü bir n8n iş akışının karar verme katmanı hâline getirir; geleneksel otomasyon ile özerk AI destekli yürütme arasındaki boşluğu kapatırken iş akışlarının değişen görevlere ve gereksinimlere akıllıca uyum sağlamasına olanak tanır.
Geleneksel iş akışı:
Trigger → Action → Action → DoneAI Ajanı iş akışı:
Goal → Reason → Tool Call → Reason → Tool Call → Final Answern8n AI Ajanı ne zaman kullanılmalı?
Bir YZ Ajanının esnekliği karmaşık görevlerde faydalı olabilir, ancak her iş akışı için gerekli değildir. Doğru durumlarda kullanmak, gereksiz karmaşıklığı önlemeye ve otomasyonun verimli ve güvenilir kalmasına yardımcı olur. n8n YZ Ajanını şu durumlarda kullanın:
YZ Ajanını şu durumlarda kullanın:
Sonraki adım, mevcut adımın sonucuna bağlıysa (dinamik yönlendirme).
Görev, öngörülemeyen bir sırayla birden fazla araç çağrısı gerektiriyorsa (ör. bir şirketi araştırmak, CRM'i kontrol etmek, kişiselleştirilmiş bir e-posta taslağı hazırlamak).
Modelin bir yanıta ulaşmak için yineleme yapmasına ihtiyacınız varsa (ör. "en az bir aktarmalı, 500 doların altındaki en iyi uçuşu bul").
YZ Ajanını şu durumlarda kullanmayın:
İş akışı yalnızca biçimlendirme veya tek adımlı özetleme içeriyorsa.
Mantık tamamen kurallara dayanıyorsa ve belirsizlik yoksa.
Gecikme kritikse ve görev muhakeme gerektirmiyorsa (bunun yerine standart bir LLM Chain veya deterministik düğümler kullanın).
n8n ile ilk YZ Ajanınızı nasıl oluşturursunuz?
n8n'de bir YZ Ajanı oluşturmak, basit bir iş akışıyla başlar ve akıllı karar alma için gereken bileşenler zamanla eklenir. Ajanın istekleri anlaması ve uygun eylemleri gerçekleştirmesi için bir sohbet tetikleyicisi, YZ modeli, bellek ve araçlar bağlayabilirsiniz. n8n YZ Ajanı araçlarını kullanarak bir YZ Ajanı oluşturmak için adım adım kılavuz aşağıdadır.
1. Adım: Yeni bir iş akışı oluşturun ve Sohbet Tetikleyicisi ekleyin
n8n çalışma alanınızda yeni bir iş akışı oluşturun ve "İlk adımı ekle" seçeneğine tıklayın. "Sohbet Tetikleyicisi"ni aratıp tuvale ekleyin. Bu düğüm, bir kullanıcı YZ Ajanınıza mesaj gönderdiğinde iş akışını başlatır.
Sohbet Tetikleyicisini ekledikten sonra, örnek bir mesaj göndermek için "Sohbeti Test Et" seçeneğine tıklayın. n8n, sonraki düğümleri yapılandırırken kullanabileceğiniz test verileri oluşturur.
2. Adım: YZ Ajanı düğümünü ekleyin
Sohbet Tetikleyicisi düğümünün yanındaki "+" simgesine tıklayın ve "YZ Ajanı"nı arayın. Düğümü ekleyip Sohbet Tetikleyicisine bağlayın. YZ Ajanı, kullanıcı isteklerini analiz etmekten ve görevlerin nasıl tamamlanacağına karar vermekten sorumludur. Bağlı araçları kullanabilir, harici verilere erişebilir ve verdiğiniz talimatlara göre yanıtlar oluşturabilir.
3. Adım: YZ Ajanına bir sohbet modeli bağlayın
YZ Ajanı düğümünü açın ve "Sohbet Modeli" bağlantısı üzerinden bir model ekleyin. Bir YZ sağlayıcısı seçin, ardından API kimlik bilgilerinizi ekleyip kullanmak istediğiniz modeli seçin.
Bağlı sohbet modeli, YZ Ajanının mesajları anlamasını, görevler üzerinde muhakeme yürütmesini ve yanıtlar oluşturmasını sağlar.
4. Adım: YZ Ajanınıza bellek ekleyin
YZ Ajanı düğümündeki "Bellek" bağlayıcısına tıklayın ve "Basit Bellek" ekleyin.
Bellek, YZ Ajanınızın aynı sohbet içindeki önceki mesajları takip etmesini sağlar. Bu, kullanıcıların tüm bağlamı tekrar etmeden takip soruları sorabilmesi nedeniyle çok turlu sohbetlerde kullanışlıdır.
5. Adım: YZ Ajanının verilere erişmesi için bir araç ekleyin
YZ Ajanı düğümündeki "Araç" bağlayıcısına tıklayın ve "Veri Tablosu" gibi bir veri kaynağı ekleyin. Bilgi tabanınızı içeren tabloyu seçin ve arama ayarlarını yapılandırın.
Örneğin, ajanın kullanıcı sorularını veya etiketleri eşleştirerek Soru-Cevap veritabanınızda arama yapmasına izin verebilirsiniz. Bir kullanıcı soru sorduğunda, YZ Ajanı bu aracı çağırabilir, ilgili bilgileri alabilir ve daha doğru bir yanıt oluşturmak için kullanabilir.
6. Adım: YZ Ajanı talimatlarını yapılandırın
YZ Ajanı ayarlarını açın ve bir "Sistem Mesajı" ekleyin. Bu mesaj, ajanın rolünü tanımlar ve istekleri nasıl ele alması gerektiğini açıklar.
Örneğin, ajana soruları yanıtlamadan önce bağlı veri kaynağını kullanmasını, alınan bilgilere dayalı yanıtlar vermesini ve tahminde bulunmak yerine ilgili bilgi olmadığında kullanıcıları bilgilendirmesini söyleyebilirsiniz.
7. Adım: YZ Ajanınızı test edin ve yayımlayın
Sohbet Tetikleyicisi düğümüne dönün ve YZ Ajanınızla etkileşim kurmak için "Sohbeti Test Et" seçeneğini kullanın. Bilgi tabanınızla ilgili sorular sorun; ajanın doğru bilgileri alıp yararlı yanıtlar oluşturup oluşturmadığını kontrol edin.
YZ Ajanının isteği nasıl işlediğini ve hangi araçları kullandığını görmek için iş akışı yürütme günlüklerini inceleyebilirsiniz. İş akışı beklendiği gibi çalıştığında, YZ Ajanınızı kullanılabilir hâle getirmek için "Yayımla" seçeneğine tıklayın.
Kimi API'leri n8n'e nasıl entegre edilir?
Kimi API'leri, Kimi'nin AI özelliklerini doğrudan n8n iş akışlarına taşımanıza ve metin işleme, muhakeme ve içerik üretimi gibi görevlerde kullanmanıza olanak tanır. Entegrasyon, iş akışınızı bir API anahtarı üzerinden Kimi modellerine bağlayarak prompt göndermenizi ve AI tarafından üretilen yanıtları almanızı sağlar. Bağlantıyı yapılandırdıktan sonra Kimi'yi diğer n8n düğümlerinin yanında AI destekli bir adım olarak kullanabilirsiniz. Entegrasyonu kurmak için aşağıdaki adımları izleyin.
1. Adım: Tetikleyici düğümü ekleyin
Yeni bir iş akışı oluşturun ve iş akışının ne zaman çalışacağını belirlemek için bir "Manual Trigger" düğümü ekleyin. Bunu daha sonra zamanlama veya olaya dayalı tetikleyici gibi başka bir tetikleyiciyle değiştirebilirsiniz.
2. Adım: Kimi düğümünü ekleyin
"Add Node" seçeneğine tıklayın, "AI" bölümünü açın ve "Moonshot Kimi"yi seçin. Bir Kimi modeline prompt göndermek için "Message a model" seçeneğini belirleyin.
3. Adım: Kimi API kimlik bilgilerini oluşturun
Kimi API platformunu açın ve API anahtarı oluşturmak için "Console">"API Keys" bölümüne gidin.
n8n'de "Create New Credential" seçeneğini belirleyin, anahtarı girin, bölge olarak "International"ı seçin ve kaydedin.
4. Adım: Modeli yapılandırın
"Resource" alanını "Text", "Operation" alanını ise "Message a Model" olarak ayarlayın. Ardından tercih ettiğiniz Kimi modelini seçin ve iş akışının göndermesini istediğiniz promptu girin.
5. Adım: İsteği özelleştirin
"User" gibi uygun "Role" seçeneğini belirleyin ve gerekirse ek dosyalar ekleyin. Sistem mesajları, token sınırları, yanıt biçimi, düşünme modu ve diğer kullanılabilir ayarlar gibi seçenekleri de yapılandırabilirsiniz.
6. Adım: İş akışını çalıştırın ve test edin
Yapılandırılan promptu Kimi'ye göndermek ve yanıtı kontrol etmek için "Execute Workflow" seçeneğine tıklayın. Bakiye yetersiz hatası alırsanız Kimi hesabına bakiye yükleyin ve iş akışını yeniden çalıştırın.
Kimi API kullanmanın avantajları
Kimi API, özellikle görevler daha derin muhakeme, büyük miktarda bilgi veya birden çok işlem gerektirdiğinde n8n iş akışlarına daha gelişmiş AI özellikleri ekleyebilir. Kimi API'yi n8n ile kullanmanın başlıca avantajları şunlardır:
Uzun bağlamlı görevleri daha derin anlayışla yürütün: Kimi, büyük miktarda bilgiyi işlemek ve analiz etmek üzere tasarlanmıştır; bu da onu uzun belgeler, karmaşık veriler veya çok adımlı talimatlar içeren iş akışları için uygun kılar. n8n ajanlarının görevler arasında bağlamı korumasına ve daha doğru yanıtlar üretmesine yardımcı olur.
Karmaşık iş akışı kararlarını mümkün kılın: Kimi, n8n otomasyonlarını gelişmiş muhakeme özellikleriyle güçlendirerek AI Ajanlarının girdileri analiz etmesine, farklı senaryoları değerlendirmesine ve bir sonraki iş akışı adımını tetiklemeden önce daha iyi kararlar almasına olanak tanır.
Araç çağrılarını ve ajan etkileşimlerini destekleyin: Kimi API ile n8n iş akışları AI muhakemesini harici araçlara, API'lere ve hizmetlere bağlayabilir. Bu sayede ajanlar bilgi alabilir, işlemleri yürütüp basit metin üretiminin ötesindeki görevleri tamamlayabilir.
İş akışları genelinde bağlam yönetimini iyileştirin: Kimi, AI Ajanlarının önceki etkileşimleri, kullanıcı gereksinimlerini ve iş akışı durumlarını anlamasına yardımcı olur. Bağlamın daha iyi yönetilmesi, karmaşık otomasyon senaryolarında daha tutarlı çıktılar ve daha sorunsuz yürütme sağlar.
Otomasyon verimliliğini artırın: Kimi'nin AI özelliklerini n8n'in iş akışı otomasyon platformuyla birleştiren ekipler, manuel işlemleri azaltabilir, tekrarlayan süreçleri sadeleştirebilir ve verimli biçimde ölçeklenen daha akıllı, AI destekli iş akışları oluşturabilir.
Yaygın sorunları giderme
Bir n8n AI Ajanı beklendiği gibi davranmadığında sorun genellikle araçları, kimlik bilgileri, belleği veya model ayarlarıyla ilgilidir. Aşağıdaki belirtileri ve olası nedenlerini incelemek, sorunu hızlıca belirlemenize ve iş akışını doğru şekilde çalıştırmanıza yardımcı olabilir.
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Ajan araçları hiç çağırmıyor | Araç açıklamaları belirsiz veya birbiriyle çakışıyor | Açıklamaları açık ve birbiriyle çakışmayacak şekilde yeniden yazın. |
| Ajan yanlış aracı çağırıyor | Çok fazla araç eklenmiş | Gereksiz araçları kaldırın; tek araçla başlayın. |
| "Kimlik bilgisi bulunamadı" hatası | Chat Model düğümünde Moonshot kimlik bilgisi seçilmemiş | Moonshot Kimi Chat Model düğümünü yeniden açın ve kimlik bilgisini seçin. |
| Ajan sonsuz döngüye giriyor | Maksimum Araç Çağrısı Yineleme sayısı çok yüksek ayarlanmış veya prompt'ta durma koşulu yok | Yineleme sayısını düşürün ve sistem prompt'una açık durma kuralları ekleyin. |
| Bellek kullanıcılar arasında sızıyor | Oturum Anahtarı benzersiz bir tanımlayıcıya ayarlanmamış | Oturum Anahtarı'nı ={{ $json.sessionId }} olarak ayarlayın. |
| Thinking Mode ve Web Search birlikte başarısız oluyor | Bu iki özellik Kimi'de birbirini dışlar | Aynı anda yalnızca birini etkinleştirin. |
Sonuç
n8n AI Agent, görevleri anlayabilen, karar verebilen ve geleneksel otomasyonun ötesine uyum sağlayabilen esnek iş akışları oluşturmanıza yardımcı olur. Kimi API'yi n8n'e bağlayarak daha akıllı AI iş akışları için güçlü muhakeme ve uzun bağlam özelliklerinden yararlanabilirsiniz. Basit bir kullanım senaryosuyla başlayın, sonuçları test edin ve yeni olanakları keşfettikçe otomasyonunuzu genişletin.