Flowise 3.1.4 ile Görsel AI Ajanı Kurma: Kurulum Testi, Güvenlik ve Erişilebilirlik

Kısa sonuç: Flowise, yapay zekâ modellerini, araçları ve insan onayını görsel bir akışta birleştirmek için güçlü bir açık kaynak platform. Ancak 31 Temmuz 2026 tarihli uygulamalı testte güncel 3.1.4 sürümünü temiz bir Node.js 24 ortamında kurabilsem de uygulamayı başlatamadım. Kurulum 3 GB alan ve 3.275 paket kullandı; ardından eksik çalışma zamanı bağımlılıkları nedeniyle durdu. 3.1.3 karşılaştırması da aynı npm ortamında başlamadı. Bu yüzden aşağıdaki kılavuz üretim kurulumu değil, güvenli bir değerlendirme laboratuvarı ve gerçekçi bir ajan tasarımıdır. Mevcut kurulumunuzu hemen yükseltmeyin; yedek alın, sürümü sabitleyin ve 3.1.4 başlangıç hatası çözülene kadar yeni sürümü ayrı ortamda doğrulayın.

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

Flowise, kod yazmadan veya az kodla sohbet akışları, RAG uygulamaları ve çok adımlı ajanlar kurmayı sağlar. React tabanlı arayüzde düğümler tuvale eklenir; bağlantılar yürütme sırasını gösterir. Sunucu katmanı modeli çağırır, araçları çalıştırır, kimlik bilgilerini saklar ve yürütme kayıtlarını yönetir. Agentflow V2’de her düğüm bağımsız bir işlem yapar; Flow State ise aynı çalıştırma içindeki ortak veriyi taşır.

En uygun kullanıcılar; bir fikri hızla prototiplemek isteyen ürün ekipleri, model ve araç bağlantılarını görsel olarak denetlemek isteyen geliştiriciler ve insan onaylı iş akışı tasarlayan otomasyon ekipleridir. Sunucu güncellemesi, veritabanı yedeği, sır yönetimi ve güvenlik izlemesi yapamayacak kullanıcılar için kendi sunucunda çalıştırma iyi bir başlangıç değildir. Flowise Cloud hesap gerektirir; 31 Temmuz’daki kontrolde herkese açık fiyat adresi giriş ekranına yönlendiği için güncel paket tutarlarını doğrulayamadım.

Kurulum testi: 3.1.4 neden temkin gerektiriyor?

Resmî depo 3.1.4 paketinde Node.js 24 motorunu bildiriyor; “Get Started” belgesi ise hâlâ Node 18.15 veya 20 ve üzerini anlatıyor. Bu belge-paket uyuşmazlığı bile sürümü sabitlemek için yeterli neden. Testi macOS arm64, Node 24.18.0 ve npm 11.16.0 ile, telemetri kapalı ve geçici veri dizininde yaptım. Tarayıcı ikililerinin gereksiz indirilmesini kapatınca paket kurulumu tamamlandı:

mkdir flowise-lab && cd flowise-lab
PUPPETEER_SKIP_DOWNLOAD=true \
PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 \
npm install --legacy-peer-deps flowise@3.1.4
npx flowise start

Bu komutları üretimde kopyalayıp çalıştırmanızı önermiyorum. Testte ilk başlatma ioredis, sonraki denemeler @aws-sdk/client-s3 ve @opentelemetry/sdk-trace-node eksikleriyle durdu. Eksik paketleri tek tek eklemek, doğrulanmamış bir bağımlılık grafiği üretir; güvenlik yaması ve yükseltme yolu belirsizleşir. 3.1.3 denemesi ise LangChain UUID dışa aktarımı, Smithy paketi ve SQLite oturum deposu hataları verdi.

Depodaki açık 6688 numaralı sorun, 3.1.4 Docker imajının temiz bir birimde de başlamadığını; 3.1.3 imajının aynı yapılandırmada açıldığını bildiriyor. Docker kısmını kendi makinemde doğrulayamadım: yerel Colima sanal makinesi disk kilidi nedeniyle başlamadı. Bu nedenle 3.1.3 Docker sonucunu bağımsız testim değil, açık sorun kaydı olarak aktarıyorum. En güvenli karar, çalışan kurulumunuzun sürümünü değiştirmemek ve bakım ekibinin düzeltmesini beklemek. Yeni laboratuvar için sürüm, imaj özeti ve yapılandırma dosyası birlikte sabitlenmeli.

Adım adım gerçek kullanım: iadeyi onaya gönderen ajan

Flowise açıldığında sol menüde “Agentflows” seçilir, V2 anahtarı etkin tutulur ve “Add New” düğmesiyle boş tuval açılır. Örnek hedefimiz, müşteriden sipariş numarası ile iade gerekçesini almak, riski sınıflandırmak ve yalnız insan onayından sonra destek kaydı oluşturmaktır. Ajan ödeme iadesini doğrudan yapmayacak; bu kasıtlı izin sınırıdır.

1. Start: Girdi türünü “Form Input” seçin. order_id ve reason alanlarını zorunlu yapın. Flow State içinde risk, draft ve approval anahtarlarını boş değerlerle baştan tanımlayın.
2. LLM: Kullandığınız model sağlayıcısının kimlik bilgisini “Credentials” bölümünde ekleyin. Sistem iletisi modele yalnız gerekçeyi sınıflandırmasını söylesin. Çıktıyı {"risk":"low|high","summary":"..."} şemasında JSON olarak isteyin; sonucu Flow State’e yazın.
3. Condition: risk=high dalını doğrudan insan incelemesine, düşük risk dalını taslak üretimine bağlayın. Model yanıtı şemaya uymuyorsa varsayılan yol yine insan incelemesi olsun.
4. Human Input: Sipariş numarası, özet ve risk düzeyini gösterin. “Proceed” ve “Reject” yollarını ayrı bağlayın; geri bildirim alanını açın. Flowise bu noktada çalışmayı duraklatıp denetim noktasından sürdürebilir.
5. HTTP veya dar kapsamlı araç: Yalnız “Proceed” dalında destek sistemine taslak kayıt açın. Anahtarın yalnız kayıt oluşturma yetkisi olsun; silme, ödeme ve müşteri dışa aktarma izinleri verilmesin. Alan adı izin listesi kullanın.
6. Direct Reply: Oluşan kayıt numarasını kullanıcıya verin. “Reject” dalında işlemin yapılmadığını ve insan notunu açıkça yazın.

Bu mimaride model karar önerir, Condition yönlendirir, Human Input yetki verir ve araç dar bir eylem yapar. Hata kurtarma için HTTP düğümüne kısa zaman aşımı, sınırlı yeniden deneme ve benzersiz istek anahtarı ekleyin; böylece ağ hatasında çift kayıt oluşmaz. Sonsuz döngüyü önlemek için Loop düğümündeki üst sınırı düşük tutun. “Executions” ekranında başarısız adımı, süreyi ve çıktıyı izleyin; hassas müşteri verisini model istemlerine ve günlük kayıtlarına gereğinden fazla taşımayın.

Arayüz ve erişilebilirlik notları

Kaynak kodda sol menü öğeleri metinle adlandırılmış: Chatflows, Agentflows, Executions, Assistants, Marketplaces, Tools, Credentials, Variables, API Keys ve Document Stores. Agentflows sayfasında V2/V1, Card View/List View ve Add New denetimleri bulunuyor. Tuvalde Add Node, Generate Agentflow, Save, Settings, API Endpoint, Sync Nodes, yakınlaştırma ve arka plan denetimleri var. Bir düğmeye tıklanınca model, ileti, bellek, araç, bilgi kaynağı ve Flow State alanları yan panel veya iletişim kutusunda açılıyor.

Bu inceleme çalışan 3.1.4 arayüzünde yapılmış bir WCAG denetimi değildir; resmî belgeler ve 31 Temmuz tarihli kaynak kod üzerinden yapılan erişilebilirlik değerlendirmesidir. Bazı simge düğmelerinde aria-label bulunurken bazıları yalnız title kullanıyor. Düğümleri sürüklemek ve bağlantı çizmek klavye veya ekran okuyucu kullanıcısı için ciddi engel oluşturabilir. Mümkün olduğunda liste görünümünü seçin, her düğüme anlamlı ad verin ve yürütme sonucunu metin olarak kontrol edin. Ekipler Tab sırası, görünür odak, Escape ile kapanma, yakınlaştırmada metin kaybı ve ekran okuyucu duyurularını ayrıca test etmeli. Yoğun tuval 320 piksel genişlikte pratik değildir; oluşturma işi masaüstünde yapılmalı, son kullanıcı formu ise mobilde ayrıca sınanmalıdır.

Güvenlik, gizlilik, lisans ve maliyet

Flowise’in lisansı tek cümlelik “tamamen Apache-2.0” değildir. Kök LICENSE.md, çoğu kodu Apache-2.0 altında sunuyor; packages/server/src/enterprise ve açıkça işaretlenmiş bazı dosyalar ticari lisansa, üçüncü taraf bileşenler kendi koşullarına tabi. GitHub API’si de lisansı “NOASSERTION” olarak sınıflandırıyor. Dağıtım öncesi kullandığınız düğüm, model, veri kümesi ve eklentinin ayrı koşullarını okuyun.

Güvenlik yüzeyi geniş. GitHub güvenlik API’si ilk sayfada 100 yayımlanmış bildirim döndürdü: 30 kritik, 55 yüksek, 15 orta. Bu sayı tek başına 3.1.4’ün tüm açıkların etkisinde olduğu anlamına gelmez; bildirimlerin önemli bölümü eski sürümlere ait ve yamalı. Yine de 29 Temmuz’da yayımlanan bazı kritik RCE, dosya erişimi ve yetkilendirme sorunları 3.1.2 ve öncesini etkiliyor, 3.1.3’te yamalanmış görünüyor. Sürümü güncel tutmak gerekli fakat 3.1.4’ün başlangıç sorunu yüzünden güncelleme önce kopya ortamda denenmeli.

Uygulamayı doğrudan internete açmayın. Benzersiz JWT, oturum ve token sırları belirleyin; varsayılanları bırakmayın. Ters vekil üzerinde TLS, ağ kısıtlaması ve hız sınırı kullanın. Araç anahtarlarını Flow State’e ya da dışa aktarılan akış dosyasına yazmayın. Custom Function, CSV Agent, tarayıcı, dosya ve MCP düğümlerini yüksek riskli kabul edin; ayrı konteyner, salt okunur dosya sistemi ve çıkış ağı izin listesi kullanın.

Self-host edilen topluluk kodu için ayrı lisans ücreti olmayabilir; gerçek maliyet model API çağrıları, sunucu, veritabanı, yedek, izleme ve bakım emeğidir. Her LLM düğümü ve yeniden deneme yeni token maliyeti doğurur. Basit sınıflandırmada küçük model, yalnız zor vakada büyük model kullanmak; konuşma belleğine sınır koymak ve gereksiz dalları çalıştırmamak faturayı azaltır.

Alternatiflerle karşılaştırma ve karar

n8n, geniş iş uygulaması entegrasyonları ve belirlenebilir otomasyon için daha uygundur; ajanlar ana işiniz değilse daha sade olabilir. Dify, sohbet uygulaması, RAG ve model operasyonlarını tek ürün içinde daha hazır sunar. LangGraph kod önceliklidir; sürüm kontrolü, otomatik test ve karmaşık durum makinelerinde daha fazla denetim verir, fakat geliştirici emeği ister. Flowise’in avantajı görsel ajan orkestrasyonu, insan onayı, ortak durum ve MCP araçlarını aynı tuvalde birleştirmesidir.

Karar: Flowise’i değerlendirmeye değer, ancak 3.1.4 şu anda “kur ve üretime al” sürümü değil. Var olan çalışan sürümü yedekleyip koruyun. Yeni denemeyi geçici ortamda, sahte veri ve yetkisiz araçlarla yapın. 6688 numaralı sorun kapanmadan veya daha yeni bir yama sürümü temiz kurulum, temel akış, oturum açma ve geri alma testlerini geçmeden yükseltmeyin.

Sorun giderme kontrol listesi

• Başlamıyorsa Node ve Flowise sürümlerini kaydedin; “latest” etiketi kullanmayın.
• Eksik modülleri üretimde tek tek eklemek yerine temiz ortamda kilit dosyasıyla yeniden üretin.
• SQLite oturum hatasında veriyi silmeyin; önce yedek alın ve ilgili sürüm sorununu kontrol edin.
• Akış takılırsa Executions kaydından son başarılı düğümü bulun; sınırlı yeniden deneme kullanın.
• Araç yanlış eyleme yöneliyorsa izni daraltın ve Human Input kapısını zorunlu yapın.
• Yükseltme öncesi dışa aktarma, veritabanı yedeği, sağlık kontrolü ve önceki imaja dönüş provasını tamamlayın.

Kaynaklar

• Flowise resmî GitHub deposu — README, commitler ve kaynak kod; 31 Temmuz 2026’da incelendi.
• Flowise 3.1.4 sürüm notları — 29 Temmuz 2026.
• Sabit committe lisans metni — Apache-2.0, ticari dizin ve üçüncü taraf ayrımı.
• Flowise güvenlik bildirimleri — etkilenen ve yamalanan sürümler.
• 3.1.4 başlangıç hatası, issue 6688 — Docker yeniden üretim adımları.
• Resmî başlangıç belgesi — npm, Docker ve geliştirici kurulumu.
• Agentflow V2 mimarisi ve düğüm referansı — Flow State, insan onayı ve MCP.
• Uygulama düzeyi kimlik doğrulama belgesi — JWT, oturum ve sır ayarları.