İçeriğe geç
Pazar, 15 Kasım 2026Yapay zekâ · sade Türkçe · denenmiş@yapaytu
YAPAYTU

Yapay zekâ ajanı eğitimi: n8n'e kendi belgelerini ekle

Yapay zekâ ajanı eğitimi için model eğitmen gerekiyor mu? n8n'de kendi belgelerini arayan bir asistan kur, promptla yanıtları ve veri sınırlarını kontrol et.

Yapay TU Editör · 6 dk okuma
n8n ajanına kendi belgelerini ekle
Kısa cevap

Yapay zekâ ajanı eğitimiyle kastın kendi belgelerinden cevap almaksa, n8n'de belgeleri bir vektör deposuna yükleyip ajana arama aracı olarak bağlayabilirsin. RAG adı verilen bu yöntem, hazır modelin cevap verirken ilgili belge parçalarına erişmesini sağlar; bu kurulum için modeli yeniden eğitmen gerekmez.

Yapay zekâ ajanı eğitimi ararken amacın, hazırladığın ürün kılavuzunu veya ders notlarını asistana kullandırmak olabilir. n8n'de bunu denemek için kısa bir belgeyi aranabilir hale getirip ajana bağlayabilirsin. Aşağıdaki örnekte kurmaca bir atölye duyurusu kullanacak, asistanın hangi bilgiyi belgeden aldığını kontrol edeceksin. Deneme geçici depolama kullandığı için kişisel bilgi veya şirket sırrı içermeyen bir metinle başla.

Yapay zekâ ajanı eğitimi için model eğitmek gerekir mi?

Kendi belgelerinden cevap almak için bu örnekte model eğitmen gerekmiyor; RAG, yani dış kaynaklardan ilgili bilgiyi bulup cevaba ekleme yöntemini kullanıyorsun. n8n'in RAG rehberi, belge yüklemeyi ve soru geldiğinde belgeyi aramayı ayrı işlemler olarak anlatıyor.

Örneğin duyurunda atölyenin B salonunda yapılacağı yazıyorsa, ajan bu bilgiyi arama aracından alabilir. Daha sonra salon değiştiğinde belgeyi ve depodaki kaydı güncellersin.

Burada iki model görevi var. Embedding modeli, metni anlamına göre aramaya elverişli sayısal bir gösterime dönüştürür. Sohbet modeli ise bulunan parçaları kullanarak cevabı yazar. Vektör deposu bu sayısal gösterimleri saklayan ve benzerlik araması yapan bileşendir. n8n'in işlem kutularına düğüm denir; bağlantılar sana yabancıysa önce ilk yapay zekâ ajanını oluşturma rehberindeki temel kurulumu tamamlayabilirsin.

Hangi belge ve bağlantılarla başlamalısın?

Çalışan bir n8n ortamı, model erişimi ve kısa bir örnek metin ilk deneme için yeterli. PDF dosyan varsa önce kullanmak istediğin bölümü düz metin olarak ayır. Kopyalanan satırlar bozuksa PDF'yi yapay zekâya hazırlama adımları metni kontrol etmene yardımcı olur.

Örnekte hem sohbet hem embedding için Google Gemini düğümlerini kullanabilirsin. Yazı tarihinde n8n'in resmi bağlantı belgesi, Google AI Studio'da Create API Key ile anahtar oluşturup n8n bağlantı kaydına eklemeyi tarif ediyor. API anahtarı hizmete erişim sağlayan gizli bilgidir; belge metnine veya prompta yazma. Model kullanımının ücret ve kota koşullarını hesabında kontrol et.

Gerçek bir etkinliğe ait olmayan şu örnek belgeyi kullan:

text
Belge adı: Örnek atölye duyurusu
Sürüm: 1
Fotoğraf atölyesi cumartesi 14.00'te B salonunda yapılır.
Katılımcılar kendi fotoğraf makinelerini getirmelidir.
Kayıt masası etkinlikten 30 dakika önce açılır.
Belgede otopark veya yemek hakkında bilgi bulunmuyor.

İlk turda metni aynen koru. Böylece beklediğin yanıtları önceden biliyor olursun; kendi belgene geçtiğinde de benzer kontrol soruları hazırlayabilirsin.

n8n'de kendi belgelerin nasıl yüklenir?

Belgeyi yüklemek için Manual Trigger ile başlayan bir akışta metni Edit Fields üzerinden Simple Vector Store'a gönder. Yazı tarihinde resmi belgelerdeki alan adlarıyla şu sırayı izle:

  1. Yeni akışa Manual Trigger ve ardından Edit Fields ekle. Edit Fields içinde Manual Mapping seç; metin adlı bir String, yani metin alanı oluştur. Değerini Fixed yapıp örnek belgeyi yapıştır.
  2. Edit Fields çıkışına Simple Vector Store bağla. İşlemi Insert Documents, Memory Key değerini atolye-rehber-deneme olarak ayarla. Bu anahtarı yalnızca bu denemeye ayır.
  3. Deponun Document bağlantısına Default Data Loader ekle. Type of Data için JSON, Mode için Load Specific Data seç. Veri alanını Expression moduna alıp {{ $json.metin }} yaz.
  4. Default Data Loader içinde Text Splitting seçimini Simple bırak. Bu seçenek metni parçalara ayırır. Metadata alanına kaynak adıyla ornek-atolye-duyurusu-v1 değerini ekle; bu ek bilgi, bulunan parçanın hangi belgeye ait olduğunu takip etmene yarar.
  5. Deponun Embeddings bağlantısına Embeddings Google Gemini ekle. Bağlantı kaydını ve erişebildiğin embedding modelini seç. Modelin adını not et.
  6. Akışı kaydet ve Execute Workflow ile çalıştır. Hata varsa sohbet akışına geçmeden ilgili düğümün çıktısını incele.

Default Data Loader hem dosya verisi hem JSON alabiliyor. Burada JSON, düğümler arasında taşınan alanlı veri yapısıdır; metin alanının içeriğini seçtiğin için başka alanları yanlışlıkla belgeye katmazsın. İlk kurulumda tek kayıt kullanmak, yüklenen içerikle beklediğin metni karşılaştırmayı kolaylaştırır.

Yapay zekâ ajanı belgelerde nasıl arama yapar?

Ajan, aynı vektör deposunu araç olarak çağırarak soruyla ilgili belge parçalarını alır. Ayrı bir sohbet akışında Chat Trigger'ı AI Agent'a bağla. Chat Trigger'da Make Chat Publicly Available kapalı, Load Previous Session ise Off kalsın; denemeyi düzenleyicide yapacaksın.

AI Agent'ın Chat Model bağlantısına Google Gemini Chat Model ekleyip hesabında görünen, araç kullanımını destekleyen bir sohbet modeli seç. Prompt ayarını Take from previous node automatically yap. Böylece kullanıcı mesajı önceki düğümün chatInput alanından gelir.

Ardından ajanın Tool bağlantısına Simple Vector Store ekle:

  • İşlem: Retrieve Documents (As Tool for AI Agent).
  • Name: atolye_belgeleri.
  • Description: Atölyenin yeri, saati ve hazırlık bilgileri için duyuru belgesinde arama yapar.
  • Memory Key: atolye-rehber-deneme.
  • Limit: ilk deneme için 3.

Bu depoya da Embeddings Google Gemini bağla ve yüklemede seçtiğin aynı embedding modelini kullan. Limit, döndürülecek belge parçası sayısını belirler; önerilen başlangıç değeri bu kısa örnek içindir.

AI Agent'ın Options > System Message alanına şu promptu yaz:

text
Atölye duyurusuyla ilgili soruları Türkçe yanıtla.
Atölye hakkında cevap vermeden önce atolye_belgeleri aracını kullan.
Yanıtı araçtan gelen bilgiye dayandır.
Belgede cevap yoksa "Belgede bu bilgi yok" de.
Belge adı veya kaynak bilgisi dönmüşse cevabın sonunda belirt.
Kaynak bilgisini kendin üretme.
Birbirini tutmayan bilgiler bulursan çelişkiyi açıkla.

Bu talimatın uygulanıp uygulanmadığını kontrol etmek için Tools Agent belgesindeki Return Intermediate Steps seçeneğini aç. Ara adımlar, ajanın araca gönderdiği sorguyu incelemene yardımcı olur.

Ajanın doğru belgeyi kullandığını nasıl anlarsın?

Son cevabı, araçtan dönen metinle karşılaştırarak ajanın dayanağını kontrol edebilirsin. Sohbet panelinde aşağıdaki soruları ayrı ayrı gönder ve yanıtları beklenen davranışlarla karşılaştır.

Deneme sorusu Beklenen davranış
Atölye nerede yapılacak? B salonu bilgisini bulması
Fotoğraf makinemi getirmeli miyim? Katılımcının kendi makinesini getirmesi gerektiğini söylemesi
Kayıt masası kaçta açılır? 14.00'ten 30 dakika öncesini hesaplayıp 13.30 demesi
Otopark ücretsiz mi? Belgede bilgi bulunmadığını belirtmesi

Hata aldığında depoyu Get Many işlemiyle doğrudan sorgulamayı dene; Prompt alanına sorun olan soruyu yaz. Bu yol, ajanın araç seçimini aradan çıkarıp arama sonucunu görmeni sağlar. Doğru parça geliyorsa sohbet modelinin yorumunu incele. Yanlış parça geliyorsa yüklenen metni, depo anahtarını ve embedding modeli seçimini kontrol et.

Kaynak adının görünmesi de tek başına yeterli olmaz. Örneğin cevapta otoparkın ücretsiz olduğu yazıyorsa, bu iddianın belge metninde bulunmadığını işaretle ve yanıtı kullanma.

Belgeler neden kayboluyor ve nasıl güncellenir?

Bu örnekteki Simple Vector Store geçici bellekte çalıştığından, n8n yeniden başlatılınca belgeler kaybolur; bellek yetersizliğinde de temizlenebilir. Yazı tarihinde resmi belge bu düğümü geliştirme amaçlı öneriyor. Aynı n8n ortamındaki tüm kullanıcılar depo anahtarını seçerek verilere erişebilir; ayrı anahtar kullanmak gizlilik sağlamaz.

Örnek duyurudaki salonu C olarak değiştirdiğinde yükleme akışını yeniden çalıştırman gerekir. Bu denemeye ayrılmış anahtarda eski içeriği kaldırmak için Clear Store seçeneğini kullanabilirsin. Bu işlem o anahtardaki kayıtları temizler; başka bir akışın kullandığı depoyu seçme.

Yüklemeden sonra salon sorusunu tekrar sor. C cevabını ve güncel belge parçasını birlikte kontrol et. Sürekli kullanımda kalıcı depolama ve kullanıcı erişimlerini ayrıca tasarlamalısın. Belge aramasını, önceki mesajları tutan sohbet hafızasıyla karıştırma; yeni oturum açmak belgeyi güncellemez.

Bizim yorumumuz

Bizce ilk denemeyi, içeriğini bütünüyle kontrol edebildiğin tek bir belgeyle yapmak daha yararlı. Atölye örneğinde salonu değiştirip aynı soruyu yeniden sormak, güncellemenin sisteme ulaşıp ulaşmadığını gösterir. Kendi ders notunda da belirli bir tanımın geçtiği bölümü seçebilir, cevabın o bölümdeki ifadeyi doğru aktarmasını kontrol edebilirsin. Yanıtın neden yanlış olduğunu açıklayamıyorsan yeni dosyalar eklemeye ara vermeni öneriyoruz.

Türkiye'deki küçük bir işletme için bizce ilk belge, yayımlanmasında sakınca bulunmayan bir kullanım kılavuzu olabilir. Örneğin bir ürünün bakım talimatını yüklediğinde asistanın belgede olmayan bir kullanım süresi ekleyip eklemediğine bak. Cevabı müşteriye otomatik göndermeden önce kendin incele. Model değiştirince aynı soruları yeniden çalıştır; eski cevapların yeni modelde korunacağını varsayma.

Bizce satın alacağın bir otomasyon hizmetinde de bu denemeyi istemelisin: yüklenmiş bir belgeyi değiştir, sonra hem yeni hem de belgede cevabı bulunmayan bir soru sor. Hizmeti değerlendirmek için n8n hizmeti alırken sorulacak sorular kapsam ve teslim koşullarını netleştirmene yardımcı olur. Teslim sırasında örnek soruları ve beklenen cevapları sakla; ileride bozulan davranışı aynı girdilerle gösterebilirsin.

Arayüz adları ve teknik davranışlar yazı tarihinde, 13 Kasım 2026'da bağlantıları verilen resmi n8n belgelerinden kontrol edildi. Kurulum adımları bu belgelere dayanıyor; çalışan bir n8n ortamında uygulama testi yapılmadı.

Bu yazı sponsorlu değildir.

Sık sorulanlar

Yapay zekâ ajanını kendi verilerimle nasıl eğitirim?

Belgeden cevap almak için RAG kullanabilirsin: metni vektör deposuna yükle ve depoyu ajana arama aracı olarak bağla. Böylece hazır model, soruyla ilgili parçaları cevap sırasında kullanabilir.

n8n'de RAG için hangi düğümler gerekiyor?

Bu denemede yükleme tarafında Edit Fields, Default Data Loader, bir embedding düğümü ve Simple Vector Store kullanılıyor. Sohbet tarafında Chat Trigger ve AI Agent, aynı depoya arama aracı üzerinden bağlanıyor.

Simple Memory ile belge yükleyebilir miyim?

Simple Memory sohbet geçmişi içindir. Belgelerde anlam benzerliğiyle arama yapmak için bu örnekte Simple Vector Store kullanılıyor.

n8n ajanı yüklediğim belgeleri neden unuttu?

Simple Vector Store verileri bellekte tutar; n8n yeniden başladığında kaybolur ve bellek yetersizliğinde de temizlenebilir. Yükleme akışını yeniden çalıştırabilir, sürekli kullanım için kalıcı depolamayı değerlendirebilirsin.

#yapay-zeka-ajani#n8n#rag#belge
E-bülten

Haftada bir e-posta. Sadece işe yarayanlar.

Haftanın en iyi yapay zekâ araçları ve yeni rehberler. İstediğin an tek tıkla çık.

Adresine bir onay e-postası gelir. Aydınlatma metni
Sıradaki yazı Yapay zekâ ajanı nasıl oluşturulur? n8n ile ilk kurulum

Videolarda bu konuTümü

Bunları da okuyun