HTTP Request aracı ile n8n AI Agent'ları için web arama

Neden özel bir node yerine HTTP Request node?

Çünkü API'nin ihtiyacı olan tek şey, bir header ve dört sorgu parametresi içeren bir GET isteğidir. n8n dokümantasyonuna göre HTTP Request node normal bir node olarak çalıştırılabilir veya bir AI agent'a araç olarak bağlanabilir; bazı seçenekler yalnızca araç formunda bulunur.

Bizde hiçbir şeyin kurulması veya güncellenmesi gerekmez ve API anahtarı workflow yerine n8n'in credential store'unda kalır. n8n'e kendine ait bir anahtar verin. Her agent, uygulama veya ekip arkadaşı için bir API anahtarı oluşturun ve dashboard'dan diğerlerine dokunmadan istediğinizi iptal edin.

Model arama sorgusunu nasıl yazıyor?

n8n'in q alanının değerindeki $fromAI() fonksiyonu aracılığıyla. Belgelendirilmiş biçimi $fromAI(key, description, type, defaultValue): query anahtarını, "What to search for on the web" gibi bir açıklamayı ve string türünü kullanın. n8n, $fromAI() öğesinin yalnızca AI Agent node'una bağlı araçlarda çalıştığını belirtir.

Aracın kendisini de düz kelimelerle tanımlayın, örneğin "Web'de arama yapar ve kaynakları sayfa metinleriyle döndürür; URL'leri alıntılar". Agent bu metni ne zaman arama yapacağına karar vermek için kullanır.

Neden Yanıtı Optimize Et açılmalı?

Çünkü bir aracın döndürdüğü her şey modelin bağlamına düşer. Yanıtı Optimize Et, modele aktarılanı azaltan, yalnızca araçlara özel bir seçenektir. JSON türünde, Veri İçeren Alan'ı results olarak ayarlayın, ardından yalnızca title, url ve content öğelerini ekleyin.

Agent daha sonra metinleriyle birlikte kısa bir kaynak listesi görür, başka bir şey görmez. Uzunluğu bizim tarafımızda max_chars ile sınırlayın; bu, her sayfayı API'den çıkmadan önce kısaltır.

Agent olmadan aramaları zamanlanmış olarak çalıştırabilir miyim?

Evet. HTTP Request node'unu Schedule Trigger arkasında normal bir node olarak, sabit bir sorguyla kullanın. Bir konudaki günün makalelerini toplamak için topic=news ve time_range=day ekleyin, sonra başlıkları ve URL'leri bir sohbete, bir sayfaya veya bir e-postaya gönderin.

Günde bir zamanlanmış haber araması ayda yaklaşık 30 kredi kullanır, bu yüzden 5.000 arama ($9,25) birçok konuyu uzun süre kapsar. Arama kredilerinin son kullanma tarihi yoktur: bu ay kullanmadığınız krediler gelecek yıl da orada durur.

Bir sayfa reddedildiğinde workflow ne alır?

Arama yine de başarılı olur. Reddedilen sonuç başlığını ve URL'sini korur, content olmaz ve content_status nedeni blocked_by_robots gibi açıklar. Okuyucumuz robots.txt'ye uyar: kendini LLMWebSearch olarak tanıtır, bir sitenin onun için ya da tüm robotlar için yazdığı kurallara uyar ve okumasına izin verilmeyen her sayfanın içeriğini dışarıda bırakır.

HTTP hataları farklıdır: yanlış anahtar 401 döndürür, boş bakiye 402, çok fazla çağrı 429. Bir agent'ta, aracın hatayı geri vermesine izin verin ki model açıklayabilsin. Zamanlanmış bir workflow'da hataları kaydeden bir dala yönlendirin. Hatalar sayfası her kodu listeler.

Workflow'u oluşturmadan önce çağrıyı nasıl test ederim?

Aynı isteği curl tarifleri bölümünden curl ile çalıştırın. Bir terminalde çalışıp n8n'de başarısız olursa, neden node ayarlarındadır. Olağan şüpheliler: Bearer öneki olmayan bir credential değeri veya boş bir q alanı.