Ricerca web per agenti AI n8n con lo strumento HTTP Request

Perché il nodo HTTP Request invece di un nodo personalizzato?

Perché all'API basta una sola richiesta GET con un header e quattro parametri di query. La documentazione di n8n dice che il nodo HTTP Request può funzionare come nodo normale o essere collegato a un agente AI come tool, e che alcune opzioni esistono solo nella forma tool.

Non dobbiamo installare né aggiornare nulla, e la chiave resta nello store delle credenziali di n8n invece che nel workflow. Dai a n8n una chiave dedicata. Crea una chiave API per agente, app o teammate e revoca qualsiasi di esse dalla dashboard senza toccare le altre.

Come scrive il modello la query di ricerca?

Tramite la funzione $fromAI() di n8n nel valore del campo q. La sua forma documentata è $fromAI(key, description, type, defaultValue): usa la chiave query, una descrizione come "Cosa cercare sul web" e il tipo string. n8n segnala che $fromAI() funziona solo nei tool collegati al nodo AI Agent.

Descrivi anche il tool stesso a parole semplici, per esempio "Cerca sul web e restituisce le fonti con il testo della pagina; cita gli URL". L'agente usa quel testo per decidere quando cercare.

Perché attivare Optimize Response?

Perché tutto ciò che restituisce un tool finisce nel contesto del modello. Optimize Response è un'opzione solo per i tool che riduce ciò che viene passato al modello. Con il tipo JSON, imposta Field Containing Data su results, poi includi solo title, url e content.

L'agente vede così solo un breve elenco di fonti con il loro testo, e nient'altro. Limita la lunghezza dalla nostra parte con max_chars, che riduce ogni pagina prima che lasci l'API.

Posso eseguire ricerche in modo pianificato senza un agente?

Sì. Usa il nodo HTTP Request come nodo normale dietro a uno Schedule Trigger, con una query fissa. Aggiungi topic=news e time_range=day per raccogliere gli articoli del giorno su un argomento, poi invia titoli e URL a una chat, a un foglio o a un'email.

Una ricerca di notizie pianificata al giorno costa circa 30 crediti al mese, quindi 5.000 ricerche (9,25 USD) coprono molti argomenti per molto tempo. I crediti di ricerca non hanno data di scadenza: quello che non usi questo mese è ancora lì l'anno prossimo.

Cosa riceve il workflow quando una pagina viene rifiutata?

La ricerca va comunque a buon fine. Il risultato rifiutato mantiene titolo e URL, non ha content, e il suo content_status spiega il motivo, per esempio blocked_by_robots. Il nostro reader rispetta robots.txt: si presenta come LLMWebSearch, segue le regole che un sito scrive per lui o per tutti i robot, e lascia fuori il contenuto di qualsiasi pagina che non gli è permesso leggere.

Gli errori HTTP sono diversi: una chiave errata restituisce 401, un saldo vuoto 402, troppe chiamate 429. In un agente, lascia che il tool restituisca l'errore così il modello può spiegarlo. In un workflow pianificato, instrada gli errori verso un ramo che li registra. La pagina degli errori elenca ogni codice.

Come testo la chiamata prima di costruire il workflow?

Esegui la stessa richiesta con curl dalle ricette curl. Se funziona nel terminale e fallisce in n8n, la causa sta nelle impostazioni del nodo. I sospetti di sempre sono un valore della credenziale senza il prefisso Bearer , o un campo q vuoto.