n8n 2.33.5 ile Destek Taleplerini Yerelde JSON’a Çevirme: Gerçek Test

Kısa sonuç: n8n 2.33.5’i ayrı bir geçici dizine kurup yerel bir destek talebini üç düğümlü akıştan geçirdim: elle tetikleme, yerel modele HTTP isteği ve JSON doğrulama. Akış 9,8 saniyede teknik olarak tamamlandı; fakat model, ekran okuyucuyla satın alma işlemini bitiremeyen kullanıcıyı “düşük” aciliyette sınıflandırdı. Yani n8n bağlantıları ve veri biçimini güvenilir biçimde yönetebilir, modelin kararını doğru yapmaz. Bu nedenle örneğin son adımı otomatik işlem değil, insan incelemesidir.

n8n ne işe yarar, kimler için?

n8n; form, e-posta, veritabanı, API ve yapay zekâ modelini görsel bir iş akışında birbirine bağlayan otomasyon platformudur. Bir düğüm veriyi alır, diğeri modele gönderir, koşul düğümü sonucu yönlendirir ve son düğüm bir kayıt açar ya da insandan onay ister. Bu yazıdaki örnek, erişilebilirlik destek taleplerini kategori, aciliyet, ozet ve insan_incelemesi alanlarına dönüştürüyor.

Araç; çok sayıda uygulamayı bağlamak isteyen teknik operasyon ekiplerine, görsel akışla prototip hazırlayan geliştiricilere ve model çıktısının önüne denetim noktası koymak isteyen destek ekiplerine uygun. Sunucu güncellemesi, yedek, kimlik bilgisi, ağ ve günlük saklama sorumluluğunu üstlenemeyenler için kendi sunucunda çalıştırma iyi bir başlangıç değil; n8n Cloud bu işletim yükünü azaltır. Berlin merkezli n8n GmbH’nin ürünü olan platformun ana lisansı da MIT ya da Apache değil, “Sustainable Use License”dır.

Kurulum: sürümü sabitleyin, alan ihtiyacını küçümsemeyin

6 Ağustos 2026’da resmî kararlı sürüm 2.33.5, beta sürüm 2.34.2 idi. npm paketi Node.js 22.22 veya üstünü istiyor; resmî kurulum sayfası desteklenen aralığı 20.19–24.x olarak veriyor. Testi macOS arm64, Node 24.18.0 ve npm 11.16.0 ile yaptım. Temiz dizindeki node_modules 2,5 GB, ayrı npm önbelleği 1,1 GB tuttu; kilit dosyasında 2.263 paket kaydı oluştu. Küçük bir “no-code” aracı gibi görünse de bağımlılık yüzeyi geniş.

mkdir n8n-lab && cd n8n-lab
npm init -y
npm install --no-audit --no-fund n8n@2.33.5
N8N_DIAGNOSTICS_ENABLED=false \
N8N_TEMPLATES_ENABLED=false \
N8N_HOST=127.0.0.1 \
npx n8n start

Bu hızlı başlangıç yalnız yerel laboratuvar içindir. Testte sunucu http://127.0.0.1:5687 üzerinde açıldı ve veri tabanı geçişlerini tamamladı. Aynı zamanda Python görev çalıştırıcısının sanal ortamı bulunamadı; JavaScript çalıştırıcısı açıldı. Çalışma zamanı ayrıca npm ile konteyner dışında çalıştırmanın ileride kaldırılacağı ve resmî Docker imajına geçilmesi gerektiği uyarısını verdi. Üretimde sabit imaj özeti, kalıcı veritabanı, yedek, TLS ve ters vekil kullanılmalı.

Adım adım gerçek kullanım: destek talebini JSON’a çevirme

Gerçek test akışı üç düğümden oluştu. “Elle başlat” düğümü boş bir kayıt üretti. “Yerel modele gönder” adlı HTTP Request düğümü, yerel Ollama API’sine sentetik ve kişisel veri içermeyen Türkçe talebi yolladı. “JSON yanıtı doğrula” adlı Code düğümü yanıtı ayrıştırdı, model adını ve süreyi ekledi. Model ya da ağ hatası olduğunda akışın başarıyla devam etmesine izin verilmedi.

1. Yeni bir workflow açın ve Manual Trigger ekleyin. Üretimde bunu Form Trigger, e-posta ya da yardım masası webhook’u ile değiştirin.
2. Information Extractor düğümünde Text alanını önceki düğümdeki talep metnine bağlayın. Schema Type altında “Define using JSON Schema” seçin.
3. Şemada kategori ve aciliyet için izin verilen değerleri sınırlandırın; tüm alanları zorunlu yapın. Örnek değerlerden otomatik şema üretirseniz n8n bütün alanları zorunlu kabul eder.
4. Alt model bağlantısı olarak Ollama Chat Model ekleyin. Aynı makinede npm kurulumu için taban adres http://127.0.0.1:11434 olabilir; n8n Docker içindeyse localhost konteynerin kendisini gösterir, uygun ağ adı gerekir.
5. Çıktıyı bir IF düğümüne bağlayın. insan_incelemesi=true, bilinmeyen kategori, düşük güven veya ayrıştırma hatası durumunda destek kuyruğuna gönderin.
6. Yalnız onaylanmış dalda yardım masası kaydı oluşturun. Modelin ödeme, hesap kapatma ya da veri silme gibi geri alınması zor işlemleri doğrudan yapmasına izin vermeyin.

Benim koşumumda HTTP düğümü yaklaşık 9,75 saniyede döndü; Code düğümü 31 milisaniyede JSON’u ayrıştırdı. Sonuç biçimsel olarak geçerliydi: dört alan da vardı ve insan incelemesi true oldu. Fakat kategori “Teknoloji”, aciliyet “düşük” çıktı. Bu hata, JSON Schema’nın yapıyı sınırladığını ama anlamı doğrulamadığını gösteriyor. Erişilebilirlik engeli satın almayı durduruyorsa kural tabanlı bir yükseltme veya insan onayı modele üstün gelmeli.

Arayüz ve erişilebilirlik notları

İlk açılış ekranında sırasıyla Email, First Name, Last Name ve Password alanları; güvenlik ve ürün güncellemesi seçeneği ile Next düğmesi var. Gerçek tarayıcı kontrolünde dört metin alanının etiketleri programatik olarak bağlıydı, onay denetimi açıklayıcı bir erişilebilir ada sahipti ve Tab sırası görsel sırayla aynıydı. Parola için “8+ karakter, en az bir sayı ve bir büyük harf” yardımı gösterildi. Buna karşılık kurulum sayfasında H1 yoktu ve belge dili en idi; Türkçe ekran okuyucu kullanan bir kişi için telaffuz ve sayfa yapısı ideal değil.

Hesap oluşturmadan tam editörde ekran okuyucu testi yapmadım. Resmî klavye belgesine göre Command/Ctrl+K komut çubuğunu, N düğüm panelini açıyor; Command/Ctrl+Enter akışı çalıştırıyor. Seçili düğümler ok tuşlarıyla gezilebiliyor, Enter ayrıntıyı açıyor, F2 yeniden adlandırıyor ve Delete siliyor. Fareyle sürüklenen tuval hâlâ karmaşık bir zihinsel model gerektirir. Düğümlere “HTTP Request 1” gibi adlar yerine “Yerel modele gönder” gibi görev adı verin; çalışma sırasını soldan sağa kurun, her dalı açıkça adlandırın ve kritik sonucu yalnız renkle anlatmayın.

Mimari, gözlemlenebilirlik ve hata kurtarma

n8n modeli kendi içinde barındırmak zorunda değil. Model, kimlik bilgisi ve araç bağlantıları ayrı düğümlerdir; bu da en az yetki uygulamasını kolaylaştırır. Yardım masası anahtarı yalnız kayıt oluşturabilmeli, e-posta hesabı yalnız belirli klasörü okuyabilmeli, yerel model sunucusu internetten erişilebilir olmamalı. Kod düğümleri ve topluluk paketleri doğrudan kod çalıştırabildiği için yalnız güvenilir iş akışı düzenleyicilerine verilmelidir.

Executions görünümü her düğümün girişini, çıktısını, süresini ve hatasını incelemeye yarar. Ancak bu kayıtlar destek mesajı, kişisel veri ve model istemi saklayabilir. Başarılı koşumları gereksiz yere tutmayın; hata kayıtları için de saklama süresi belirleyin ve hassas alanları kayıttan çıkarın. Ağ çağrılarına zaman aşımı, sınırlı yeniden deneme ve benzersiz istek anahtarı ekleyin. Model biçimi bozulursa otomatik onarım yerine hata dalına geçin. Yardım masası servisi dönmezse aynı talebi iki kez açmamak için önce mevcut kayıt anahtarını kontrol edin.

Güvenlik, gizlilik, maliyet ve lisans

Depoda 5 Ağustos’ta yayımlanan güvenlik duyuruları; MCP düğüm şeması yüklemesinde ana süreçte kod çalıştırma, görev çalıştırıcısı kaçışı, MongoDB/Supabase enjeksiyonu, saklanan XSS ve SSRF gibi yüksek etkili sorunlar içeriyor. İlgili 2.33 hattı için yamalı eşik 2.33.4; test edilen 2.33.5 bu eşikten yeni. Bu, “bir kez kur ve unut” yazılımı değil. Güncellemeden önce sürüm notlarını ve yedeği kontrol edin; kurulumdan sonra n8n’in güvenlik denetimini çalıştırın, SSRF korumasını açın, gereksiz düğümleri engelleyin ve görev çalıştırıcılarını ana süreçten ayırın.

Kendi sunucundaki yerel model akışında metin üçüncü taraf model API’sine gitmedi; yine de n8n’in yürütme veritabanında kaldı. Bulut modeli seçerseniz istem ve yanıt o sağlayıcıya gider. n8n Cloud hesap ister; 6 Ağustos’taki fiyat sayfasında yıllık faturalamada Starter 20 avro/ay ve 2.500 koşum, Pro 50 avro/ay ve 10.000 koşum gösteriliyordu. Model API ücreti bunlara eklenebilir. Kendi sunucundaki Community sürümünde yazılım ücreti olmayabilir ama donanım, bakım, yedek ve güvenlik emeği vardır.

Sustainable Use License, kişisel, ticari olmayan ve kurum içi kullanım için geniş izin verir; ücretsiz ve ticari olmayan dağıtımı sınırlar içinde kabul eder. Bu, OSI anlamında açık kaynak lisansı değildir. .ee. dosyaları ayrı Enterprise koşullarına tabidir; üçüncü taraf düğümler, modeller ve veri kümeleri kendi lisanslarını korur. Depo 6 Ağustos’ta aktif commit alıyordu ve aynı gün 2.33.5 yayımlandı. GitHub’daki yıldız sayısı kalite kanıtı değildir; açık kayıtlarda görev çalıştırıcısı çökmesi, AI workflow üreticisinin takılması ve editör katman sorunları gibi güncel eğilimler vardı.

Alternatiflerle kısa karşılaştırma

• Dify: sohbet uygulaması, RAG ve model yaşam döngüsü merkezlidir. AI ürünü hazırlamak için daha odaklı; yüzlerce kurumsal sistemi genel otomasyon mantığıyla bağlamakta n8n kadar doğal değildir.
• Düz Python: sürümleme, test ve erişilebilir metin tabanlı inceleme açısından en şeffaf seçenektir. Buna karşılık OAuth bağlantıları, yeniden deneme, zamanlama ve gözlem ekranını kendiniz kurarsınız.
• n8n: genel otomasyon ile AI düğümlerini aynı tuvalde birleştirir. Gücü entegrasyon çeşitliliğidir; bedeli büyük bağımlılık yüzeyi, dikkat isteyen lisans ve görsel tuvalin ekran okuyucu yüküdür.

Sorun giderme kontrol listesi

• Model bağlantısı reddediliyor: n8n ile modelin aynı ağ bağlamında olduğunu doğrulayın; Docker içinden 127.0.0.1 ana makine değildir.
• JSON ayrıştırılamıyor: düşük sıcaklık, açık JSON Schema ve zorunlu alanlar kullanın; yine de parse hatasını insan kuyruğuna yönlendirin.
• Akış iki kez kayıt açıyor: talep kimliğini benzersiz anahtar yapın ve yeniden denemeyi idempotent tasarlayın.
• Disk hızla doluyor: başarılı/hatalı yürütme saklama politikasını ve ikili veri temizliğini gözden geçirin.
• Code düğümü çalışmıyor: görev çalıştırıcısı günlüklerini kontrol edin; üretimde harici ve sertleştirilmiş runner kullanın.

Kaynaklar

• n8n 2.33.5 sürüm kaydı — 6 Ağustos 2026
• 2.33.5 commitinde lisans metni
• MCP şema yükleme güvenlik duyurusu ve yamalı sürümler
• Resmî npm kurulum kılavuzu
• Information Extractor düğümü
• Ollama bağlantı ve ağ notları
• n8n klavye kısayolları
• n8n güvenlik denetimi
• Yürütme verisi saklama ve temizleme
• n8n fiyatlandırması — 6 Ağustos 2026’da kontrol edildi

Test kapsamı: n8n 2.33.5 kurulumu, ilk başlatma, geçici SQLite geçişleri, onboarding ekranının etiket ve klavye sırası, üç düğümlü CLI koşumu ve yerel Mistral 7B yanıtı gerçekten çalıştırıldı. Üretim yayını, n8n Cloud hesabı, ücretli model, tam workflow editörü ve gerçek müşteri verisi kullanılmadı.