Rehberkontrol edildi
Yapay zekâ ile n8n
Yapay zekâ ile e-postaları sınıflandıran, belgelerden veri okuyan ve yanıt öneren n8n iş akışları kurmak. Kurulum, hata yönetimi, veri koruma ve işletim dahil.
n8n nedir
n8n bir otomasyon aracıdır. Bir iş akışı (workflow), tarayıcıda bir çalışma alanında birbirine bağladığınız düğümlerden (node) oluşur. Her düğüm tek bir iş yapar: e-posta almak, bir API çağırmak, veriyi dönüştürmek veya bir dil modeline soru sormak. Her iş akışı bir tetikleyiciyle (trigger) başlar; yani onu başlatan olayla, örneğin yeni bir e-posta, bir zamanlama veya bir webhook. n8n’i kendiniz işletebilir (self-hosting) ya da ücretli n8n Cloud hizmetini kullanabilirsiniz. Self-hosting’de iş akışları ve veriler sizin sunucunuzda kalır, ancak güncellemeler ve yedeklerle kendiniz ilgilenirsiniz.
Gereksinimler
Başlamak için Docker kurulu bir bilgisayar veya küçük bir sunucu yeterlidir. Docker olmadan Node.js ile de çalışır; belgelere göre 20.19 ile 24.x arasında bir sürüm gerekir. Ayrıca şunlar gerekir:
- Bir yapay zekâ sağlayıcısından API anahtarı, örneğin Anthropic veya OpenAI. Kullandığınız kadar ödersiniz.
- İşlemek istediğiniz posta kutusuna erişim: IMAP bilgileri veya Gmail için bir Google hesabı.
Kurulum
n8n’i başlatmanın en hızlı yolu Docker’dır. n8n_data birimi (volume) iş akışlarını, kimlik bilgilerini ve n8n’in kimlik bilgilerini şifrelemek için kullandığı anahtarı saklar. Ardından http://localhost:5678 adresini açın ve ilk hesabı oluşturun. Kalıcı bir sunucu için belgeler Docker Compose’u önerir. Docker olmadan kısa bir deneme için npx n8n yeterlidir.
docker volume create n8n_data
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-e GENERIC_TIMEZONE="Europe/Istanbul" \
-e TZ="Europe/Istanbul" \
-e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
-v n8n_data:/home/node/.n8n \
n8nio/n8n
# Docker olmadan, yalnızca deneme için (Node.js 20.19 ile 24.x arası)
npx n8nDikkat:n8n, “fair-code” olarak adlandırılan Sustainable Use License ile lisanslıdır. Kendi şirketinizde dahili amaçlarla n8n’i serbestçe kullanabilirsiniz. Değeri büyük ölçüde n8n’den gelen bir ürün veya hizmet olarak satmanıza, örneğin müşteriler için barındırılan bir n8n sunmanıza izin verilmez. Emin değilseniz lisansın kendisini okuyun.
İlk iş akışı ve ifadeler
Her düğüm veriyi kayıtlardan (item) oluşan bir liste olarak alır ve yeni bir liste aktarır. Bu verilere ifadelerle (expression) erişirsiniz. Bir ifade çift süslü parantez içinde yazılır. $json geçerli kaydı ifade eder; $('Düğüm adı') ile önceki bir düğümden veri alırsınız.
- Yeni bir iş akışı oluşturun ve ilk düğüm olarak bir tetikleyici seçin, örneğin Schedule Trigger.
- Düğümdeki artı işaretiyle sonraki düğümü ekleyin, örneğin Edit Fields (Set), ve orada alanları tanımlayın.
- Execute step ile tek bir düğümü test edin. Solda girdi, sağda çıktı görünür.
- Girdideki alanları sürükleyip bir parametre alanına bırakın. n8n uygun ifadeyi kendisi yazar.
{{ $json.subject }}
{{ $('Email Trigger (IMAP)').item.json.from }}
{{ $now.toFormat('yyyy-MM-dd') }}
{{ $json.textPlain.slice(0, 4000) }} // metni kısalt, token tasarrufuİpucu:Bir düğümün hangi alanları döndürdüğü düğüme ve ayarlarına bağlıdır. Alan adlarını tahmin etmek yerine her zaman bir test çalıştırmasının çıktısında kontrol edin.
Kimlik bilgilerini güvenle saklamak
n8n’de parolalar ve API anahtarları kimlik bilgilerine (credentials) yazılır, asla doğrudan bir düğüme veya ifadeye değil. n8n bunları veritabanında şifreler. Bunun için gereken anahtarı n8n ilk başlatmada oluşturur ve .n8n klasörüne kaydeder. Alternatif olarak anahtarı N8N_ENCRYPTION_KEY değişkeniyle kendiniz belirlersiniz. Bu anahtar kaybolursa n8n kayıtlı kimlik bilgilerini artık çözemez.
Dikkat:Dışa aktarılan iş akışları kimlik bilgilerinin adlarını ve kimliklerini (ID) içerir. Bir cURL komutundan içe aktarılan HTTP Request düğümleri kimlik doğrulama başlıkları bile içerebilir. Paylaşmadan önce kontrol edip temizleyin.
Yapay zekâ düğümleri
n8n’deki yapay zekâ düğümleri bir ana düğüm ve ona bağlanan alt düğümlerden oluşur. Ana düğüm görevi belirler; chat model alt düğümü dil modelini belirler, örneğin Anthropic Chat Model, OpenAI Chat Model veya yerel bir model için Ollama Chat Model. Günlük kullanım için genellikle şu ana düğümler yeterlidir:
- Text Classifier: bir metni sabit kategorilere atar. Her kategorinin bir adı ve açıklaması vardır.
- Information Extractor: bir metinden belirli alanları okur, örneğin metni önce Extract from File ile alınmış bir PDF’ten fatura numarası ve tutar.
- Basic LLM Chain: tek bir istem (prompt) ve yanıt; özetler ve yanıt taslakları için uygundur.
- AI Agent: model, bağlı araçlardan (tools) hangisini çağıracağına kendisi karar verir. Güçlüdür ama öngörmesi daha zordur.
İpucu:Görevi çözen en basit düğümü kullanıyorum. Sabit bir sınıflandırma için Text Classifier, bir ajandan daha güvenilir ve daha ucuzdur.
Örnek: gelen e-postaları sınıflandırmak
Hedef: Her yeni e-posta okunur, bir kategoriye atanır ve kategoriye göre işlenir. Hiçbir şey otomatik gönderilmez; yapay zekâ yalnızca taslak yazar.
- Tetikleyici: IMAP kimlik bilgisiyle Email Trigger (IMAP), Mailbox Name olarak INBOX ve e-posta okunmamış kalsın diye Action olarak None. Gmail için Gmail Trigger da kullanılabilir.
- Bir Text Classifier ekleyin. Input Prompt: konu ve kısaltılmış metin, ifade ile. Talep, Fatura, Randevu ve Bülten gibi kategoriler oluşturun; her birine açık bir açıklama yazın.
- When No Clear Match altında Output on Extra, 'Other' Branch seçeneğini seçin. Böylece belirsiz e-postalar atılmak yerine ayrı bir dala gider.
- Talep dalı: Basic LLM Chain bir yanıt taslağı yazar; bunu örneğin Gmail düğümüyle taslak olarak kaydedersiniz.
- Fatura dalı: Information Extractor fatura numarasını, tutarı ve vade tarihini okur ve bunlardan bir görev oluşturur.
- Other dalı: Bir insanın karar vermesi için size bir bildirim.
Dikkat:E-postalar dışarıdan gelen girdilerdir. Bir gönderen metne yapay zekâya yönelik talimatlar yazabilir (prompt injection). Bu yüzden burada yapay zekâ yalnızca kategori ve taslak üretir; gönderme veya silme gibi işlemleri kendisi başlatmaz.
Yapılandırılmış çıktıyı kontrol etmek
Sonraki düğümlerin güvenilir çalışması için yapay zekâ serbest metin yerine sabit JSON döndürmelidir. Bunun için Basic LLM Chain’de Require Specific Output Format seçeneğini açın ve bir Structured Output Parser bağlayın. Şemayı bir JSON örneğinden oluşturur ya da JSON Schema olarak kendiniz yazarsınız. Information Extractor aynı seçenekleri doğrudan düğümde sunar.
- Yapay zekâ düğümünden sonra bir If düğümüyle zorunlu alanların dolu ve değerlerin makul olup olmadığını kontrol edin, örneğin tutarın sıfırdan büyük olması.
- Yedek yol: Kontrol başarısız olursa veya yapay zekâ sicher = false bildirirse kayıt otomatik devam etmek yerine bir insana gider.
{
"type": "object",
"properties": {
"rechnungsnummer": { "type": "string" },
"betrag": { "type": "number" },
"faellig_am": { "type": "string", "description": "Datum im Format YYYY-MM-DD" },
"sicher": { "type": "boolean" }
},
"required": ["rechnungsnummer", "betrag", "sicher"]
}Hata yönetimi
Yapay zekâ sağlayıcılarında kesintiler ve istek sınırları olur. Bir iş akışı bunlarla e-posta kaybetmeden başa çıkmalıdır. n8n bunun için iki seviye sunar: tek tek düğümlerdeki ayarlar ve tüm süreç için bir hata iş akışı (error workflow).
- Yapay zekâ düğümünde Settings altında Retry On Fail seçeneğini açın. Max. Tries ve Wait Between Tries ile deneme sayısını ve aradaki süreyi belirlersiniz.
- Hatalı kayıtların tüm çalışmayı durdurmak yerine kendi yollarına gitmesi gerekiyorsa On Error altında Continue (using error output) seçeneğini seçin.
- Size bildirim gönderen ve Error Trigger düğümüyle başlayan ayrı bir iş akışı oluşturun. Bu akış diğer bilgilerin yanında hata mesajını, son düğümü ve çalıştırmanın bağlantısını alır.
- İzlenen iş akışında Settings altında Error workflow alanına bu iş akışını girin. Tek bir hata iş akışı birden fazla iş akışını kapsayabilir.
Maliyet ve veri koruma
n8n’i kendiniz işletseniz bile bir isteme (prompt) yazdığınız her şey sunucunuzdan çıkar ve yapay zekâ sağlayıcısına gider. E-postalarda bu neredeyse her zaman kişisel veridir. GDPR (DSGVO) kapsamında bunun için bir hukuki dayanağa ve sağlayıcıyla bir veri işleme sözleşmesine ihtiyacınız vardır. Sağlayıcının verileri nerede işlediğini de kontrol edin. Maliyet token sayısına, yani gönderilen ve dönen metin miktarına göre belirlenir.
- Yalnızca görevin gerektirdiğini gönderin. Sınıflandırma için genellikle konu ve ilk paragraflar yeterlidir.
- Önce maskeleyin: Bir Code düğümü örneğin IBAN’ları, telefon numaralarını ve e-posta adreslerini yer tutucularla değiştirir.
- Çok hassas veriler için Ollama Chat Model üzerinden yerel bir model kullanın. Böylece metin kendi ağınızda kalır.
- Bir döngünün yüksek bir faturaya yol açmaması için sağlayıcıda bir harcama limiti belirleyin.
// Code düğümü, Mode: Run Once for Each Item
const t = $json.textPlain ?? '';
$json.textPlain = t
.replace(/[A-Z]{2}\d{2}(?: ?[A-Z0-9]{4}){3,7}(?: ?[A-Z0-9]{1,3})?/g, '[IBAN]')
.replace(/[\w.+-]+@[\w-]+\.[\w.]+/g, '[EPOSTA]')
.replace(/\+?\d[\d /-]{7,}\d/g, '[TELEFON]');
return $json;Dikkat:Bu tür kurallar her şeyi yakalamaz; örneğin isimler ve adresler kalır. Maskeleme riski azaltır ama hukuki incelemenin yerini tutmaz.
İşletim: güncellemeler, yedekler, kayıtlar
Kendi işlettiğiniz bir n8n bakım ister. Ben sabit bir sıraya uyuyorum: önce yedekle, sonra güncelle, sonra kontrol et. Executions bölümünde her çalıştırmayı her düğümün verileriyle görürsünüz; sorunlarda ilk bakılacak yer burasıdır. Orada e-posta içeriklerinin de saklandığını unutmayın.
# Yedek: her iş akışı ve kimlik bilgisi için bir JSON (şifreli)
n8n export:workflow --backup --output=backups/latest/
n8n export:credentials --backup --output=backups/latest/
# Docker ile güncelleme
docker pull n8nio/n8n
# Konteyneri durdurun ve aynı volume ile yeniden başlatın
# Kayıtları görüntüleme
docker logs -f n8nDikkat:Dışa aktarılan kimlik bilgileri yalnızca aynı anahtarla yeniden çözülebilir. Bu yüzden her zaman .n8n klasörüyle birlikte tüm volume’u yedekleyin. --decrypted seçeneği tüm gizli bilgileri dosyaya düz metin olarak yazar; yalnızca bir taşıma için kullanın ve dosyayı ardından silin.
Sık karşılaşılan sorunlar ve çözümler
En sık karşılaşacağınız durumlar şunlardır:
- İfade undefined döndürüyor: Alan adı yanlış ya da düğümün henüz test verisi yok. Önceki düğümü bir kez çalıştırın ve alanı sürükle bırak ile ekleyin.
- Text Classifier e-postaları atıyor: When No Clear Match, Discard Item olarak ayarlı. Other dalına geçin ve kategori açıklamalarını netleştirin.
- Ayrıştırıcı geçersiz biçim bildiriyor: Şema çok katı ya da istem çok belirsiz. Zorunlu alanları azaltın, istemde bir örnek gösterin veya Auto-fixing Output Parser kullanın.
- Sağlayıcıdan 429 hatası: İstek sınırına ulaşıldı. Retry On Fail’i daha uzun bir bekleme süresiyle ayarlayın veya aynı anda daha az kayıt işleyin.
Kontrol listesi
Bir yapay zekâ iş akışı kalıcı olarak çalışmadan önce şu maddeler tamamlanmış olmalıdır:
- Tüm anahtarlar kimlik bilgisi olarak kayıtlı, şifreleme anahtarı yedeklenmiş.
- Yapay zekâ yapılandırılmış JSON döndürüyor, bir If düğümü bunu kontrol ediyor, belirsiz durumlar bir insana gidiyor.
- Yapay zekâ düğümünde Retry On Fail etkin, bir hata iş akışı hataları bildiriyor.
- Yapay zekâya yalnızca gerekli veriler gidiyor, hukuki dayanak ve veri işleme sözleşmesi netleşmiş.
- Yedekler düzenli alınıyor, sağlayıcıda bir harcama limiti tanımlı.
Diğer notlar
- RehberMCP sunucusu bağlamaClaude’u Model Context Protocol ile kendi verilerinize ve araçlarınıza güvenli ve adım adım nasıl bağlayacağınız.
- RehberClaude Code kurulumuKurulumdan CLAUDE.md, skill ve hook kullanımına kadar. Claude Code’u her gün böyle kullanıyorum.
- NotConditional Access einführen, ohne sich auszusperrenConditional Access ist mächtig, und genau das macht es riskant. Eine einzige Richtlinie mit „Alle Benutzer, alle Ressourcen, Zugriff blockieren“ sperrt die ganze Organisation aus, die Admins eingeschlossen. Die meisten Probleme entstehen nicht durch exotische Einstellungen, sondern weil eine Richtlinie direkt scharf geschaltet wird, ohne sie vorher zu testen.