n8n AI Agent araçlarına insan onayı ekleme

n8n’de bir AI ajanının riskli bir aracı çalıştırmadan önce izin istemesi için AI Agent’ın Tools bağlantısındaki Human review adımını kullanın. n8n’nin araç onayı yönergesi, seçilen araç çağrısının insan kararını beklediğini; onayda ajanın belirlediği girdilerle çalıştığını, rette ise iptal edilip ajana ret bilgisinin iletildiğini açıklar.

Mesaj gönderme, kayıt değiştirme veya silme yetkisi olan her aracı bu inceleme adımının arkasına bağlayın. Kontrol yalnızca o bağlantıdan geçen çağrıyı kapsar: aynı işlemi yapabilen başka bir araç ajana doğrudan bağlı kalırsa onay yolu atlanabilir. Bu nedenle düğümü ekledikten sonra ajanın erişebildiği bütün araçları ve onların gerçek yetkilerini birlikte inceleyin.

Hangi araçlar insan kararı beklemeli?

Ayrımı araç adına göre değil, çağrının dış sistemde yaratacağı sonuca göre yapın. Arama yapmak veya bir kaydı okumak çoğu akışta bilgi toplar; müşteriye mesaj göndermek, CRM kaydını güncellemek, ödeme başlatmak ve veriyi silmek ise dışarıda sonuç doğurur. İşlem geri alınamıyorsa, yanlış alıcıya ulaşabiliyorsa veya üretim verisini etkiliyorsa onay arkasına alınması için güçlü bir gerekçe vardır.

Koşullu bir destek akışında ajan müşterinin talebini okuyup yanıt taslağı hazırlayabilir. Taslağı oluşturmak ile onu müşteriye göndermek ayrı yetkilerdir; gönderme aracı inceleme bağlantısına yerleştirilir. n8n’nin sözleşme gönderme şablonu bu ayrımı somutlaştırır: AI Agent gönderme işlemini önerir, araç çağrısı sohbet içinde insanın onayını veya reddini bekler.

Genel amaçlı HTTP veya API araçlarını da yaptıkları işlem üzerinden sınıflandırın. Adı nötr görünen bir araç yazma yetkisi taşıyorsa, onaylı e-posta veya CRM düğümüyle aynı etkiyi yaratabilir. Araçların kimlik bilgileriyle hangi uç noktalara eriştiğini bilmeden yalnızca akış şemasındaki etiketlere güvenmeyin.

Human review adımını doğru bağlantıya kurun

AI Agent düğümünün Tools bağlantısını açın. Human review bölümünde onay isteğinin gideceği kanalı seçip kanalın kimlik bilgilerini ve hedefini yapılandırın.
İnsan kararı gerektiren araçları Human review adımının araç bağlantısına ekleyin. Her aracın normal işlem ve kimlik bilgisi ayarlarını tamamlayın; inceleme adımı bu ayarların yerine geçmez.
Onay mesajında çağrılan aracı ve ajanın önerdiği girdileri görünür kılın. Mesajı hazırlarken $tool.name araç düğümünün adını, $tool.parameters ise ajanın araç çağrısı için belirlediği parametreleri sağlar.
AI Agent’ın sistem talimatına hangi araçların onay gerektirdiğini ve ret alındığında kullanıcıya nasıl yanıt vermesi gerektiğini yazın. Talimat, ajanın kararı işlemesine yardımcı olur; çağrıyı durduran teknik kontrol araç bağlantısıdır.

$tool.parameters özellikle $fromAI() ile ajana bırakılmış alanları gösterir. Araç düğümünde sabitlenmiş bir alıcı, kayıt kimliği veya başka bir etkili ayar varsa inceleyen kişi bunu yalnızca bu değişkene bakarak görmeyebilir. Kararı etkileyen sabit değerleri de onay mesajına anlaşılır biçimde ekleyin; kişi hangi işlemi onayladığını bilmelidir.

Kurulum bitince AI Agent’a bağlı araçları tek tek izleyin. Aynı gönderme yetkisini veren bir düğüm inceleme arkasındayken başka bir API aracı doğrudan bağlıysa bağlantıyı düzeltin veya o yetkiyi kaldırın. Alt ajan kullanıyorsanız onun araçlarını da inceleyin; ana ajanın şemasına bakmak, alt akıştaki bütün işlemleri göstermez.

Onay kanalını ve görülecek bilgiyi seçin

İnceleme isteği, kullanıcıyla konuşmanın geçtiği kanaldan farklı bir yere gidebilir. Örneğin kullanıcı n8n Chat üzerinden talep oluştururken karar yetkili ekip üyesine Slack üzerinden yönlendirilebilir. Hedefi seçerken mesajı kimin görebildiğini, kimin yanıt verebildiğini ve görevli yokken isteğin kime ulaşacağını belirleyin. Teknik olarak çalışan bir bağlantı, doğru kişinin karar verdiği anlamına gelmez.

Onay mesajında işlem türü, hedef alıcı veya kayıt, önerilen değişiklik ve talebin karar için gerekli bağlamı bulunmalıdır. Bütün müşteri konuşmasını olduğu gibi başka kanala taşımak yerine inceleyenin ihtiyaç duyduğu alanları seçin. Parametrelerde kişisel veya hassas bilgi varsa kanalın katılımcılarını da hesaba katın; yönlendirme, bu bilgilerin erişim çevresini değiştirebilir.

İnceleyenin gördüğü içerikle aracın çalıştıracağı girdiler aynı kararı tarif etmelidir. Örneğin mesaj yalnızca “müşteriye e-posta gönder” diyorsa alıcıyı ve metni değerlendirmek mümkün değildir. Alıcı veya gönderim metni aracın sabit ayarlarından geliyorsa bunları ayrıca belirtin. Böylece onay, yalnızca araç adına değil, belirli bir işleme verilir.

Ret ve yanıtsız kalma durumlarını ayırın

Human review adımında ret verilen araç çağrısı çalışmaz ve ajan ret bilgisini alır. Ajanın bundan sonra kullanıcıya işlemin yapılmadığını söylemesini, gerekirse düzeltme istemesini veya insan görevliye yönlendirmesini sistem talimatında tarif edin. Retten sonra aynı işlemi başka bir araçla sessizce yeniden denemesi onay kararını etkisizleştirir; bu olasılığı özellikle test edin.

Araç çağrısını durdurmak ile ajanın ürettiği son metni onaylatmak farklı akışlardır. n8n’nin müşteri yanıtı şablonunda ajan taslağı hazırlar, Chat düğümü insan yanıtını bekler ve IF düğümü onay ile ret yollarını ayırır. Gönderim daha sonra ayrı bir adımda yapılıyorsa bu düzen kullanılabilir. Ajanın kendi başına gönderim yapabilen bir aracı varsa o aracın çağrısına ayrıca onay koyun.

Kimse yanıt vermezse ne olacağını da akışın parçası olarak belirleyin. Bekleyen isteğin sahibi görünür olmalı; yanıt yokluğu onay gibi yorumlanmamalıdır. Süre sınırı kullandığınız bir kanalda süre dolduğunda işi görevliye aktarmak veya gönderimi durdurmak için ayrı bir yol tanımlayın. Ret, bekleme ve onay aynı kullanıcı mesajına ya da aynı dış sistem işlemine bağlanmamalıdır.

Canlıya almadan önce atlama yollarını sınayın

Denemeleri güvenli bir test alıcısı veya test kaydı üzerinde yapın. Riskli aracı çağıran bir istek verin ve karar beklenirken dış sistemde gönderim ya da değişiklik oluşmadığını kontrol edin. Sonra onay verip gösterilen hedef ve girdilerin uygulandığını inceleyin. Ayrı bir çalıştırmada ret verin; gönderim yapılmadığını, kaydın değişmediğini ve ajanın kullanıcıya doğru durumu aktardığını doğrulayın.

AI Agent’ın erişebildiği bütün gönderme, yazma, silme ve genel API araçları listelendi mi?
Aynı yetkiyi sağlayan doğrudan bağlantı veya alt ajan aracı kaldı mı?
Onay isteği gerçek hedefi ve etkili girdileri doğru kişiye uygun kanaldan gösteriyor mu?
Retten sonra ajan işlemi başka bir araçla yinelemiyor mu; yanıtsız istek ayrı bir durumda mı kalıyor?

Yeni araç eklendiğinde veya mevcut aracın kimlik bilgileri genişletildiğinde bu denetimi yineleyin. Onay adımının kapsamını belirleyen şey, ajanın o anda erişebildiği araç bağlantıları ve bu araçların dış sistemlerdeki yetkileridir.

Ayrıca okuyun: