n8n'de Yapay Zeka Düğümü: API Anahtarsız İlk AI Akışı

n8n ile ilgili hemen her rehber aynı yerde takılır: "Önce OpenAI hesabı aç, API anahtarını kopyala, kredi kartını bağla, kullanım limitlerini ayarla." Henüz tek satır iş mantığı yazmadan 10 dakikanızı almış ve cüzdanınız açılmış olur.

Bu yazıda o adımı atlıyoruz. n8n'in AI Agent ve LLM düğümlerini, herhangi bir harici API anahtarı girmeden nasıl kullanabileceğinizi adım adım anlatacağız. Örnek olarak gerçekten işe yarayan bir senaryo kullanacağız: gelen webhook metnini özetleyen ve kategoriye göre yönlendiren bir akış.

---

n8n'in AI Düğümleri Ne Yapar?

n8n, 1.x sürümüyle birlikte birkaç temel AI yapı taşını editörüne entegre etti:

• AI Agent düğümü: Araçlar atayabildiğiniz, döngüsel düşünce zinciri kurabildiğiniz orkestrasyon düğümü.
• LLM (Basic LLM Chain) düğümü: Tek turlu talimat → yanıt. Özetleme, sınıflandırma, dönüştürme gibi basit görevler için idealdir.
• Chat Memory düğümleri: Konuşma geçmişini zincir boyunca taşır.
• Embeddings + Vector Store düğümleri: Belge tabanlı arama ve RAG akışları için.

Bunların hepsinin ortak noktası bir Credentials seçimi istemesidir: OpenAI, Anthropic, Azure OpenAI, Ollama vb. Kendi API anahtarınızı getirmeden bu düğümleri test bile edemezsiniz — normal bir kurulumda.

---

Sorun: BYOK (Bring Your Own Key) Engeli

Tipik n8n kurulum yolu şöyle görünür:

1. n8n Cloud'a veya kendi sunucunuza n8n kurun.
2. OpenAI'ye gidin, API anahtarı alın.
3. Anahtarı n8n Credentials bölümüne ekleyin.
4. GPT-4o kullanıyorsanız ayrıca OpenAI faturasını izlemeye başlayın.

Bu, n8n'i denemek isteyen ama henüz "hangi LLM, ne kadar maliyet" kararını vermemiş biri için gereksiz bir engel. Üstelik akışı production'a taşıdığınızda aylık LLM masrafı tamamen ayrı bir kalem olarak ekleniyor.

---

Çözüm: AI Kredileri Dahil Bir n8n Kurulumu

AgentRoost'ta her n8n workspace'i AI kredileriyle birlikte gelir. Editörü açtığınızda LLM düğümleri zaten yapılandırılmış durumdadır; credential eklemek zorunda kalmazsınız. 350'yi aşkın model arasından — GPT-4o mini'den Claude Sonnet'e, Mistral'dan Llama 3'e kadar — istediğinizi seçebilirsiniz. Aylık sabit fiyat, gizli LLM faturası yok.

Şimdi asıl konuya geçelim: bu kurulumda ilk AI akışını nasıl kurarsınız?

---

Adım Adım: Metin Özetleme + Sınıflandırma Akışı

Bu akış şunu yapar: bir webhook'a gelen ham metin → LLM ile özetle → kategori etiketle → farklı dallara yönlendir.

1. Webhook Trigger ile Başlayın

Webhook düğümü ekleyin. Path kısmına /classify-text yazın, Method olarak POST seçin. n8n size otomatik olarak https://<workspace-id>.agentroost.app/webhook/classify-text şeklinde herkese açık bir HTTPS URL verir — SSL kurmanıza gerek yok.

{
  "method": "POST",
  "path": "classify-text",
  "responseMode": "responseNode"
}

2. LLM Düğümü Ekleyin (Credentials Olmadan)

Basic LLM Chain düğümünü ekleyin. AgentRoost workspace'inde Credentials açılır listesi zaten dolu gelir — dahili kredi sağlayıcısı seçili. Model olarak gpt-4o-mini bırakabilirsiniz; hız/maliyet dengesi için idealdir.

System Message alanına şunu yazın:

Sen bir metin analiz asistanısın. Sana verilen metni önce 2 cümleyle özetle, ardından şu kategorilerden birine ata: "şikayet", "öneri", "soru", "bilgi". Yanıtını JSON formatında ver: {"ozet": "...", "kategori": "..."}.

User Message kısmına n8n expression ile webhook'tan gelen veriyi bağlayın:

{{ $json.body.text }}

3. JSON'u Parse Edin

LLM çıktısı string olarak gelir. Code düğümü ekleyin:

const raw = $input.item.json.output;
// Bazen model ```json ... ``` bloğu içinde döner, temizle
const cleaned = raw.replace(/```json|```/g, '').trim();
return [{ json: JSON.parse(cleaned) }];

Bu düğüm, sonraki IF dallanması için ozet ve kategori alanlarını kullanılabilir hale getirir.

4. IF Düğümüyle Kategoriye Göre Yönlendirin

IF düğümü ekleyin. Koşul:

{{ $json.kategori }} == "şikayet"

• True dalı → Slack'e mesaj gönderin, e-posta oluşturun ya da bir CRM'e kaydedin.
• False dalı → Bilgi tabanına ekleyin veya farklı bir kanala iletin.

5. Webhook Yanıtı Gönderin

Respond to Webhook düğümü ekleyin. Response Body:

{
  "ozet": "{{ $json.ozet }}",
  "kategori": "{{ $json.kategori }}",
  "islem": "tamamlandi"
}

Akışınız hazır. Toplamda 5 düğüm, sıfır API anahtarı kurulumu.

---

Test: Akışı Çalıştırın

Webhook URL'sini curl ile test edin:

curl -X POST https://<workspace-id>.agentroost.app/webhook/classify-text \
  -H "Content-Type: application/json" \
  -d '{"text": "Siparişim 3 gündür gelmedi, müşteri hizmetleri de cevap vermiyor."}'

Beklenen yanıt:

{
  "ozet": "Kullanıcının siparişi 3 gün içinde teslim edilmemiş ve müşteri hizmetlerinden yanıt alınamamış.",
  "kategori": "şikayet",
  "islem": "tamamlandi"
}

---

Sık Yapılan Hatalar ve İpuçları

LLM çıktısı her zaman geçerli JSON döndürmez. Prompt'a "Yanıtını YENİ BİR SATIRDA başlayan saf JSON formatında ver, başka hiçbir şey ekleme" gibi net bir kısıtlama ekleyin. Yine de Code düğümündeki temizleme adımını kaldırmayın.

Model seçimi hız etkiler. Sınıflandırma gibi basit görevler için gpt-4o-mini veya Claude Haiku yeterlidir. Daha karmaşık çıkarım gerektiren işler için daha büyük bir model seçin — model açılır listesini istediğiniz zaman değiştirebilirsiniz.

Bellek eklemek istiyorsanız: Sohbet akışlarında Window Buffer Memory düğümünü AI Agent düğümüne bağlayın. Son N mesajı bağlamda tutar; Session ID olarak {{ $json.sessionId }} gibi bir alan kullanarak farklı kullanıcı oturumlarını ayırabilirsiniz.

---

AgentRoost'ta Nasıl Kurarsınız?

Kendi n8n örneğinizi şu adımlarla edinirsiniz:

1. agentroost.app/tr/agents/n8n adresinden kayıt olun (e-posta, Google, Microsoft veya Discord ile).
2. n8n framework'ünü seçin, workspace'inize bir isim verin.
3. ~2 dakika içinde editörünüz https://<sizin-id>.agentroost.app adresinde açılır.
4. Yukarıdaki akışı kurun — AI düğümleri için herhangi bir credential eklemenize gerek yok.

Fiyat aylık $19,99'dan başlar ve AI kredileri dahildir. Ek LLM faturası yoktur. 14 gün içinde memnun kalmazsanız iade garantisi var.

Karşılaştırmak için: n8n Cloud'un kendi planlarında AI kredisi dahil değil; OpenAI'yi ayrıca bağlamanız ve ayrı ödeme yapmanız gerekiyor. AgentRoost'ta bu ek adım yok.

Planları karşılaştır →

---

Bu Akışı Nerelerde Kullanabilirsiniz?

• Müşteri destek önceliklendirme: Gelen destek taleplerini şikayet/soru/öneri olarak etiketle, aciliyet düzeyine göre ata.
• İçerik moderasyonu: Form yanıtlarını veya kullanıcı yorumlarını otomatik filtrele.
• Haber/rapor özeti: RSS feed'inden gelen makaleleri özetle, ilgili ekibin Slack kanalına ilet.
• CRM zenginleştirme: Satış e-postalarını analiz et, müşteri niyetini etiketle, HubSpot veya Pipedrive'a kaydet.

Tüm bu senaryolarda tek bir harici API anahtarı kurulumu yapmak zorunda kalmazsınız.